Quanta
ZH
中文EnglishEspañolहिन्दीPortuguêsFrançais
登录注册

把客户端接到 Quanta

API 使用独立的子域名 api.quantarelay.com，与网站主域分开。下面按客户端分别说明。

API 参考

所有路径都挂在 https://api.quantarelay.com 下，三种协议共用同一把密钥与同一个余额。

端点一览

请求方式完整路径协议族这个端点做什么
HTTP GETapi.quantarelay.com/v1/modelsOpenAI列出可调用的模型（不含 Gemini）；需要密钥，不计费
HTTP POSTapi.quantarelay.com/v1/chat/completionsOpenAI对话补全，支持流式
HTTP POSTapi.quantarelay.com/v1/responsesOpenAIResponses 接口，支持流式
HTTP POSTapi.quantarelay.com/v1/messagesAnthropicMessages 接口，支持流式
HTTP POSTapi.quantarelay.com/v1/messages/count_tokensAnthropic计算 token 数，不计费
HTTP GETapi.quantarelay.com/v1beta/modelsGemini列出 Gemini 模型；需要密钥，不计费
HTTP POSTapi.quantarelay.com/v1beta/models/{model}:generateContentGemini一次性返回完整回答
HTTP POSTapi.quantarelay.com/v1beta/models/{model}:streamGenerateContent?alt=sseGemini以 SSE 流式返回
HTTP POSTapi.quantarelay.com/v1beta/models/{model}:countTokensGemini计算 token 数，不计费

请求头与鉴权

  • OpenAI 协议用 Authorization: Bearer 传递密钥，Anthropic 协议用 x-api-key，Gemini 协议用 x-goog-api-key。
  • Anthropic 请求未带 anthropic-version 时，由 Quanta 补上 2023-06-01。
  • 密钥也可以放在查询参数 ?key= 里，主要给 Gemini 客户端使用。
  • 你的客户端 IP、Cookie 与 CDN 头不会转发给上游。

限额与超时

  • 单把密钥：任意 60 秒内最多 120 次请求
  • 单个账户：同时最多 8 个在途请求
  • 单次请求体：最大 25 MB
  • 单个账户：最多 20 把有效密钥
  • 流式输出：总时长不限，上游连续 300 秒无数据才断开

错误格式与状态码

错误统一使用 OpenAI 的信封格式返回：

{"error": {"message": "Your Quanta balance is used up. Top up from the dashboard to resume metered calls.", "type": "insufficient_quota", "code": 402}}
HTTP · type 取值这个端点做什么
400 · invalid_request_error缺少模型、模型不存在，或该模型不能走这条协议
401 · authentication_error缺少密钥或密钥无法识别
402 · insufficient_quota余额已用完，充值后重试
403 · permission_error账户已停用
404 · not_found路径不存在
413 · invalid_request_error请求体大于 25 MB 上限
429 · rate_limit_error触发了单密钥速率或单账户并发上限
502 · api_error暂时连不上模型供应商，本次不计费
503 · api_error上游线路尚未配置

各客户端接入指南

参考部分讲清了协议，下面是各类客户端的具体配置。

OpenAI SDK、Codex 及其他兼容客户端

base_url 设为基址加 /v1，api_key 填密钥；对话接口是 /v1/chat/completions，Responses 接口是 /v1/responses。

base_url = "https://api.quantarelay.com/v1"   # Quanta, OpenAI-compatible
api_key  = "qnt-your-key-here"

Python，使用官方 openai 库：

from openai import OpenAI  # pip install openai
qt = OpenAI(base_url="https://api.quantarelay.com/v1", api_key="qnt-your-key-here")
qt_reply = qt.chat.completions.create(model="gpt-6.1-sol", messages=[{"role": "user", "content": "用三条要点总结本季度的故障记录"}])
print(qt_reply.choices[0].message.content)
curl https://api.quantarelay.com/v1/chat/completions \
  -H "Authorization: Bearer qnt-your-key-here" -H "Content-Type: application/json" \
  -d '{"model":"gpt-6.1-sol","messages":[{"role":"user","content":"用三条要点总结本季度的故障记录"}]}'

推荐使用的 GPT 模型 ID：

  • gpt-6.1-sol
  • gpt-6-astra
  • gpt-5.6-sol

Gemini CLI 与 Gemini 原生 API

GOOGLE_GEMINI_BASE_URL 填裸域名（不要加 /v1beta），GEMINI_API_KEY 填密钥，然后运行 gemini。

export GOOGLE_GEMINI_BASE_URL=https://api.quantarelay.com
export GEMINI_API_KEY=qnt-your-key-here
gemini
curl "https://api.quantarelay.com/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "x-goog-api-key: qnt-your-key-here" -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"列出三种降低批处理任务 token 花费的方法"}]}]}'

Gemini 模型只支持原生协议：一次性返回用 :generateContent，流式用 :streamGenerateContent?alt=sse；不能通过 /v1/chat/completions 调用。

可用的 Gemini 模型 ID：

  • gemini-3.1-pro
  • gemini-4-argon
  • gemini-3.8-flash
  • gemini-2.5-flash

Claude Code 与 Claude Desktop

设置两个环境变量后运行 claude：ANTHROPIC_BASE_URL 指向基址（不带 /v1），ANTHROPIC_AUTH_TOKEN 填你的密钥。

export ANTHROPIC_BASE_URL=https://api.quantarelay.com
export ANTHROPIC_AUTH_TOKEN=qnt-your-key-here
claude

Claude 系列模型只对官方 Claude Code / Claude Desktop 客户端开放，并要求 Claude Code 版本不低于 2.1.285，这是上游的限制。GPT、Gemini 等模型可以用任意兼容客户端或 SDK 调用。

注册