跳至内容
jiucaibox韭菜盒子

QUICK START

几行代码,开始调用。

  1. 01

    创建账户并充值

    完成邮箱验证,购买额度包或适合自己的订阅。

  2. 02

    创建 API Key

    在控制台设置额度上限、模型范围与有效期。密钥只展示一次,请妥善保存。

  3. 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上游失败或暂无可用渠道