OpenAI SDK 接入

QuotaAPI 提供 OpenAI 兼容接口，可通过官方 Python、JavaScript SDK 或遵循相同协议的工具调用。

查看 OpenAI SDK 接入概览，了解适用场景和主要能力。

前置条件

1. 在 API Key 页面创建一个 Key。
2. Key 绑定的分组包含目标模型。
3. 安装当前稳定版 OpenAI SDK。

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://quotarouter.ai/v1",
    api_key="YOUR_QUOTAAPI_KEY",
)

response = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "Reply with one short sentence."}],
)

print(response.choices[0].message.content)

JavaScript

import OpenAI from 'openai'

const client = new OpenAI({
  baseURL: 'https://quotarouter.ai/v1',
  apiKey: 'YOUR_QUOTAAPI_KEY',
})

const response = await client.chat.completions.create({
  model: 'gpt-5.5',
  messages: [{ role: 'user', content: 'Reply with one short sentence.' }],
})

console.log(response.choices[0].message.content)

选择 Chat Completions 或 Responses

• 现有 OpenAI 兼容应用通常使用 /v1/chat/completions。
• Codex 和新工作流可使用 /v1/responses。
• DeepSeek 分组支持 Chat Completions，但不支持 Responses。
• 组合分组的能力取决于模型映射最终选择的平台。

Responses 示例：

response = client.responses.create(
    model="gpt-5.5",
    input="Summarize the value of an API gateway in one sentence.",
)

print(response.output_text)

验证模型和用量

先用模型列表确认 Key 可以访问的名称，再在控制台的用量记录中核对状态码、token 和费用：

curl https://quotarouter.ai/v1/models \
  -H "Authorization: Bearer YOUR_QUOTAAPI_KEY"

完整端点和参数说明见 OpenAI 兼容 API。

常见错误

• 401：Key 无效、已禁用或未作为 Bearer Token 发送。
• 404：Base URL 路径重复，或分组不支持目标端点。
• 429：触发 Key 限额、账号并发或上游平台限制。
• SDK 在浏览器报安全错误：不要把长期 API Key 暴露在浏览器代码中，应从自己的服务端调用。