开发者指南 · API 接入与选购

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

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

星火AI 智能网关 · 更新于 2026-10-18

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

## 先确认地址和可用模型

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

先在[可用模型与分组页面](https://ai.wfpromax.xyz/available-channels)了解服务，再用自己的密钥查询模型。不同密钥的权限可能不同，模型名以实际返回为准，不要照搬其他平台的名称。

```
# 在自己的终端设置本站密钥，不要把真实值提交到代码仓库
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 包含预期的回答，并在本站用量页看到相应请求。正式使用前，再按实际业务测试流式输出、工具调用、上下文长度等能力。不同模型的支持范围可能不同，接口格式兼容不代表所有参数都可用。

完成首条请求后，按[AI API 调用验证指南](https://ai.wfpromax.xyz/guides/api-verification.html)逐项核对模型、回答、Token 与扣费，再验证实际业务需要的能力；保留请求时间、脱敏响应和对应账户记录，便于定位差异。

## 客户端应该选哪一种接口

普通聊天应用常用 Chat Completions；使用 Responses 的客户端应调用 `/v1/responses` 并选择支持的模型。Claude Code 的 Messages 配置见[专门教程](https://ai.wfpromax.xyz/guides/claude-code.html)，不能仅把完整 Chat Completions 地址填进去。

## 上线前的密钥和重试设置

密钥保存在服务端环境变量中，不要写入网页前端、公开仓库或截图。先用小请求验证权限和费用，再提高并发。遇到失败按[错误排查表](https://ai.wfpromax.xyz/guides/api-errors.html)处理，不要无限重试。

## 选好模型，把想法接入应用

查看当前模型与账户价格，注册并选择适合的额度，再按指南完成接入。

 [查看模型与价格](https://ai.wfpromax.xyz/available-channels?entry=guide_openai-compatible-api) [购买 API 额度](https://ai.wfpromax.xyz/purchase?entry=guide_openai-compatible-api) [注册账户 →](https://ai.wfpromax.xyz/register?entry=guide_openai-compatible-api)

## 继续阅读

[Claude Code 中转配置：连接星火AI 网关](https://ai.wfpromax.xyz/guides/claude-code.html)[AI API Token 计费说明：输入、输出与缓存](https://ai.wfpromax.xyz/guides/token-billing.html)[星火AI 智能网关是什么：服务、接入方式与适用范围](https://ai.wfpromax.xyz/guides/service.html)[API 中转报错排查：401、403、404、429 与 503](https://ai.wfpromax.xyz/guides/api-errors.html)[AI API 购买与充值指南：模型、价格、额度和兑换码](https://ai.wfpromax.xyz/guides/buying-guide.html)[GPT、Claude、Gemini、Kimi API 怎么选：按任务与成本选模型](https://ai.wfpromax.xyz/guides/model-selection.html)[ChatGPT／Claude 网页会员与 API 额度有什么区别？](https://ai.wfpromax.xyz/guides/api-vs-subscription.html)

<!-- public-api-endpoints:start -->

## API 接入地址 / API endpoints

- 默认 / Default — `https://ai.wfpromax.xyz`
- 8xh.pro — `https://8xh.pro`

- OpenAI-compatible Base URL — `https://ai.wfpromax.xyz/v1`
- Claude Code Base URL — `https://ai.wfpromax.xyz`

<!-- public-api-endpoints:end -->