快速开始
三步完成接入，从创建密钥到发出第一个请求。
- 01
创建密钥
在控制台的 API 密钥页面新建一个密钥，复制以 sk- 开头的字符串。
NINEFIRE_API_KEY - 02
配置环境变量
把密钥写入环境变量，避免硬编码到代码里。
export NINEFIRE_API_KEY=sk-xxxxxx - 03
指向网关
把 base_url 改为上面的网关地址，业务代码无需改动。
OpenAI 兼容（curl）
标准 Chat Completions 协议，把请求地址改为网关地址即可。
request.sh
curl https://ninefireai.cn/api/v1/chat/completions \
-H "Authorization: Bearer $NINEFIRE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen3-max",
"messages": [{ "role": "user", "content": "请简要介绍你的能力" }]
}'Anthropic 兼容（Python）
复用官方 anthropic SDK，base_url 追加 /anthropic 后缀即走 Messages 协议。
main.py
from anthropic import Anthropic
client = Anthropic(
api_key="$NINEFIRE_API_KEY",
base_url="https://ninefireai.cn/api/v1/anthropic"
)
msg = client.messages.create(
model="qwen3-max",
max_tokens=512,
messages=[{"role": "user", "content": "解释 RAG 的核心思想"}]
)
print(msg.content[0].text)OpenAI 兼容（Node.js）
官方 openai 包同样适用，仅需设置 apiKey 与 baseURL 两个字段。
index.ts
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: process.env.NINEFIRE_API_KEY,
baseURL: 'https://ninefireai.cn/api/v1'
});
const res = await client.chat.completions.create({
model: 'qwen3-max',
messages: [{ role: 'user', content: '请简要介绍你的能力' }]
});
console.log(res.choices[0].message.content);错误码
错误以标准 HTTP 状态码返回，响应体中的 code 字段标识具体原因。
| 代码 | 含义 |
|---|---|
| UNAUTHORIZED | 密钥失效或未携带，检查 Authorization 头。 |
| RATE_LIMITED | 请求超过限速，降低并发后重试。 |
| INSUFFICIENT_BALANCE | 账户余额不足且超出透支额度。 |
| PROVIDER_UNAVAILABLE | 底层资源暂时不可用，请稍后重试。 |
| FORBIDDEN | 当前账户无权访问该资源。 |
速率限制
默认限速适用于绝大多数场景，企业账户可在控制台申请上调。
登录接口
5 次 / 分钟
按来源 IP 计
常规 API
120 次 / 分钟
按用户计
模型 RPM / TPM
逐模型
详见各模型页
触发限速时返回 RATE_LIMITED，建议结合指数退避重试。