OpenAI 兼容 API 接入教程：Base URL、密钥与模型

在星火AI 智能网关配置 API Key 和 Base URL，查询可用模型，用 cURL 发起第一条 Chat Completions 请求，检查响应与用量。

适合已经有聊天应用、脚本或支持 OpenAI 兼容接口的客户端，希望接入星火网关的开发者。接入需要三项：本站 API Key、接口地址、当前分组允许使用的模型名。

先确认地址和可用模型

在本站注册并登录后，到控制台创建 API Key，确认它所属的分组及余额。SDK 或客户端要求填写 Base URL 时，使用 https://ai.wfpromax.xyz/v1；如果要求填写完整接口地址，则使用 https://ai.wfpromax.xyz/v1/chat/completions。不要重复拼接 /v1。

先在可用模型与分组页面了解服务，再用自己的密钥查询模型。不同密钥的权限可能不同，模型名以实际返回为准，不要照搬其他平台的名称。

# 在自己的终端设置本站密钥，不要把真实值提交到代码仓库
export XINGHUO_API_KEY='替换为本站API密钥'
curl --fail-with-body --max-time 30 \
  https://ai.wfpromax.xyz/v1/models \
  -H "Authorization: Bearer $XINGHUO_API_KEY"

发送第一条对话请求

把下面的模型占位符换成上一步返回的准确 ID。生成请求可能产生费用；先限制输出长度，再到用量页核对结果。

curl --fail-with-body --max-time 60 \
  https://ai.wfpromax.xyz/v1/chat/completions \
  -H "Authorization: Bearer $XINGHUO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"替换为可用模型ID","messages":[{"role":"user","content":"只回复你好"}],"max_tokens":32,"stream":false}'

什么才算接入成功

HTTP 200 只是第一步，还要确认响应 JSON 包含预期的回答，并在本站用量页看到相应请求。正式使用前，再按实际业务测试流式输出、工具调用、上下文长度等能力。不同模型的支持范围可能不同，接口格式兼容不代表所有参数都可用。

客户端应该选哪一种接口

普通聊天应用常用 Chat Completions；使用 Responses 的客户端应调用 /v1/responses 并选择支持的模型。Claude Code 的 Messages 配置见专门教程，不能仅把完整 Chat Completions 地址填进去。

上线前的密钥和重试设置

密钥保存在服务端环境变量中，不要写入网页前端、公开仓库或截图。先用小请求验证权限和费用，再提高并发。遇到失败按错误排查表处理，不要无限重试。