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

# AI API 接入指南：配置、计费与错误排查

星火AI 智能网关开发者指南：OpenAI 兼容 API 接入、Claude Code 中转配置、Token 与缓存计费、401 和 429 等错误排查。

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

**购买前先看价格：**人民币充值特惠： ¥1 到账 US$1 API 额度，¥100 到账 US$100 API 额度。[公开充值价格与额度计算](https://ai.wfpromax.xyz/pricing.html)无需登录即可查看。

这里整理星火网关的接入方法、模型选择、用量核对与常见问题。首次使用可以先阅读 OpenAI 兼容接口教程；使用 Claude Code 则进入对应配置指南。

第一次了解本站？先阅读[星火AI 智能网关服务说明](https://ai.wfpromax.xyz/guides/service.html)，确认适用场景、接入地址和使用限制。

## 选一条适合你的接入路径

## [星火AI API 自助接入：给客户与 AI 的完整文档](https://ai.wfpromax.xyz/guides/ai-integration.html)

一页完成密钥创建、Base URL 配置、模型查询、cURL / Python / Node.js / Claude Code 接入与最小验证；可直接把 Markdown 链接交给 AI。

## [AI 中转站怎么选：OpenRouter、自建网关与星火AI 对比](https://ai.wfpromax.xyz/guides/ai-api-relay-selection.html)

比较 AI API 中转站、OpenRouter 与自建 LLM 网关的适用场景，核对协议兼容、Token 价格、模型来源与调用结果，再接入星火AI。

## [OpenAI 兼容 API 接入教程：Base URL、密钥与模型](https://ai.wfpromax.xyz/guides/openai-compatible-api.html)

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

## [如何验收一次 AI API 调用：模型、响应、用量与扣费](https://ai.wfpromax.xyz/guides/api-verification.html)

从检查请求结构到核对响应、Token 和扣费，按六个步骤保留验证依据，再测试流式输出、工具调用等业务能力。

## [Claude Code 中转配置：连接星火AI 网关](https://ai.wfpromax.xyz/guides/claude-code.html)

配置 Claude Code 的 ANTHROPIC_BASE_URL 与本站 API Key，区分命令行和编辑器环境，检查模型权限与连接状态。

## [AI API Token 计费说明：输入、输出与缓存](https://ai.wfpromax.xyz/guides/token-billing.html)

理解星火AI 网关的输入 Token、输出 Token、缓存计费和分组倍率，按实际模型价格与请求明细核对费用。

## [API 中转报错排查：401、403、404、429 与 503](https://ai.wfpromax.xyz/guides/api-errors.html)

排查星火AI API 接入中的认证失败、分组权限、地址错误、限流和服务暂不可用，减少无效重试。

## [AI API 购买与充值指南：模型、价格、额度和兑换码](https://ai.wfpromax.xyz/guides/buying-guide.html)

购买星火AI API 额度前，核对模型权限、输入输出价格、分组倍率与有效期；了解注册、充值、兑换码和用量查询的完整流程。

## [GPT、Claude、Gemini、Kimi API 怎么选：按任务与成本选模型](https://ai.wfpromax.xyz/guides/model-selection.html)

按编程、文本处理、多模态和长文任务选择 AI API 模型；比较协议兼容、工具调用、实际费用与分组权限，并接入星火AI 网关。

## [ChatGPT／Claude 网页会员与 API 额度有什么区别？](https://ai.wfpromax.xyz/guides/api-vs-subscription.html)

分清 ChatGPT Plus、Claude 网页订阅与 AI API 额度：用途、认证、计费和接入方式不同；按实际需求选择星火AI API 服务。

## 开始前需要准备什么

1. 本站账户和 API Key：登录控制台创建，不使用其他平台密钥。
2. 选择分组与模型：先查看当前可用范围，再复制准确的模型 ID。
3. 设置正确地址：通用 SDK 使用 `https://ai.wfpromax.xyz/v1`，Claude Code 配置根地址。
4. 完成最小验证：先用短输入、受限输出验证响应，然后核对用量。

## API 额度和网页订阅有什么不同

API 面向应用、脚本和兼容客户端；网页订阅是另一种产品。已有网页会员不代表拥有本站 API 额度。充值或兑换前，请先确认你需要的产品与使用方式。

## 模型和价格会不会变化

会。本文不固定写入某个版本的模型价格或承诺永久可用。请以[可用模型页面](https://ai.wfpromax.xyz/available-channels)、密钥权限和请求明细为准。

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

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

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

## 继续阅读

[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)[OpenAI 兼容 API 接入教程：Base URL、密钥与模型](https://ai.wfpromax.xyz/guides/openai-compatible-api.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 -->