快速接入说明

欢迎使用 ChatFire API——统一的 OpenAI 兼容接口，聚合 OpenAI、Claude、Gemini、Qwen、火山引擎、DeepSeek、MiniMax、Kimi、智谱、xAI、Vidu 等 10+ 厂商、100+ 模型。

一、基本信息

项	值
Base URL	`https://api.chatfire.site`
鉴权	请求头 `Authorization: Bearer {API_KEY}`
获取 API Key	登录 ChatFire 平台 →「API Keys」页创建（sk- 开头，仅创建时完整展示一次）
模型列表	`GET /v1/models` 返回当前可用模型

本项目的 Apifox 环境已配置好：选择「正式环境」即可直接调试，Key 填在环境变量 API_KEY 中。

二、三步完成首次调用

以对话模型为例（OpenAI chat.completion 结构）：

响应（节选）：

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "choices": [
    { "index": 0, "message": { "role": "assistant", "content": "……" }, "finish_reason": "stop" }
  ],
  "usage": { "prompt_tokens": 28, "completion_tokens": 36, "total_tokens": 64 }
}

三、流式输出

请求体加 "stream": true，响应切换为 SSE（text/event-stream），逐行推送 data: {...}，以 data: [DONE] 结束：

四、图像生成（同步）

响应：{"created": ..., "data": [{"url": "https://..."}]}

五、视频生成（异步两步）

视频类模型均为异步任务：先创建任务拿到任务 ID，再轮询查询接口取结果。

第 1 步 · 创建任务（以火山 Seedance 为例）：

返回 {"id": "cgt-xxx"}。

第 2 步 · 轮询查询：

status 变为 succeeded 后从 content.video_url 取视频地址。各厂商查询路径见下方目录索引（每家都有「视频任务查询」接口）。

Qwen（DashScope）系列视频接口创建时需加请求头 X-DashScope-Async: enable。

六、厂商目录索引

目录	能力	协议格式
OpenAI	对话（Chat/Responses）、图像生成、图像编辑	OpenAI 兼容
Anthropic Claude	对话	Messages 原生
Google Gemini	对话、图像	generateContent 原生
阿里 Qwen	对话、图像、视频	OpenAI 兼容 + DashScope 原生
火山引擎	对话、图像、视频	OpenAI 兼容 + Ark 原生
DeepSeek / MiniMax / Moonshot Kimi / 智谱 / 小米	对话（部分含视频）	OpenAI 兼容（各家有差异字段）
xAI	对话、图像、视频	OpenAI 兼容
Vidu	视频（文生/图生/首尾帧/参考生）	Vidu 原生

七、错误处理

统一错误结构：

{ "error": { "message": "...", "type": "invalid_request_error", "code": "..." } }

状态码	含义
401	API Key 无效或缺失
402	余额不足
429	触发限流
5xx	上游厂商异常（平台会自动切换渠道重试）

八、更多

完整模型与定价：ChatFire 平台「模型库」

用量与账单：平台「用量信息」「交易记录」

余额查询：GET /v1/chatfire/balance

快速接入说明

一、基本信息#

二、三步完成首次调用#

三、流式输出#

四、图像生成（同步）#

五、视频生成（异步两步）#

六、厂商目录索引#

七、错误处理#

八、更多#