开发者文档 · 国模工厂

安装 SDK

pip install -U openai

配置鉴权

在控制台创建 Key。完整密钥仅展示一次，平台数据库仅保存不可逆哈希。不要把 Key 放在浏览器、移动 App 或公开仓库。

export GUOMO_API_KEY="qh_live_..."

发起请求

全面兼容 OpenAI 常用请求参数，包括 model、messages、temperature、top_p、presence_penalty、frequency_penalty、stop、seed、max_tokens、stream、stream_options、工具调用 (tools / tool_choice) 与 response_format。支持直接无缝替换 Cursor、NextChat、Chatbox、Dify、LangChain 等客户端的 Base URL 与 API Key。

cURL 快速验证 (10 秒运行)

curl https://token.haoxiu.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $GUOMO_API_KEY" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "你好"}],
    "temperature": 0.7
  }'

Python (OpenAI SDK)

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["GUOMO_API_KEY"],
    base_url="https://token.haoxiu.com/v1"
)

response = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "用三句话解释向量检索"}],
    max_tokens=500
)

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

Seedance 视频

通过百度 VOD 提交异步视频任务。使用允许高级模型的青衡项目 Key，向 POST /api/v3/contents/generations/tasks 提交。将 /quote 加在该路径末尾可先查询最高冻结额。

保存任务 ID，使用 GET /api/v3/contents/generations/tasks/{id} 查询。成功时返回临时视频链接和实际视频 Token。提交时带 Idempotency-Key，网络重试沿用原请求体和原键。

费用按实际视频 Token 从项目现金余额结算，实扣以冻结额为上限。查看当前公示价，或在视频工作台查看模型规格、参考素材用法和完整接入示例。

限流与预算

每个 Key 独立执行 RPM、TPM、最大并发、每日预算和月度预算。流式请求开始前会按最大可能费用预占，结束后自动释放差额。

错误处理

每个响应都带 x-request-id。429 不会无限重试；上游结果不确定时返回 provider_result_unknown，平台会保留预占并人工核对。

{
  "error": {
    "message": "余额不足",
    "type": "invalid_request_error",
    "code": "insufficient_balance",
    "request_id": "req_..."
  }
}

安全建议

生产、测试、客户项目分别创建 Key。
设置 IP 白名单、到期时间和尽可能小的预算。
发现泄漏后立即轮换；旧 Key 会立刻失效。
使用 Idempotency-Key 防止网络重试重复提交。

十分钟完成第一次调用