使用文档

绰软 API 使用文档

从登录控制台、获取 API Key、配置 Base URL 到常见工具接入。所有模型、倍率和额度规则以绰软后台实际配置为准。

基础信息

绰软 API 使用 OpenAI 兼容接口。客户端配置时，请将 Base URL 设置为：

https://api.chuoruan.com/v1

登录控制台后可在模型广场查看当前可用模型。不要在公开仓库、截图或聊天中暴露自己的 API Key。

获取 API Key

访问 https://api.chuoruan.com/ 并登录控制台。
进入令牌管理页面。
点击创建令牌，按需要设置名称、额度或过期时间。
复制生成的 Key，并保存到本地安全位置。

如需要充值，请先进入充值中心或控制台充值入口，完成订单后再确认余额。

Codex 配置

编辑 Codex 配置文件，将 provider 指向绰软 API。模型名称请以后台模型广场为准。

model_provider = "OpenAI"
model = "gpt-5.4-mini"
review_model = "gpt-5.4-mini"
model_reasoning_effort = "medium"

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.chuoruan.com/v1"
wire_api = "responses"
requires_openai_auth = true

认证文件

{
  "OPENAI_API_KEY": "sk-替换为你的绰软 API Key"
}

配置完成后重启 Codex。如果历史会话无法继承，优先检查 config 中的 provider 名称是否和历史会话一致。

Cursor 配置

打开 Cursor 设置中的模型或 API 配置区域。
启用自定义 OpenAI Compatible API。
Base URL 填写 https://api.chuoruan.com/v1。
API Key 填写你在绰软控制台创建的令牌。
模型名称按绰软后台模型广场填写。

Cursor 对第三方 API 的兼容性会随版本变化，如配置正确但不可用，可先用 curl 或 Codex 验证 Key 是否正常。

Claude Code 配置

如客户端支持自定义兼容接口，可按工具要求填写 Base URL 和 Token。示例：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.chuoruan.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-替换为你的绰软 API Key",
    "ANTHROPIC_MODEL": "gpt-5.4-mini"
  }
}

不同版本的 Claude Code 对 OpenAI 兼容接口支持不同，实际以客户端当前版本为准。

接口示例

使用 chat completions 的基础请求：

curl https://api.chuoruan.com/v1/chat/completions \
  -H "Authorization: Bearer sk-替换为你的绰软 API Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      {"role": "user", "content": "你好，做一个简短自我介绍"}
    ]
  }'

如果客户端会自动拼接接口路径，Base URL 只填写到 /v1，不要写成 /v1/v1。

常见问题

为什么返回 401？

通常是未携带 API Key、Key 填错、复制时多了空格，或令牌已被禁用。

为什么提示模型不存在？

请到模型广场确认当前 Key 所在分组支持的模型名称，不要使用文档示例以外未开通的模型。

充值后如何确认到账？

优先查看控制台余额和充值记录。支付通道正式启用前，充值中心会显示当前通道状态，不会伪造成功到账。