01 / 领取账号与创建密钥

打开 数域 AI，使用管理员提供的账号登录。

1. 左侧点击「API 密钥」，再点击「创建密钥」。
2. 名称随意填写，厂商选择 OpenAI。
3. 选择自己支持的分组。目前「openai 备用」和「openai」无区别，可任意选择。
4. 按需设置额度、有效期；点击「创建」。
5. 在密钥列表点击「使用」，根据你的电脑选择 Windows / Mac，查看网站生成的配置。

02 / Mac：用 curl 查询模型与验证 Responses API

打开 Mac「终端」，在同一个窗口中设置密钥并执行请求。将示例中的「替换为自己的 API Key」替换为你的密钥后执行。

A. 查询当前密钥可见的模型

将占位符替换为自己的密钥。模型列表只代表当前可见的模型，实际能否生成以调用结果为准。

export SUB2API_API_KEY='替换为自己的 API Key'

curl --fail-with-body https://ai.shuyushikong.com/v1/models \
  -H "Authorization: Bearer $SUB2API_API_KEY"

B. Responses API 示例

export SUB2API_API_KEY='替换为自己的 API Key'

curl --fail-with-body https://ai.shuyushikong.com/v1/responses \
  -H "Authorization: Bearer $SUB2API_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "input": "你好，请简单介绍一下自己。",
    "max_output_tokens": 512,
    "store": false
  }'

C. 如何判断成功

此示例未设置 stream，使用非流式 JSON 响应。检查响应中的 status 是否为 completed，并在 output 数组中查找消息内容里的 output_text 文本。仅请求返回成功，不代表内容已经完整生成。

如返回 incomplete，查看 incomplete_details；512 个输出 token 可能不足以覆盖推理与最终回答，可按需调整。若返回错误，检查密钥余额、模型权限与分组对该请求格式的支持。--fail-with-body 会在 HTTP 错误时返回非零退出码，同时保留错误正文。

03 / 常见问题