词元 API 文档

从注册到第一次调用，5 分钟完成接入。

简介

词元 API（CiYuan API）是一个聚合多家大模型厂商的统一 API 网关，提供 OpenAI 协议兼容的接口。你只需要一个 Endpoint 和一个 API Key，就可以调用：

• Anthropic：Claude 4 全系（Sonnet / Opus / Haiku）
• OpenAI：GPT-5.4 / GPT-4o / o3 / o4-mini
• Google：Gemini 2.5 Pro / Flash
• 阿里百炼：Qwen3.6 / Qwen3 Max / Qwen Plus
• DeepSeek：V3 / V3.2 / R1
• Moonshot：Kimi K2.5
• 字节火山：豆包 Seed 2.0 系列 / Seedance 2.0 视频生成
• 智谱：GLM-4.7
• MiniMax：M2.5

注册与试用

1. 访问控制台 api.token-ciyuan.com/register
2. 输入邮箱、用户名、密码即可注册（无邮箱验证，一步完成）
3. 注册即送 ¥0.2 试用额度（约 100,000 quota），足够测试 qwen-plus 2000 次

创建 API Key

1. 登录后进入 令牌管理
2. 点击 "添加令牌"
3. 填写名称（如 "cursor-用"），额度选择 unlimited 或指定金额
4. 保存后复制 sk-... 开头的密钥，这就是你的 API Key

第一次调用

用任何 HTTP 客户端都能调用，最简单的 curl：

复制# 替换 sk-xxx 为你的真实 API Key
curl "https://api.token-ciyuan.com/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxx" \
  -d '{
    "model": "qwen3.6-plus",
    "messages": [{"role":"user","content":"你好"}]
  }'

Python（用官方 OpenAI SDK）：

复制from openai import OpenAI
client = OpenAI(
    api_key="sk-xxx",
    base_url="https://api.token-ciyuan.com/v1"
)
resp = client.chat.completions.create(
    model="claude-sonnet-4-20250514",
    messages=[{"role": "user", "content": "写首诗"}]
)
print(resp.choices[0].message.content)

如何充值

1. 登录控制台 → 钱包管理
2. 选择充值档位：¥10 / ¥30 / ¥50 / ¥100
3. 支付方式：
   • 兑换码：到官方店铺购买后粘贴即时到账（目前唯一通路）
   • 支付宝 / 微信：即将开通
   • 对公转账（≥¥500）：联系客服
4. 支付成功后余额立即可用，无过期时间

定价说明

词元 API 按 token 用量实时计费，调用后立即从余额扣除。

• 1 元 = 50,000 quota
• 不同模型 quota 消耗率不同（见详细定价）
• 输入和输出 token 分开计费
• 缓存命中部分有折扣（claude 系列）

示例：用 qwen-plus 问一个 500 token 的问题，得到 1000 token 回答：

输入：500 × $0.4/1M = $0.0002
输出：1000 × $1.2/1M = $0.0012
总计：约 $0.0014 ≈ ¥0.01

客户端接入

词元 API 支持所有兼容 OpenAI 的客户端。填写这两项即可：

Cursor

1. Cursor 设置 → Models
2. 找到 "OpenAI API Key" 部分，粘贴你的 Key
3. 打开 "Override OpenAI Base URL"，填入 https://api.token-ciyuan.com/v1
4. 在 "Model Names" 添加自定义模型：
   gpt-4o, claude-sonnet-4-20250514, deepseek-v3.2, kimi-k2.5

Claude Code CLI

环境变量方式：

复制export ANTHROPIC_BASE_URL=https://api.token-ciyuan.com
export ANTHROPIC_AUTH_TOKEN=sk-你的KEY
claude

Cherry Studio

1. 设置 → 服务商 → 添加 → OpenAI
2. 名称：词元 API
3. API Key：sk-xxx
4. API 地址：https://api.token-ciyuan.com/v1
5. 在模型管理添加模型名（同上）

Lobe Chat

1. 设置 → 语言模型 → OpenAI
2. API Key：粘贴你的 sk-xxx
3. API 代理地址：https://api.token-ciyuan.com/v1
4. 自定义模型名：qwen3.6-plus,claude-sonnet-4-20250514,deepseek-v3.2

ChatBox

1. 设置 → Model Provider → OpenAI API
2. API Host：https://api.token-ciyuan.com
3. API Path：/v1/chat/completions（默认即可）
4. API Key：sk-xxx
5. Model：填入支持的模型名

OpenCat

1. 设置 → 团队
2. Domain：https://api.token-ciyuan.com
3. Token：sk-xxx

接口：Chat Completions

POST /v1/chat/completions

请求体完全兼容 OpenAI 格式：

复制{
  "model": "claude-sonnet-4-20250514",
  "messages": [
    {"role": "system", "content": "你是助手"},
    {"role": "user", "content": "hi"}
  ],
  "temperature": 0.7,
  "max_tokens": 2000,
  "stream": true
}

响应同 OpenAI：包含 choices[0].message.content、usage 等字段。Claude 系列还会带 reasoning_content（思考链）。

接口：视频生成（Seedance 2.0）

基于字节火山 Seedance 2.0，支持文生视频、图生视频、音乐同步。

创建任务

POST /v1/video/generate

复制{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {"type": "text", "text": "一只橘猫在阳光下伸懒腰"},
    {"type": "image_url", "image_url": {"url": "https://..."}, "role": "reference_image"}
  ],
  "ratio": "16:9",
  "duration": 5,
  "watermark": false,
  "generate_audio": true
}

返回 {task_id, status: "running", cost_yuan: 1.5}

查询状态

GET /v1/video/task/:task_id

视频通常 1-3 分钟生成完毕。status 变为 succeeded 时返回 video_url。

模型列表

所有可用模型可通过 GET /v1/models 获取，或访问模型广场查看详情。

错误码

常见问题

为什么我的 Key 调用 Claude 报错？

Claude 系列目前因 gptsapi 余额不足暂停服务，余额充值后恢复。国产模型（qwen/deepseek/kimi/doubao/glm）全部正常可用。

能像 OpenAI 那样 stream 吗？

能。在请求里加 "stream": true，响应会以 SSE 格式返回。

模型名怎么写？

用 模型广场页面卡片上显示的 slug，如 qwen3.6-plus、claude-sonnet-4-20250514。

额度用完了怎么办？

到 充值页面用兑换码充值，付款方式即将开放支付宝/微信扫码。

服务条款

使用词元 API 即表示您同意以下条款：

1. 不得用于生成违反中国大陆法律法规的内容
2. 不得用于未经授权的他人身份信息爬取或 AI 钓鱼攻击
3. 付费后 7 日内无调用可申请退款，已调用部分不退
4. 我们保留拒绝服务和封禁账户的权利