Use o cubic nos seus produtos
Uma API compatível com a OpenAI para levar o cubic, o modelo de IA da Square Cloud, aos seus chatbots, assistentes e automações. Se o seu código já usa um SDK da OpenAI, basta trocar a base URL e a chave.
Beta com acesso antecipado gratuito, a partir do plano Standard. Limites e disponibilidade por plano podem mudar quando o beta terminar.
Sua primeira requisição
Aponte qualquer SDK da OpenAI para a base URL da Square Cloud, use a chave de API da sua conta e defina o modelo como cubic.
- Base URL
- https://api.squarecloud.app/v2/ai
- Chave de API
- A chave da sua conta, com o escopo ai:chat
- Modelo
- 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." } ] }'Feito para o código que você já tem
O gateway segue o formato de chat completions da OpenAI: para migrar uma integração existente, basta uma nova base URL e uma nova chave.
Compatível com a OpenAI
Qualquer SDK da OpenAI funciona com a base URL apontada para api.squarecloud.app/v2/ai. Os erros também chegam no formato da OpenAI.
Function calling
Declare até 32 tools no formato da OpenAI. O modelo decide quando chamar uma delas, e o seu código executa e devolve o resultado.
Busca na web embutida
Quando a pergunta pede informação atual, o modelo pesquisa na web sozinho e devolve só a resposta final, citando as URLs das fontes.
Limites próprios
Os limites de tokens do gateway são separados dos do assistente da dashboard: o tráfego da API nunca consome o que sobra para o Cubic no painel, e vice-versa.
Limites por plano
Os tetos de cada plano durante o beta. O Hobby e contas sem plano não têm acesso. Os limites diários renovam à meia-noite (UTC), os semanais na segunda-feira, às 00:00 (UTC), e limites e disponibilidade por plano podem mudar quando o beta terminar.
| Limite | Standard | Pro | Enterprise |
|---|---|---|---|
| Tokens por dia | 2,5M | 5M | 10M - 20M |
| Tokens por semana | 10M | 20M | 40M - 80M |
| Requisições por dia | 1.000 | 5.000 | Ilimitadas |
| Contexto (tokens) | 16k | 24k | 32k |
| Saída máxima (tokens) | 4k | 6k | 8k |
| Requisições simultâneas | 1 | 1 | 2 |
| Intervalo entre requisições | 5s | 2s | Sem espera |
No Enterprise, o limite de tokens cresce com o tamanho do plano. Contexto e saída valem por requisição.
Antes de levar para produção
Três comportamentos para considerar ao integrar o gateway num produto.
Só texto
Texto na entrada, texto na saída, por decisão de produto. Imagem, áudio ou arquivo retornam 400. O Cubic do painel é outro produto e aceita imagem e voz.
Sem memória entre chamadas
Como na OpenAI, a API não guarda conversas. Envie o histórico em messages a cada requisição, com até 100 mensagens.
Resposta completa, sem streaming
Por enquanto a resposta chega inteira. Requisições com "stream": true retornam 400.
Um plano para cada fase do seu projeto
Comece pequeno e escale quando precisar, sem contratos de fidelidade.
Standard
RecomendadoPara produção, com bancos de dados e domínio próprio
A partir de R$ 44,99/mês
- 4 GB de RAM
- 4 vCPU
- Até 16 projetos
- Escala até 8 GB no mesmo plano
Pro
Para alta escala, com snapshots diários das aplicações e analytics avançado
A partir de R$ 124,99/mês
- 12 GB de RAM
- 6 vCPU
- Até 48 projetos
- Escala até 24 GB no mesmo plano
Enterprise
Para grandes operações, com gerente de contas dedicado
A partir de R$ 299,90/mês
- 32 GB de RAM
- 16 vCPU
- Até 128 projetos
- Escala até 1024 GB no mesmo plano
O AI Gateway está disponível a partir do plano Standard.
Comparar todos os planos4,9 de 5 · 402 avaliações no Google + TrustpilotTrustpilot
Perguntas frequentes sobre o AI Gateway
O que é o AI Gateway da Square Cloud?
É uma API compatível com a OpenAI para usar o cubic, o modelo de IA da Square Cloud, nos seus próprios produtos, como chatbots, assistentes e automações. Você envia as requisições para api.squarecloud.app/v2/ai com a chave de API da sua conta.
Quais planos têm acesso, e quanto custa?
Durante o beta, Standard, Pro e Enterprise têm acesso antecipado gratuito, dentro dos limites de tokens do gateway em cada plano. O Hobby e contas sem plano não têm acesso. Limites e disponibilidade por plano podem mudar quando o beta terminar.
Qual modelo responde?
Sempre o cubic, o mesmo modelo do assistente da dashboard. Não há lista de modelos para escolher: o campo model é aceito para manter a compatibilidade com os SDKs.
Usar o gateway consome os limites do Cubic na dashboard?
Não. O gateway tem limites diários e semanais de tokens próprios, separados dos do assistente da dashboard, então um nunca consome o que é do outro.
Posso chamar o gateway de uma aplicação hospedada na Square Cloud?
Sim, esse é o uso principal. É uma API HTTPS comum, então também funciona de qualquer outro lugar.