三分钟接入

OpenAI 兼容,改个 base_url 和 key 就能用

一 · 领一把钥匙

到 用量看板 登录 →「新建令牌」→ 查看密钥。密钥形如 sk-xxxx,只显示一次,请存进服务器的 600 环境变量文件,别进代码库。

二 · 对话接口(文本)

curl https://suanli.qianxuyan.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的钥匙" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "一句话介绍算力超市"}],
    "stream": false
  }'

流式只需加 "stream": true。响应里的 usage 就是本单计费依据。

三 · 视频生成(异步任务)

# 提交任务,拿到 task_id
curl https://suanli.qianxuyan.com/v1/video/generations \
  -H "Authorization: Bearer sk-你的钥匙" \
  -H "Content-Type: application/json" \
  -d '{"model": "sora-2", "prompt": "清晨的秦淮河,一艘摇橹船划过", "duration": 5}'

# 轮询任务状态(成功后返回视频地址)
curl https://suanli.qianxuyan.com/v1/video/generations/{task_id} \
  -H "Authorization: Bearer sk-你的钥匙"

也兼容 OpenAI 风格的 POST /v1/videos;任务完成时才扣费,中途查询不额外收费。

四 · 怎么算钱

扣费 =(输入 tokens + 输出 tokens × 补全倍率)× 模型倍率 × 分组倍率;500,000 quota = 1 美元,按 7.3 汇率折人民币。价签页上的价格就是这条公式的换算结果,账单页逐条可核。

令牌可设额度上限与过期时间,超了直接拒绝,不会产生意外欠费。

五 · 常见错误

返回含义怎么办
401 Invalid token钥匙错、被停用或额度用尽看板里重新查看/新建令牌
429 Too Many Requests触发网关限频退避重试,或联系提额
4xx model price not configured该模型还没定价找管理员配置价签后再用
5xx 上游错误当前渠道故障,网关会切下一条带 request id 反馈,便于定位渠道

六 · SDK 换行不换写法

from openai import OpenAI
client = OpenAI(base_url="https://suanli.qianxuyan.com/v1", api_key="sk-你的钥匙")

resp = client.chat.completions.create(model="qwen3.8-max",
        messages=[{"role": "user", "content": "hello"}])
print(resp.choices[0].message.content)

Python / Node / Java 的 OpenAI SDK 通用,只要改 base_url 与 key。