AI Gateway Platform

快速开始

三步完成接入：注册账户 → 获取 API Key → 发起请求。

注册并充值

前往用户平台注册账户，进入「账单充值」页面完成充值，余额以人民币计算。

创建 API Key

进入「API 密钥」页面，点击「新建密钥」，复制生成的 Key（仅显示一次）。

发起第一条请求

将 API Key 放入请求头，接口地址与 OpenAI 完全兼容，替换 base_url 即可。

bash

curl https://api.model.furongkeji.top/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role": "user", "content": "你好"}]
  }'

认证方式

所有接口均通过 HTTP 请求头传入 Bearer Token 进行认证。

http

Authorization: Bearer YOUR_API_KEY

安全提示：API Key 请妥善保管，不要将其写入前端代码或提交至代码仓库。如 Key 泄露，请立即在控制台删除并重新生成。

文本对话

与 OpenAI Chat Completions API 完全兼容，支持流式输出。

POST/v1/chat/completions

请求参数

参数	类型	必填	说明
`model`	string	是	模型 ID，参见下方模型列表
`messages`	array	是	对话历史，每条包含 role 和 content
`stream`	boolean	否	是否开启流式输出，默认 false
`temperature`	number	否	采样温度，范围 0–2，默认 1
`max_tokens`	integer	否	最大生成 token 数
`top_p`	number	否	核采样概率，与 temperature 二选一
`stop`	string \| array	否	停止生成的字符串或数组

流式输出示例

bash

curl https://api.model.furongkeji.top/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "deepseek-chat",
    "stream": true,
    "messages": [
      {"role": "system", "content": "你是一个助手"},
      {"role": "user", "content": "用三句话介绍量子计算"}
    ]
  }'

图像生成

文生图接口，支持多种分辨率与风格。

POST/v1/images/generations

请求参数

参数	类型	必填	说明
`model`	string	是	图像模型 ID，如 qwen-image、doubao-seedream-3.0
`prompt`	string	是	图像描述，建议使用英文以获得最佳效果
`n`	integer	否	生成数量，默认 1
`size`	string	否	分辨率，如 1024x1024、1024x768

python

response = client.images.generate(
    model="qwen-image",
    prompt="A futuristic city skyline at night, cyberpunk style",
    size="1024x1024",
    n=1,
)
print(response.data[0].url)

语音合成

将文字转换为自然语音，支持多种音色与格式。

POST/v1/audio/speech

请求参数

参数	类型	必填	说明
`model`	string	是	TTS 模型 ID，如 qwen-tts、doubao-tts
`input`	string	是	需要合成的文本内容
`voice`	string	否	音色名称，不同模型支持的音色不同
`format`	string	否	输出格式，支持 mp3、wav、pcm，默认 mp3

python

response = client.audio.speech.create(
    model="qwen-tts",
    input="欢迎使用 AI Gateway 语音合成服务",
    voice="longxiaochun",
)
with open("output.mp3", "wb") as f:
    f.write(response.content)

模型列表

平台当前已接入的所有模型，均通过统一 OpenAI 兼容接口调用。

模型 ID	服务商	类型	上下文	说明
`deepseek-chat`	DeepSeek	文本对话	64K	高性价比旗舰模型
`deepseek-reasoner`	DeepSeek	推理	64K	强推理，支持思维链
`qwen-plus`	通义千问	文本对话	128K	综合能力强
`qwen-turbo`	通义千问	文本对话	128K	低延迟，适合实时场景
`glm-4-flash`	智谱	文本对话	128K	轻量快速
`moonshot-v1-8k`	Moonshot	文本对话	8K	中文理解优秀
`qwen-image`	通义千问	图像生成	—	文生图
`doubao-seedream-3.0`	字节豆包	图像生成	—	艺术风格丰富
`qwen-tts`	通义千问	语音合成	—	自然语调
`doubao-tts`	字节豆包	语音合成	—	多音色支持

计费说明

按实际使用的 Token 数量计费，预扣后结算，无月租或最低消费。

①

预扣款

请求发起时根据预估 Token 数扣除余额，确保余额充足。

②

实时结算

请求完成后按实际消耗 Token 精确结算，多退少补。

③

失败退款

如上游服务异常导致请求失败，预扣金额全额返还。

计费公式：费用 = (缓存命中输入 Token × 缓存命中单价 + 未命中输入 Token × 输入单价 + 输出 Token × 输出单价) × 倍率 ÷ 1,000,000，单位 CNY。

错误码

所有接口遵循标准 HTTP 状态码，错误响应体格式如下。

json

{
  "error": {
    "code": 401,
    "message": "Invalid API key",
    "type": "authentication_error"
  }
}

HTTP 状态码	错误名称	常见原因
`401`	Unauthorized	API Key 无效或未传入 Authorization 头
`402`	Payment Required	账户余额不足，请充值后重试
`429`	Too Many Requests	超出当前 API Key 的每分钟请求限制
`400`	Bad Request	请求参数格式错误，如模型名称不存在
`404`	Not Found	请求的模型未在系统中配置
`503`	Service Unavailable	当前所有上游渠道均不可用，请稍后重试
`500`	Internal Server Error	系统内部异常，请联系管理员