Usa cubic nei tuoi prodotti
Un’API compatibile con OpenAI per portare cubic, il modello di IA di Square Cloud, nei tuoi chatbot, assistenti e automazioni. Se il tuo codice usa già un SDK di OpenAI, basta cambiare la base URL e la chiave.
Beta con accesso anticipato gratuito, dal piano Standard. I limiti e la disponibilità per piano possono cambiare al termine della beta.
La tua prima richiesta
Punta qualsiasi SDK di OpenAI alla base URL di Square Cloud, usa l’API key del tuo account e imposta il modello su cubic.
- Base URL
- https://api.squarecloud.app/v2/ai
- API key
- La chiave del tuo account, con lo scope ai:chat
- Modello
- cubic
import OpenAI from "openai";const client = new OpenAI({ baseURL: "https://api.squarecloud.app/v2/ai", apiKey: process.env.SQUARECLOUD_API_KEY,});const completion = await client.chat.completions.create({ model: "cubic", messages: [ { role: "system", content: "You are a helpful assistant." }, { role: "user", content: "Explain what Square Cloud is in one sentence." }, ],});console.log(completion.choices[0].message.content);curl https://api.squarecloud.app/v2/ai/chat/completions \ -H "Authorization: Bearer $SQUARECLOUD_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "cubic", "messages": [ { "role": "user", "content": "Explain what Square Cloud is in one sentence." } ] }'Pensato per il codice che hai già
Il gateway segue il formato chat completions di OpenAI: per migrare un’integrazione esistente bastano una nuova base URL e una nuova chiave.
Compatibile con OpenAI
Qualsiasi SDK di OpenAI funziona con la base URL puntata su api.squarecloud.app/v2/ai. Anche gli errori arrivano nel formato di OpenAI.
Function calling
Dichiara fino a 32 tool nel formato di OpenAI. Il modello decide quando chiamarne uno, e il tuo codice lo esegue e restituisce il risultato.
Ricerca web integrata
Quando una domanda richiede informazioni aggiornate, il modello cerca sul web da solo e restituisce solo la risposta finale, citando gli URL delle fonti.
Limiti propri
I limiti di token del gateway sono separati da quelli dell’assistente della dashboard: il traffico dell’API non consuma mai ciò che resta a Cubic nella dashboard, e viceversa.
Limiti per piano
I tetti di ogni piano durante la beta. Hobby e gli account senza piano non hanno accesso. I limiti giornalieri si azzerano alle 00:00 (UTC), quelli settimanali il lunedì alle 00:00 (UTC), e limiti e disponibilità per piano possono cambiare al termine della beta.
| Limite | Standard | Pro | Enterprise |
|---|---|---|---|
| Token al giorno | 2,5M | 5M | 10M - 20M |
| Token a settimana | 10M | 20M | 40M - 80M |
| Richieste al giorno | 1000 | 5000 | Illimitate |
| Contesto (token) | 16k | 24k | 32k |
| Output massimo (token) | 4k | 6k | 8k |
| Richieste simultanee | 1 | 1 | 2 |
| Intervallo tra le richieste | 5s | 2s | Nessuno |
Su Enterprise, il limite di token cresce con la dimensione del piano. Contesto e output valgono per richiesta.
Prima di andare in produzione
Tre comportamenti da considerare quando integri il gateway in un prodotto.
Solo testo
Testo in ingresso, testo in uscita, per scelta di design. Immagini, audio o file restituiscono un 400. Cubic, nella dashboard, è un prodotto distinto e accetta immagini e voce.
Nessuna memoria tra le chiamate
Come su OpenAI, l'API non conserva le conversazioni. Invia la cronologia in messages a ogni richiesta, fino a 100 messaggi.
Risposta completa, senza streaming
Per ora la risposta arriva in un unico blocco. Le richieste con "stream": true restituiscono un 400.
Un piano per ogni fase del tuo progetto
Inizia in piccolo e scala quando ne hai bisogno, senza contratti di permanenza.
Standard
ConsigliatoPer la produzione, con database e dominio personalizzato
A partire da 44,99 BRL/mese ≈ 7,20 €
- 4 GB di RAM
- 4 vCPU
- Fino a 16 progetti
- Scala fino a 8 GB nello stesso piano
Pro
Per l'alta scala, con snapshot giornalieri delle applicazioni e analytics avanzati
A partire da 124,99 BRL/mese ≈ 20,00 €
- 12 GB di RAM
- 6 vCPU
- Fino a 48 progetti
- Scala fino a 24 GB nello stesso piano
Enterprise
Per grandi operazioni, con account manager dedicato
A partire da 299,90 BRL/mese ≈ 47,98 €
- 32 GB di RAM
- 16 vCPU
- Fino a 128 progetti
- Scala fino a 1024 GB nello stesso piano
L’AI Gateway è disponibile a partire dal piano Standard.
Confronta tutti i piani4,9 su 5 · 402 recensioni su Google + TrustpilotTrustpilot
Domande frequenti sull’AI Gateway
Cos’è l’AI Gateway di Square Cloud?
Un’API compatibile con OpenAI per usare cubic, il modello di IA di Square Cloud, nei tuoi prodotti, come chatbot, assistenti e automazioni. Invii le richieste a api.squarecloud.app/v2/ai con l’API key del tuo account.
Quali piani hanno accesso, e quanto costa?
Durante la beta, Standard, Pro ed Enterprise hanno accesso anticipato gratuito, entro i limiti di token del gateway di ogni piano. Hobby e gli account senza piano non hanno accesso. I limiti e la disponibilità per piano possono cambiare al termine della beta.
Quale modello risponde?
Sempre cubic, lo stesso modello dell’assistente della dashboard. Non c’è un elenco di modelli tra cui scegliere: il campo model è accettato per compatibilità con gli SDK.
Il gateway consuma i limiti di Cubic nella dashboard?
No. Il gateway ha limiti di token giornalieri e settimanali propri, separati da quelli dell’assistente della dashboard, quindi nessuno dei due consuma quelli dell’altro.
Posso chiamarlo da un’applicazione ospitata su Square Cloud?
Sì, è l’uso principale. È una normale API HTTPS, quindi funziona anche da qualsiasi altro posto.