在你的产品中使用 cubic
通过与 OpenAI 兼容的 API，把 Square Cloud 的 AI 模型 cubic 接入你的聊天机器人、助手和自动化流程。如果你的代码已经在使用 OpenAI SDK，只需替换 base URL 和密钥。
Beta 免费抢先体验，Standard 套餐起可用。Beta 结束后，限制和各套餐的可用性可能会变化。
你的第一个请求
将任意 OpenAI SDK 指向 Square Cloud 的 base URL，使用你账户的API 密钥，并把模型设为 cubic。
- Base URL
- https://api.squarecloud.app/v2/ai
- API 密钥
- 你账户的密钥，需具备 ai:chat 权限范围
- 模型
- 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." } ] }'为你现有的代码而设计
Gateway 遵循 OpenAI 的 chat completions 格式：迁移现有集成，只需新的 base URL 和新的密钥。
兼容 OpenAI
只要把 base URL 指向 api.squarecloud.app/v2/ai，任何 OpenAI SDK 都能使用。错误同样以 OpenAI 格式返回。
Function calling
按 OpenAI 格式声明最多 32 个工具。由模型决定何时调用，你的代码负责执行并返回结果。
内置网页搜索
当问题需要最新信息时，模型会自行搜索网页，只返回最终答案，并注明来源 URL。
独立的限额
Gateway 的 token 限额与控制台助手的限额相互独立：API 流量不会占用 Cubic 在控制台中的剩余额度，反之亦然。
各套餐限额
Beta 期间各套餐的上限。Hobby 和没有套餐的账户无法使用。每日限额在 00:00（UTC）重置，每周限额在周一 00:00（UTC）重置；Beta 结束后，限制和各套餐的可用性可能会变化。
| 指标 | Standard | Pro | Enterprise |
|---|---|---|---|
| 每日 token | 2.5M | 5M | 10M - 20M |
| 每周 token | 10M | 20M | 40M - 80M |
| 每日请求数 | 1,000 | 5,000 | 不限 |
| 上下文（tokens） | 16k | 24k | 32k |
| 最大输出（tokens） | 4k | 6k | 8k |
| 并发请求 | 1 | 1 | 2 |
| 请求间隔 | 5s | 2s | 无需等待 |
Enterprise 套餐的 token 限额随套餐规模增长。上下文和输出按单次请求计算。
投入生产之前
将 Gateway 集成到产品中时需要考虑的三种行为。
仅支持文本
输入输出均为文本，这是产品设计。图片、音频或文件会返回 400。控制台中的 Cubic 是另一个产品，支持图片和语音。
调用之间不保留记忆
和 OpenAI 一样，API 不保存对话。每次请求都要在 messages 中发送完整历史，最多 100 条消息。
一次性返回完整响应，不支持流式
目前响应会一次性返回。携带 "stream": true 的请求会返回 400。
项目每个阶段都有合适的套餐
从小规模开始，按需扩展，无绑定合约。
Standard
推荐适合生产环境，含数据库和自定义域名
低至 R$44.99/月 ≈ ¥58.49
- 4 GB 内存
- 4 vCPU
- 最多 16 个项目
- 同一套餐内最高可扩展至 8 GB
Pro
适合大规模应用，含应用每日快照和高级分析
低至 R$124.99/月 ≈ ¥162.49
- 12 GB 内存
- 6 vCPU
- 最多 48 个项目
- 同一套餐内最高可扩展至 24 GB
Enterprise
面向大型业务，配备专属客户经理
低至 R$299.90/月 ≈ ¥389.87
- 32 GB 内存
- 16 vCPU
- 最多 128 个项目
- 同一套餐内最高可扩展至 1024 GB
AI Gateway 自 Standard 套餐起提供。
对比所有套餐4.9 分（满分 5 分）· Google + Trustpilot 上的 402 条评价Trustpilot
AI Gateway 常见问题
什么是 Square Cloud 的 AI Gateway？
一个与 OpenAI 兼容的 API，让你在自己的产品中使用 Square Cloud 的 AI 模型 cubic，例如聊天机器人、助手和自动化流程。你使用账户的 API 密钥向 api.squarecloud.app/v2/ai 发送请求。
哪些套餐可以使用？费用是多少？
Beta 期间，Standard、Pro 和 Enterprise 可免费抢先体验，用量以各套餐的 Gateway token 限额为准。Hobby 和没有套餐的账户无法使用。Beta 结束后，限制和各套餐的可用性可能会变化。
由哪个模型回答？
始终是 cubic，与控制台助手使用的模型相同。没有可选择的模型列表：保留 model 字段是为了兼容 SDK。
使用 Gateway 会消耗控制台中 Cubic 的限额吗？
不会。Gateway 拥有独立的每日和每周 token 限额，与控制台助手的限额分开，二者互不占用。
可以从托管在 Square Cloud 上的应用调用吗？
可以，这正是主要用途。它是普通的 HTTPS API，因此在其他任何地方也能调用。