快速开始
- 01
创建密钥
在控制台新建 API 密钥，复制以 sk- 开头的完整值。
- 02
配置环境变量
将密钥保存到环境变量。
export NINEFIRE_API_KEY=sk-nf-xxxxxx - 03
指向网关
将 base_url 设为下方地址。在首页选择对话模型，用模型代码替换 YOUR_MODEL_CODE。
OpenAI Base URL
https://api.ninefireai.cn/v1接入文档
文档目录
OpenAI 兼容（curl）
request.sh
curl https://api.ninefireai.cn/v1/chat/completions \
-H "Authorization: Bearer $NINEFIRE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_MODEL_CODE",
"messages": [{ "role": "user", "content": "请简要介绍你的能力" }]
}'Anthropic 兼容（Python）
Anthropic SDK 会自动追加 /v1/messages，请使用示例中的 base_url。
main.py
import os
from anthropic import Anthropic
client = Anthropic(
api_key=os.environ["NINEFIRE_API_KEY"],
base_url="https://api.ninefireai.cn"
)
msg = client.messages.create(
model="YOUR_MODEL_CODE",
max_tokens=512,
messages=[{"role": "user", "content": "解释 RAG 的核心思想"}]
)
print(msg.content[0].text)OpenAI 兼容（Node.js）
index.ts
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: process.env.NINEFIRE_API_KEY,
baseURL: 'https://api.ninefireai.cn/v1'
});
const res = await client.chat.completions.create({
model: 'YOUR_MODEL_CODE',
messages: [{ role: 'user', content: '请简要介绍你的能力' }]
});
console.log(res.choices[0].message.content);错误码
请求失败时，检查 HTTP 状态码及响应中的 code、message 字段。
UNAUTHORIZED- 密钥失效或未携带，检查 Authorization 头。
RATE_LIMITED- 请求超过限速，降低并发后重试。
INSUFFICIENT_BALANCE- 可用余额不足。
UPSTREAM_ERROR- 模型服务请求失败，请根据返回信息检查请求或稍后重试。
SERVICE_UNAVAILABLE- 服务暂时不可用，请稍后重试。
FORBIDDEN- 当前账户无权访问该资源。
速率限制
请求会按来源 IP、账户或 API 密钥限制频率；模型还可能设置 RPM、TPM 等限额，以当前配置和接口返回为准。
收到 RATE_LIMITED 时，降低并发并增加重试间隔。需要调整调用上限时，可联系支持确认。