火鹰引擎API Docs

API 开发文档

火鹰引擎 (FigoAPI) 提供统一的大模型 API 接入服务，完全兼容 OpenAI 格式。只需更换 Base URL 即可无缝接入 20+ 主流大模型。

快速开始

1. 获取 API Key

注册账号后在控制台创建 API Key

2. 设置 Base URL

https://www.figoapi.cn/v1

3. 发起请求

使用 OpenAI SDK 或 HTTP 请求调用

所有请求需在 Header 中携带 Authorization: Bearer YOUR_API_KEY

API 端点列表

方法	路径	描述
POST	/v1/chat/completions	创建聊天补全 — 最常用的接口
POST	/v1/completions	创建文本补全
GET	/v1/models	列出所有可用模型
POST	/v1/embeddings	创建文本向量嵌入
POST	/v1/images/generations	AI 图片生成
POST	/v1/audio/transcriptions	语音转文字
POST	/v1/audio/speech	文字转语音

代码示例

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://www.figoapi.cn/v1"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello!"}
    ]
)
print(response.choices[0].message.content)

请求参数说明

参数	类型	必填	说明
model	string	是	模型名称，如 gpt-4o、claude-3-5-sonnet
messages	array	是	消息数组，每条包含 role 和 content
temperature	number	否	采样温度，0-2，默认 1
max_tokens	integer	否	最大输出 token 数
stream	boolean	否	是否启用流式输出
top_p	number	否	核采样参数，0-1

错误码说明

状态码	说明	解决方案
400	请求参数错误	检查请求体格式
401	认证失败	检查 API Key 是否正确
403	权限不足	检查令牌权限或 IP 白名单
429	请求频率超限	降低请求频率或升级套餐
500	服务器内部错误	稍后重试或联系管理员
503	服务不可用	上游渠道异常，系统将自动切换