Utilisez cubic dans vos produits
Une API compatible avec OpenAI pour intégrer cubic, le modèle d’IA de Square Cloud, à vos chatbots, assistants et automatisations. Si votre code utilise déjà un SDK OpenAI, il suffit de changer la base URL et la clé.
Bêta en accès anticipé gratuit, à partir du plan Standard. Les limites et la disponibilité par plan peuvent changer à la fin de la bêta.
Votre première requête
Pointez n’importe quel SDK OpenAI vers la base URL de Square Cloud, utilisez la clé d’API de votre compte et choisissez cubic comme modèle.
- Base URL
- https://api.squarecloud.app/v2/ai
- Clé d’API
- La clé de votre compte, avec le scope ai:chat
- Modèle
- 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." } ] }'Conçu pour le code que vous avez déjà
Le gateway suit le format chat completions d’OpenAI : pour migrer une intégration existante, une nouvelle base URL et une nouvelle clé suffisent.
Compatible avec OpenAI
Tout SDK OpenAI fonctionne dès que sa base URL pointe vers api.squarecloud.app/v2/ai. Les erreurs arrivent aussi au format OpenAI.
Function calling
Déclarez jusqu’à 32 tools au format OpenAI. Le modèle décide quand en appeler une, et votre code l’exécute puis renvoie le résultat.
Recherche web intégrée
Quand une question demande une information récente, le modèle cherche sur le web de lui-même et ne renvoie que la réponse finale, en citant les URL des sources.
Des limites à part
Les limites de tokens du gateway sont distinctes de celles de l’assistant du dashboard : le trafic de l’API ne consomme jamais ce qu’il reste à Cubic dans le dashboard, et inversement.
Limites par plan
Les plafonds de chaque plan pendant la bêta. Le plan Hobby et les comptes sans plan n’y ont pas accès. Les limites quotidiennes se réinitialisent à 00:00 (UTC), les hebdomadaires le lundi à 00:00 (UTC), et les limites comme la disponibilité par plan peuvent changer à la fin de la bêta.
| Limite | Standard | Pro | Enterprise |
|---|---|---|---|
| Tokens par jour | 2,5M | 5M | 10M - 20M |
| Tokens par semaine | 10M | 20M | 40M - 80M |
| Requêtes par jour | 1 000 | 5 000 | Illimitées |
| Contexte (tokens) | 16k | 24k | 32k |
| Sortie maximale (tokens) | 4k | 6k | 8k |
| Requêtes simultanées | 1 | 1 | 2 |
| Intervalle entre les requêtes | 5s | 2s | Aucun |
Sur Enterprise, la limite de tokens augmente avec la taille du plan. Le contexte et la sortie s’appliquent par requête.
Avant de passer en production
Trois comportements à prévoir quand vous intégrez le gateway dans un produit.
Texte uniquement
Texte en entrée, texte en sortie, par choix de conception. Les images, l'audio ou les fichiers renvoient une erreur 400. Cubic, dans le tableau de bord, est un produit distinct qui accepte images et voix.
Aucune mémoire entre les appels
Comme chez OpenAI, l'API ne conserve pas les conversations. Envoyez l'historique dans messages à chaque requête, jusqu'à 100 messages.
Réponse complète, sans streaming
Pour l'instant, la réponse arrive en un seul bloc. Les requêtes avec "stream": true renvoient une erreur 400.
Un plan pour chaque étape de votre projet
Commencez petit et évoluez quand vous en avez besoin, sans contrat d’engagement.
Standard
RecommandéPour la production, avec bases de données et domaines personnalisés
À partir de 44,99 R$/mois ≈ 7,20 €
- 4 Go de RAM
- 4 vCPU
- Jusqu’à 16 projets
- Jusqu’à 8 Go sur le même plan
Pro
Pour les projets à grande échelle, avec snapshots quotidiens des applications et statistiques avancées
À partir de 124,99 R$/mois ≈ 20,00 €
- 12 Go de RAM
- 6 vCPU
- Jusqu’à 48 projets
- Jusqu’à 24 Go sur le même plan
Enterprise
Pour les grandes opérations, avec un gestionnaire de compte dédié
À partir de 299,90 R$/mois ≈ 47,98 €
- 32 Go de RAM
- 16 vCPU
- Jusqu’à 128 projets
- Jusqu’à 1024 Go sur le même plan
L’AI Gateway est disponible à partir du plan Standard.
Comparer tous les plans4,9 sur 5 · 402 avis sur Google + TrustpilotTrustpilot
Questions fréquentes sur l’AI Gateway
Qu’est-ce que l’AI Gateway de Square Cloud ?
Une API compatible avec OpenAI pour utiliser cubic, le modèle d’IA de Square Cloud, dans vos propres produits, comme des chatbots, des assistants et des automatisations. Vous envoyez vos requêtes à api.squarecloud.app/v2/ai avec la clé d’API de votre compte.
Quels plans y ont accès, et combien ça coûte ?
Pendant la bêta, Standard, Pro et Enterprise bénéficient d’un accès anticipé gratuit, dans les limites de tokens du gateway de chaque plan. Le plan Hobby et les comptes sans plan n’y ont pas accès. Les limites et la disponibilité par plan peuvent changer à la fin de la bêta.
Quel modèle répond ?
Toujours cubic, le même modèle que l’assistant du dashboard. Il n’y a pas de liste de modèles à choisir : le champ model est accepté pour la compatibilité avec les SDK.
Le gateway consomme-t-il les limites de Cubic dans le dashboard ?
Non. Le gateway a ses propres limites de tokens quotidiennes et hebdomadaires, distinctes de celles de l’assistant du dashboard : l’un ne consomme jamais celles de l’autre.
Puis-je l’appeler depuis une application hébergée sur Square Cloud ?
Oui, c’est l’usage principal. C’est une API HTTPS classique, elle fonctionne donc aussi depuis n’importe où.