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://siyixcloud.org/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. GPT 生图

账号分组开放生图模型后，可向 /v1/images/generations 发送请求。分辨率、质量及每张实际费用请以控制台配置为准。

curl "$SIYIXINGYUN_BASE_URL/images/generations" \
  -H "Authorization: Bearer $SIYIXINGYUN_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"IMAGE_MODEL_NAME","prompt":"一张简洁的产品插画","size":"1024x1024"}'

6. 常见错误