接口文档

OpenAI 兼容接口的接入说明、请求参数、计费规则与错误码，可直接复制示例代码使用。

快速开始

三步完成接入：注册账户 → 获取 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 请求头传入 API Key 进行认证，两种写法任选其一。

http

Authorization: Bearer YOUR_API_KEY
# 或（Anthropic 客户端的写法）
x-api-key: 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	否	停止生成的字符串或数组
`tools`	array	否	工具（Function Call）定义，格式与 OpenAI 一致
`tool_choice`	string \| object	否	工具选择策略：auto / none / required / 指定函数

流式输出示例

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": "用三句话介绍量子计算"}
    ]
  }'

Anthropic 格式（Claude Code）

兼容 Anthropic Messages API。Claude Code、Cline、Cherry Studio 等客户端可直接接入，平台上所有文本模型均可使用，支持流式输出、工具调用与思考内容。

POST/v1/messages

接入 Claude Code

设置以下环境变量后直接运行 claude。模型名填写模型列表中的调用名。

bash

export ANTHROPIC_BASE_URL="https://api.model.furongkeji.top"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_MODEL="deepseek-chat"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek-chat"
claude

注意：Base URL 不要带 /v1，客户端会自动拼接 /v1/messages。Claude Code 每次请求会携带约 2 万 tokens 的系统提示词和工具定义，建议选择支持缓存的模型以降低成本。

直接调用

bash

curl https://api.model.furongkeji.top/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "deepseek-chat",
    "max_tokens": 1024,
    "system": "你是一个助手",
    "messages": [
      {"role": "user", "content": "用三句话介绍量子计算"}
    ]
  }'

支持情况

参数	类型	必填	说明
`system`	string \| array	否	系统提示词
`messages`	array	是	对话历史，支持文本、图片、tool_use、tool_result
`max_tokens`	integer	否	最大生成 token 数
`stream`	boolean	否	流式输出（SSE 事件格式与 Anthropic 一致）
`tools`	array	否	自定义工具；Anthropic 服务端工具（如 web_search）不支持，会被忽略
`tool_choice`	object	否	auto / any / tool / none
`temperature`	number	否	采样温度
`stop_sequences`	array	否	停止序列

Responses 格式（Codex）

兼容 OpenAI Responses API。Codex CLI、OpenAI Agents SDK 等客户端可直接接入，平台上所有文本模型均可使用，支持流式输出、工具调用（含 Codex 的自定义工具）与思考摘要。

POST/v1/responses

接入 Codex CLI

在 ~/.codex/config.toml 中添加以下配置，然后设置环境变量 XINGQIAO_API_KEY 为你的 API Key。

toml

model = "deepseek-chat"
model_provider = "xingqiao"

[model_providers.xingqiao]
name = "星桥AI"
base_url = "https://api.model.furongkeji.top/v1"
env_key = "XINGQIAO_API_KEY"
wire_api = "responses"

注意：平台不保存会话，不支持 previous_response_id，每次请求需在 input 中携带完整上下文（Codex 默认即如此）。OpenAI 托管工具（web_search、file_search、code_interpreter 等）不支持，会被忽略。

直接调用

python

from openai import OpenAI

client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.model.furongkeji.top/v1")

response = client.responses.create(
    model="deepseek-chat",
    instructions="你是一个助手",
    input="用三句话介绍量子计算",
)
print(response.output_text)

支持情况

参数	类型	必填	说明
`input`	string \| array	是	输入内容；数组支持 message、function_call、function_call_output、reasoning 等条目
`instructions`	string	否	系统指令
`stream`	boolean	否	流式输出（事件格式与 OpenAI 一致）
`max_output_tokens`	integer	否	最大输出 token 数（含思考内容），用尽时返回 status=incomplete
`tools`	array	否	function 与 custom 类型工具
`tool_choice`	string \| object	否	auto / none / required / 指定函数
`text.format`	object	否	json_schema / json_object 结构化输出
`temperature`	number	否	采样温度

图像生成

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

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语音合成服务",
    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 / x-api-key 请求头
`402`	Payment Required	账户余额不足，请充值后重试
`429`	Too Many Requests	超出当前 API Key 的每分钟请求限制
`400`	Bad Request	请求参数格式错误，如模型名称不存在
`404`	Not Found	请求的模型未在系统中配置
`503`	Service Unavailable	当前所有上游渠道均不可用，请稍后重试
`500`	Internal Server Error	系统内部异常，请联系管理员