词元 API 文档

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

简介

词元 API（CiYuan API）提供 OpenAI 协议兼容的统一接口。你只需要一个 Endpoint 和一个 API Key，即可调用当前已验证模型：

• 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
• Kimi：kimi-k2.5
• 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. 输入邮箱、用户名、密码即可注册（无邮箱验证，一步完成）
3. 注册即送 ¥0.2 试用额度，可用于验证一次小请求、模型响应与调用日志

创建 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": "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 结算，失败会自动退回预扣。

• 1 元 = 50,000 quota
• 不同模型 quota 消耗率不同（见详细定价）
• 文本输入和输出 token 分开计费
• Seedance 不承诺固定“每条价格”，时长、分辨率和实际生成用量都会影响扣费
• 缓存命中部分有折扣（claude 系列）

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

客户端接入

词元 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" 添加自定义模型：
   claude-sonnet-4-6, glm-5.2, deepseek-v4-flash, gemini-2.5-flash, kimi-k2.5, 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,kimi-k2.5,doubao-seed-2.0-code

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-6",
  "messages": [
    {"role": "system", "content": "你是助手"},
    {"role": "user", "content": "hi"}
  ],
  "temperature": 0.7,
  "max_tokens": 2000,
  "stream": true
}

响应同 OpenAI：包含 choices[0].message.content、usage 等字段。不同模型支持的扩展字段可能不同，请先用小请求验证。

接口：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 是否复制完整、账户是否有余额，并查看控制台调用日志。若列表显示可用但请求持续失败，请提交工单或联系页脚邮箱。

能像 OpenAI 那样 stream 吗？

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

模型名怎么写？

用 模型广场页面卡片上显示的完整 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. 模型可用范围：以模型广场和定价页当前展示的已验证模型为准；未列出的模型不在当前销售范围