QUICK START
几行代码,开始调用。
- 01
创建账户并充值
完成邮箱验证,购买额度包或适合自己的订阅。
- 02
创建 API Key
在控制台设置额度上限、模型范围与有效期。密钥只展示一次,请妥善保存。
- 03
替换 Base URL 和密钥
从模型目录复制已开放的模型 ID,按该模型的接口类型调用。
from openai import OpenAI
client = OpenAI(
api_key="YOUR_JIUCAIBOX_KEY",
base_url="https://api.jiucaibox.dev/v1",
)
response = client.chat.completions.create(
model="YOUR_MODEL",
messages=[{"role": "user", "content": "Hello"}],
max_tokens=256,
)
print(response.choices[0].message.content)用量、流式与重试
流式调用使用 stream: true;Gemini 使用 streamGenerateContent。响应头 x-request-id 可用于排查和对账。
请求先冻结足够的额度,再按实际用量结算。供应商用量缺失或中断会进入待核对。相同 Idempotency-Key 的重复请求返回 409,不再次调用上游。
本期支持各协议的即时生成和自定义函数工具调用;后台任务、已存储响应、多候选输出及供应商内置付费工具暂未开放。
| 状态码 | 含义 |
|---|---|
401 | 密钥无效、过期或已撤销 |
403 | 请在控制台确认最新协议,或检查模型授权范围 |
402 | 余额或密钥预算不足 |
409 | 请求重复或配置已变化 |
429 | 速率或并发上限 |
502 / 503 | 上游失败或暂无可用渠道 |