开发者文档
快速开始
从零开始接入切线云 API，全程约 10 分钟，完成首次调用并在调用记录中看到这次调用。
§ 0 这是什么？
切线云是一个大模型统一接入平台：一个账号、一份 API Key，接入多家国内外主流大模型。你按 OpenAI 兼容的方式调用，我们负责路由和计费。
关键术语
API Key：你的身份凭证，用于向平台证明调用者是你。格式形如 sk-xxxxx，创建后请妥善保管，不要公开分享。
Base URL：平台的网关地址。你的客户端或代码需要把 OpenAI 默认地址替换成这个。格式形如 https://api.example.com（不带 /v1）。
额度：团队钱包余额，单位换算为人民币。调用按用量扣减，余额为 0 时调用会被直接拒绝，请确保先充值再调用。
§ 1 注册账号
打开注册页面，填写用户名和密码，点击「注册」。
注册成功后系统自动为你创建个人团队，并跳转到控制台首页。无需任何额外配置。
§ 2 充值（预留入口）
余额为 0 会导致调用被拒
在线充值功能即将开放。目前如需充值，请前往钱包页面了解当前可用方式，或联系运营获取兑换码。
请先确认账户有余额再进行调用，否则 API 返回 402 错误（额度不足）。
§ 3 创建第一个 API Key
进入密钥页面，点击「新建密钥」。
填写 Key 名称（建议按工具命名，例如 claude-code 或 cursor-dev），方便日后识别。模型白名单可以先留空，表示允许当前团队所有可用模型。
创建成功后，弹窗会显示 Base URL 和 API Key 明文（仅显示一次）。复制并妥善保存。
以下是平台网关地址和密钥占位，供接入时参考：
随时取回密钥
如果已启用两步验证（TOTP / Passkey），可随时在密钥列表点击「复制密钥」取回明文（每次取回都需要通过二次验证）。
§ 4 选一个模型
前往模型广场，找一个你想用的模型，点击复制其模型 ID（格式形如 gpt-4o 或 claude-3-5-sonnet-20241022）。
如何挑选模型
- 价格倍率 < 1：表示折扣模型，性价比高。
- 价格倍率 = 1：标准计费。
- 模型广场始终展示当前可用的公开模型，选标注「推荐」的便宜对话模型上手即可。
- 将复制的模型 ID 填入客户端的 model 字段，替换下文示例中的
[在模型广场复制的模型 id]。
接下来在 § 5 选一种接入方式，把模型 ID 填进去。
§ 5 接入你的客户端
选择你使用的工具。
编码 Agent / CLI
Claude Code（配置文件方式）
将以下内容写入 ~/.claude/settings.json（全局配置）或项目根目录的 .claude/settings.json：
把 {API_KEY} 替换成你的真实 Key，Base URL 已自动填入。
也可用 CC Switch（图形化快捷路径）：在密钥详情页切换到 CC Switch 标签，选 Claude 应用、填写模型 ID，点击「导入到 CC Switch」——客户端弹出后自动写入凭证。
Codex（配置文件方式）
将以下内容写入 ~/.codex/config.toml：
API Key 通过环境变量提供（见下方 toml 注释）。
也可用 CC Switch：选 Codex 应用并填入模型 ID，点击导入。
/v1 路径差异
Claude Code：ANTHROPIC_BASE_URL 填不带 /v1 的地址（Claude Code 自己拼接路径）。
Codex / OpenAI 兼容客户端：base_url 或 OPENAI_BASE_URL 填带 /v1 的地址（即 Base URL + /v1）。
两者混淆是最常见的接入失败原因。
桌面 / IDE 客户端
这类客户端在设置页面有「API 地址」和「API Key」字段，手动填入即可。
| 字段名称 | 填写内容 |
|---|---|
| API 地址 / Base URL | 平台网关地址（不带 /v1）— 见下方组件 |
| API Key | 你的真实密钥（sk-xxxxx） |
| 模型 ID | 从模型广场复制的模型 ID |
路径差异：/v1 或不带 /v1？
大多数桌面客户端（Cherry Studio、Cursor、Cline、ChatBox）使用 OpenAI 兼容协议，
需要填写带 /v1 的完整地址（即 Base URL + /v1）。
每个客户端的完整字段说明见各自接入指南页。
快速跳转：
直接调 API（curl / Python / 环境变量）
curl 快速验证：
把 {API_KEY} 替换为你的真实 Key，[在模型广场复制的模型 id] 替换为实际模型 ID。
环境变量（通用方式）：
设置好环境变量后，Claude Code / Codex 等 CLI 工具会自动读取，无需再写配置文件。
Python 示例：参见 Python 示例。
路径规则
所有 curl / Python / OpenAI SDK 调用：endpoint 为 {Base URL}/v1/chat/completions（带 /v1）。
§ 6 发起首次调用，确认成功
用 § 5 中的方式发起一次调用（推荐先用 curl 验证）：
成功长这样：
{
"id": "chatcmpl-xxxx",
"object": "chat.completion",
"choices": [
{
"message": {
"role": "assistant",
"content": "Hello! How can I help you today?"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 10,
"completion_tokens": 12,
"total_tokens": 22
}
}你已成功接入切线云 🎉
调用成功！前往 调用记录查看这次调用——模型名称、消耗 tokens、扣减金额都会在那里。