API 使用文档 一套 Key 兼容 OpenAI / Anthropic / Responses / Gemini 四大接口

快速开始

慧朗AI（AI·API） 一套 API Key，同时兼容 OpenAI、Anthropic、Responses、Gemini 四种主流接口协议。无论您用 OpenAI SDK、Claude SDK、Codex SDK、还是 Gemini SDK，都能直接接入，共用同一账户余额与模型。

API 地址：https://api-aiapi.cn

模型 ID：在控制台「模型」页查看，如 gpt-4o、DeepSeek-V4.1-Flash、claude-sonnet-4

cURL 示例

# 对话补全
curl https://api-aiapi.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "你好！"}],
    "max_tokens": 1000
  }'

Python 示例

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的APIKey",
    base_url="https://api-aiapi.cn/v1"
)

response = client.chat.completions.create(
    model="DeepSeek-V4.1-Flash",
    messages=[{"role": "user", "content": "你好！"}]
)
print(response.choices[0].message.content)

Node.js 示例

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-你的APIKey',
  baseURL: 'https://api-aiapi.cn/v1'
});

const response = await client.chat.completions.create({
  model: 'gpt-4o-mini',
  messages: [{ role: 'user', content: '你好！' }]
});
console.log(response.choices[0].message.content);

多协议支持

同一把 sk-你的APIKey 可同时用于以下四种协议，无需单独申请，调用均正常计费到同一余额。

四种协议的聊天文本均支持流式（stream）与非流式调用，Claude/Gemini 官方 SDK 的流式对话可直接使用。

1. OpenAI 协议（默认）

# OpenAI 格式
curl https://api-aiapi.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o-mini", "messages": [{"role": "user", "content": "你好"}]}'

2. Anthropic / Claude 协议

# Anthropic 格式
curl https://api-aiapi.cn/v1/messages \
  -H "x-api-key: sk-你的APIKey" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o-mini", "max_tokens": 500, "messages": [{"role": "user", "content": "你好"}]}'

3. Gemini 协议

# Gemini 格式
curl https://api-aiapi.cn/v1beta/models/gpt-4o-mini:generateContent \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{"contents": [{"role": "user", "parts": [{"text": "你好"}]}]}'

说明：四种协议底层共享同一套模型与计费。模型名不用区分协议，一个 sk- Key 全平台通用。

可用模型

完整模型列表请查看 控制台 →「模型」页

图像生成

与 OpenAI 图像接口兼容，端点 POST /v1/images/generations。按张计费，调用前预扣、失败自动返还。

curl https://api-aiapi.cn/v1/images/generations \
  -H "Authorization: Bearer ***你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只戴墨镜的橘猫，赛博朋克风格",
    "n": 1,
    "size": "1024x1024"
  }'

请求参数

响应：返回 OpenAI 标准格式，图片在 data[0].url（外链模型会自动转 data: base64 URL，第三方客户端天然兼容）。

图像模型

视频生成

端点 POST /v1/videos/generations。按次 / 按分辨率与时长计费，调用前预扣、失败自动返还。

curl https://api-aiapi.cn/v1/videos/generations \
  -H "Authorization: Bearer ***你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0",
    "prompt": "一只橘猫在窗台晒太阳，镜头缓慢推近",
    "resolution": "720p",
    "duration": 5
  }'

请求参数

响应：{ id, object:"video", status, data:[{ url }] }。异步任务可用 GET /v1/videos/{id}/content 或 GET /v1/videos/tasks/{id} 查询结果。

视频模型与价格（单位：元/次）

※ 表格为常用档位，完整分档（10s/15s 等）以 模型价格页 为准；一次生成按「分辨率 × 时长」档位单价计费。

音乐生成

端点 POST /v1/music_generation。按首计费，返回音频二进制（audio/mpeg）。

curl https://api-aiapi.cn/v1/music_generation \
  -H "Authorization: Bearer ***你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-Music",
    "input": "轻快的夏日电子流行，适合短视频",
    "instrumental": true
  }' -o music.mp3

参数：input 或 prompt（音乐描述，必填）、lyrics（歌词，可选）、instrumental（默认 true 纯音乐；false 则带人声、无歌词时自动生成歌词）。

语音合成与识别

语音合成（TTS）：端点 POST /v1/audio/speech，返回音频二进制（wav / mp3）。input 为文本，voice 指定发音人，可选 speed / vol / pitch。按次计费。

curl https://api-aiapi.cn/v1/audio/speech \
  -H "Authorization: Bearer ***你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{"model":"xf-tts","input":"你好，欢迎使用慧朗AI","voice":"x4_lingfei_oral"}' \
  -o speech.wav

语音识别（ASR）：端点 POST /v1/audio/transcriptions（OpenAI Whisper 兼容，multipart 上传音频文件），按音频时长计费。

※ 计费口径：图像/视频/音乐/语音均为「按用量计费」（按张 / 按次 / 按秒或分钟），与文本的按 Token 计费相互独立。所有媒体调用调用前预扣、生成失败自动全额返还（fail → refund），不会出现扣费不出片。

计费说明

按 Token 精确计费，输入和输出分别计价：

• 输入 Token：模型读取您发送的内容
• 输出 Token：模型生成回复的内容
• 计费公式：费用 = 输入Token数 × 输入单价 + 输出Token数 × 输出单价
• 余额不足时调用失败，请保持账户有足够余额

详细价格请查看 模型价格。

关于 gpt-5.5 的两个档位

同一模型提供两个线路，按使用场景选择，二者接口格式完全一致，改 model 名即可切换：

• gpt-5.5——官方接口，稳定性和响应速度为先，适合线上正式业务；¥23.8（输入）/ ¥142.8（输出）每百万 token
• gpt-5.5-pool——号池特价线路，同一模型，代价显著降低（约为标准档 2.9 折），适合对成本敏感、可容忍高峰时偶发排队的大批量场景；¥6.8（输入）/ ¥40.8（输出）每百万 token

特价线路为共享资源，高峰时段偶尔可能出现短暂排队或上游繁忙（返回 429），建议客户端做好重试；若为关键业务，建议使用标准档或以标准档作备用。

常见问题

API Key 怎么获取？

在 控制台 注册账号后，进入 Token 管理页面即可创建 API Key。

支持哪些接口？

同时支持 OpenAI（/v1/chat/completions）、Anthropic（/v1/messages）、Responses（/v1/responses）、Gemini（/v1beta/...:generateContent）四种文本协议；另提供 图像生成（/v1/images/generations）、视频生成（/v1/videos/generations）、音乐生成（/v1/music_generation）、语音合成/识别（/v1/audio/speech、/v1/audio/transcriptions）。全部共用一把 API Key。四种文本协议的聊天均支持流式（stream）与非流式调用。

支持企业开票吗？

支持。企业客户可对公转账并开具增值税发票。详情联系在线客服。

充值的钱没用完能退吗？

充值金额长期有效，无时间限制。未使用余额可根据平台政策申请退款。