API 接入配置

1. 创建 API Key

登录控制台，打开密钥管理，为项目创建独立 Key，并按需设置分组、额度、速率与有效期。Key 创建后请妥善保存；不同分组可用的模型可能不同。

2. 填写 Base URL

大多数 OpenAI 兼容客户端可填写下面的地址。部分客户端会自行追加 /v1，配置时不要重复拼接。

3. 先检查模型列表

在本机终端设置环境变量后请求模型列表。返回 401/403 时，先检查 Key、分组、有效期及账户状态；不要把 Key 发给客服排错。

printf 'API Key: '
read -r -s SIYIXINGYUN_API_KEY; printf '\n'
export SIYIXINGYUN_API_KEY
export SIYIXINGYUN_BASE_URL='https://dukou.xyz/v1'
curl "$SIYIXINGYUN_BASE_URL/models" \
  -H "Authorization: Bearer $SIYIXINGYUN_API_KEY"

以上为 macOS/Linux 示例。Windows 用户可使用 安装向导配置 Codex CLI；其他客户端请按其文档设置密钥。

4. 发送 GPT 文本请求

常见兼容客户端使用 Chat Completions。将 MODEL_NAME 改为上一步列表中、当前 Key 分组实际可用的模型。

curl "$SIYIXINGYUN_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $SIYIXINGYUN_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"MODEL_NAME","messages":[{"role":"user","content":"你好"}]}'

Codex CLI 需要 Responses 协议。使用前请确认 /v1/responses 已在当前通道实测通过；本站的 自动安装会生成独立的 Codex 配置档。

5. OpenCode（GPT 文本）

OpenCode 的经典配置可使用 OpenAI-compatible provider 对接本站的 /v1/chat/completions。先在自己的终端设置 SIYIXINGYUN_API_KEY 环境变量，再把以下片段合并到 opencode.json；不要把密钥明文写进文件。OpenCode 新版本配置格式可能变化，以其官方 Provider 文档为准。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "siyixingyun": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "渡口 Token",
      "options": {
        "baseURL": "https://dukou.xyz/v1",
        "apiKey": "{env:SIYIXINGYUN_API_KEY}"
      },
      "models": {
        "gpt-5.6-sol": { "name": "GPT 5.6 Sol" }
      }
    }
  }
}

此示例走 /v1/chat/completions。若模型或客户端要走 /v1/responses，OpenCode 官方文档建议使用 @ai-sdk/openai；实际可用模型以当前 Key 的 /v1/models 为准。

6. 常见错误