词元 API 文档

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

简介

词元 API（CiYuan API）的文本模型提供 Chat Completions 调用方式，兼容常见请求与响应字段；不同模型支持的参数、扩展字段和响应细节可能不同。Seedance 使用独立异步视频接口，不属于文本 Chat Completions。当前接入标识包括：

• Claude：claude-opus-4-6、claude-sonnet-4-6、claude-haiku-4-5
• Gemini：gemini-2.5-pro、gemini-2.5-flash、gemini-2.5-flash-lite
• GLM：glm-5.2
• DeepSeek：deepseek-v4-pro、deepseek-v4-flash
• 豆包：doubao-seed-2.0-pro、doubao-seed-2.0-code、doubao-seed-2.0-lite、doubao-seed-code
• 视频生成：seedance-2.0、seedance-2.0-fast（异步接口，开放状态以模型页实时检测为准）

注册与试用

1. 访问控制台 api.token-ciyuan.com/register
2. 输入手机号获取 6 位验证码，并设置密码完成注册
3. 注册完成后会自动创建默认 API Key，可直接复制并测试调用
4. 注册即送 ¥0.2 试用额度，可用于验证一次小请求、模型响应与调用日志

创建 API Key

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

第一次调用

可用支持自定义请求头和 JSON 请求体的 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": "claude-sonnet-4-6",
    "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-6",
    messages=[{"role": "user", "content": "写首诗"}]
)
print(resp.choices[0].message.content)

如何充值

1. 首次充值可先查看 API 中转与充值说明，确认充值账号和余额规则
2. 登录控制台 → 钱包管理
3. 选择充值档位：¥10 / ¥30 / ¥50 / ¥100
4. 支付方式：
   • 支付宝 / 微信扫码：在线支付后自动到账
   • 兑换码：已有兑换码可在控制台粘贴兑换
   • 对公转账（≥¥500）：联系客服
5. 支付成功后余额立即可用，无过期时间

定价说明

文本 API 按输入、输出 token 用量计费；视频 API 先预扣任务额度，成功后按实际视频 token 结算，失败会自动退回预扣。

• 控制台按人民币显示可用余额
• 不同模型每百万 token 价格不同（见详细定价）
• 文本输入和输出 token 分开计费
• Seedance 不承诺固定“每条价格”，时长、分辨率和实际生成用量都会影响扣费
• 缓存命中部分有折扣（claude 系列）

每次请求完成后，可在控制台日志中查看模型名、输入 token、输出 token 与实际扣费。定价页价格用于预估，最终以调用日志为准。

开发票

¥500 以上充值可申请增值税普通发票。付款到账后请通过页脚邮箱提交开票信息；不要在邮件中发送 API Key、登录密码或短信验证码。

客户端接入

文本 Chat Completions 可接入支持自定义 Base URL、Bearer API Key 和对应请求方式的客户端；兼容范围限于常见字段，具体参数、功能及界面以客户端版本和所选模型为准。先填写这两项：

Cursor

1. Cursor 设置 → Models
2. 找到 "OpenAI API Key" 部分，粘贴你的 Key
3. 打开 "Override OpenAI Base URL"，填入 https://api.token-ciyuan.com/v1
4. 在 "Model Names" 添加自定义模型：
   claude-sonnet-4-6, glm-5.2, deepseek-v4-flash, gemini-2.5-flash, doubao-seed-2.0-code

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. 自定义模型名：claude-sonnet-4-6,glm-5.2,deepseek-v4-flash,gemini-2.5-flash,doubao-seed-2.0-code

NextChat

1. 打开设置并启用自定义接口，选择 OpenAI 服务商
2. 接口地址：https://api.token-ciyuan.com（不要在末尾重复添加 /v1，当前 NextChat 会拼接 Chat Completions 请求路径）
3. API Key：粘贴你在词元控制台创建的 Key
4. 在自定义模型中添加当前模型列表显示的完整 slug

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

请求体采用文本 Chat Completions 调用方式，并兼容以下常见字段。并非所有 OpenAI 参数都在每个模型上可用，请按所选模型先用小请求验证：

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

非流式响应使用 Chat Completions 常见结构，正文通常位于 choices[0].message.content，并可包含 usage；流式响应以 SSE 增量事件返回，正文通常位于 choices[0].delta.content。字段是否提供及具体结构可能因模型和上游而异，不承诺与 OpenAI 响应完全一致，请先用小请求验证。

接口：Video Generations

POST /v1/video/generations 创建异步视频任务。只有模型广场实时显示“可用”时再提交。

复制curl "https://api.token-ciyuan.com/v1/video/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxx" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "海边日落，固定镜头，无文字",
    "seconds": "4",
    "metadata": {
      "resolution": "480p",
      "ratio": "16:9",
      "generate_audio": false,
      "watermark": false
    }
  }'

创建成功会返回 task_id。用同一个 API Key 查询任务：

复制curl "https://api.token-ciyuan.com/v1/video/generations/task_xxx" \
  -H "Authorization: Bearer sk-xxx"

查看响应中的 data.status 与 data.progress；成功后读取结果地址。任务可能排队或运行数分钟，不要因客户端请求结束而重复创建同一任务。

模型列表

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

错误码

常见问题

为什么 API Key 调用报错？

先核对模型名是否在当前可用列表、Key 是否复制完整、账户是否有余额，并查看控制台调用日志。若列表显示可用但请求持续失败，请提交工单或联系页脚邮箱。

文本调用可以 stream 吗？

支持流式返回的文本模型可在请求里设置 "stream": true，响应会以 SSE 增量事件返回。具体增量字段和 usage 的返回方式可能因模型而异，请先用小请求验证。

模型名怎么写？

用 模型广场页面卡片上显示的完整 slug，如 glm-5.2、deepseek-v4-flash。Seedance 使用视频接口，不要把视频模型名发到 Chat Completions。

模型可用性与标识

模型名代表实际请求的模型，不会在未告知用户的情况下替换成其他品牌或“同等级”模型。当前可用状态以模型广场实时检测为准，销售范围和费用以定价页为准。

使用前请注意：

• 先用赠送额度发送一次小请求，确认响应内容、速度和工具调用符合需求；
• 模型状态可能变化，未列出的模型当前不销售、不承诺可用；
• 每次调用可在控制台日志核对请求模型、token 用量和实际扣费；
• 若付款后没有产生调用且服务不符合页面说明，可按退款规则申请处理。

额度用完了怎么办？

到 控制台充值页面，系统会自动识别当前账号，可用支付宝 / 微信扫码或兑换码充值。首次充值建议先看 充值说明页，确认当前账号和充值后预计余额。

常见 API 关键词怎么查？

如果你是从搜索或 AI 助手里问“Claude API 国内怎么用”“Gemini API 国内调用”“API Token 怎么充值”等问题，可以直接看 AI API 知识库。每个词条都给出一句话答案、操作步骤和充值入口。

服务条款

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

1. 不得用于生成违反中国大陆法律法规的内容
2. 不得用于未经授权的他人身份信息爬取或 AI 钓鱼攻击
3. 付费后 7 日内无调用可申请退款，已调用部分不退
4. 我们保留拒绝服务和封禁账户的权利
5. 模型可用范围：以模型广场和定价页当前展示的已验证模型为准；未列出的模型不在当前销售范围