嗦龙 AI API
一个 API 调用所有模型:文本、图像、视频、音频。Base URL:https://suolong.hiqzcar.com
快速开始
- 在控制台创建 API Key。Key 绑定能力分组:画图选画图分组、视频选视频分组、配音选豆包语音分组——跨组调用返回 403。
- 先查询你的 Key 能看到哪些模型:
# 查询当前 Key 的模型列表 curl --fail-with-body -sS --max-time 600 \ --request GET \ --url https://suolong.hiqzcar.com/v1/models \ -H "Authorization: Bearer $HEIHUZI_API_KEY"
不同分组的 Key 返回的模型列表不同。/v1/models 是权限探测器,以它的结果为准。
认证
以下三种请求头等效,任选其一。认证信息只放请求头,不要放 URL 参数(?key= 会返回 400 api_key_in_query_deprecated)。
| 请求头 | 内容 | 适用 |
|---|---|---|
Authorization | Bearer <API Key> | OpenAI 系 / Claude / 视频 |
x-api-key | <API Key> | Anthropic SDK 习惯用法 |
x-goog-api-key | <API Key> | Gemini 原生接口 |
X-Api-Key | <API Key> | 豆包语音 TTS / ASR |
模型总览
| 能力 | 接口 | 模型 ID |
|---|---|---|
| 文本(Responses) | /v1/responses | gpt-5.5 · gpt-5.6-luna/sol/terra · gpt-6-astra · gpt-6.2-astra · gpt-6.2-sol |
| 文本(Chat) | /v1/chat/completions | gpt-5.5 |
| Claude | /v1/messages | claude-sonnet-5 · claude-opus-5 · claude-haiku-4-5-20251001 |
| Gemini | /v1beta/models/{id}:generateContent | gemini-3.8-flash · gemini-4-argon/carbon/hydrogen |
| DeepSeek | 三种协议均可 | deepseek-flash · deepseek-v4-pro |
| 图像 | /v1/images/generations · /v1/images/edits | gpt-image-2.6-flare/sunburst · gpt-image-2.5-flare/sunburst · gpt-image-2 |
| 图像(Gemini 系) | /v1beta/models/...:generateContent | gemini-nano-banana-2.1 |
| 视频 | /api/v3/contents/generations/tasks | doubao-seedance-2-0/2-0-fast/2-0-mini/2-5 |
| 视频 | /v2/video_generation | MiniMax-H3-Max · MiniMax-H3 |
| 配音 | /api/v3/tts/create | seed-audio-1.0 |
| 语音识别 | /api/v3/auc/bigmodel/submit | volc.seedasr.auc |
图像接口省略 model 时默认 gpt-image-2.5-flare;要用 2.6 必须明确填写。Nano Banana 旧 ID gemini-3.1-flash-image 仍可调用并自动转到 2.1。
Responses POST /v1/responses
# gpt-6.2-sol 文本 curl --fail-with-body -sS --max-time 600 \ --request POST \ --url https://suolong.hiqzcar.com/v1/responses \ -H "Authorization: Bearer $HEIHUZI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-6.2-sol", "input": [{"role": "user", "content": "Reply with exactly API_OK."}] }'
| 参数 | 说明 |
|---|---|
model* | 完整模型 ID,必填 |
input* | 消息数组,必须数组(gpt-5.5 字符串 input 实测返回 400) |
stream | true 返回 SSE:response.output_text.delta → response.completed;收到 response.failed 按失败处理,不能只看 HTTP 200 |
tools | 自定义函数(已验证 add 两轮闭环);DeepSeek 可加 {"type":"web_search"} 联网搜索(按次收费) |
text.format | 结构化输出 json_schema + strict:true(6.2 已验证) |
已验证场景:文本、流式、图片理解(input_image Data URL)、客户端多轮(保留完整 output 追加新输入)、函数调用闭环、JSON Schema 结构化输出。读文本:非流式取 output[] 中 type=message 的 content[].text。
Chat Completions POST /v1/chat/completions
gpt-5.5 的非流式与流式均已验证,标准 OpenAI messages 格式:
{
"model": "gpt-5.5",
"messages": [{"role": "user", "content": "Reply with exactly API_OK."}]
}Claude Messages POST /v1/messages
{
"model": "claude-sonnet-5",
"max_tokens": 256,
"messages": [{"role": "user", "content": "Reply with exactly API_OK."}]
}| 参数 | 说明 |
|---|---|
model* | claude-sonnet-5 / claude-opus-5 / claude-haiku-4-5-20251001;省略返回 400 |
max_tokens | 示例填 256 |
stream | true 返回 SSE:message_start → content_block_delta(文字在 delta.text)→ message_delta → message_stop |
响应从 content[] 的 type:"text" 读取;usage 含 cache_creation/cache_read tokens。
Gemini 系列
模型 ID 放在 URL 路径里,鉴权用 x-goog-api-key 头。⚠️ 当前 Gemini 资源紧张,常遇 429(TPM 配额)、502(上游拒绝)、超时——请求格式已验证可用,资源错误不代表模型能力。
| 用途 | 请求地址 |
|---|---|
| 普通文本 | POST /v1beta/models/gemini-4-hydrogen:generateContent |
| 流式文本 | POST /v1beta/models/gemini-4-hydrogen:streamGenerateContent?alt=sse |
{
"contents": [{"role": "user", "parts": [{"text": "Reply with exactly API_OK."}]}],
"generationConfig": {"maxOutputTokens": 4096}
}读文本:candidates[].content.parts[] 中非思考部分的 text;检查 modelVersion 与请求模型一致、finishReason: STOP。
DeepSeek
模型 deepseek-flash、deepseek-v4-pro,三种协议都已实测通过:
| 客户端 | Base URL | 路径 |
|---|---|---|
| OpenAI SDK | https://suolong.hiqzcar.com/v1 | /v1/chat/completions 或 /v1/responses |
| Anthropic SDK | https://suolong.hiqzcar.com | /v1/messages(用 x-api-key 头) |
已验证:三种协议普通/流式、JSON、工具调用闭环、Responses 多轮、单图理解、联网搜索(Responses 加 {"type":"web_search"},先搜再答并附来源链接,按次收费)。
图像生成 POST /v1/images/generations
# 生成一张 1024×1024 PNG curl --fail-with-body -sS --max-time 600 \ --request POST \ --url https://suolong.hiqzcar.com/v1/images/generations \ -H "Authorization: Bearer $HEIHUZI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-image-2.6-flare", "prompt": "A simple blue ceramic cup on a white background.", "n": 1, "size": "1024x1024", "quality": "low", "output_format": "png" }'
| 参数 | 说明(均为正式环境实测取值) |
|---|---|
model* | 模型 ID,必填 |
prompt* | 画面描述,必填 |
n | 张数,1–10,默认 1 |
size | 1024x1024 / 1536x1024 / 1024x1536 / 2048x2048 / 2880x2880 / 3840x2160 / auto;宽高必须是 16 的倍数 |
quality | low / medium / high / xhigh / max / auto |
output_format | png / jpeg / webp / gif |
background | transparent / opaque / auto(透明需配 png) |
stream | true 返回 SSE;完成事件 image_generation.completed,预览事件 image_generation.partial_image;GIF 不支持流式 |
partial_images | 流式预览张数 1–3,实际可能更少 |
frame_count | GIF 帧数 2–16,默认 9(仅 output_format=gif) |
frame_duration_ms | GIF 每帧毫秒 ≥20,默认 200 |
complexity | 构思程度 low/medium/high,不影响用量 |
moderation | 审核档位 low / auto |
响应 data[].b64_json 是图片 base64;usage 含 input/output/total tokens。1024×1024 low:2.6 输出约 824 tokens,2.5 约 196 tokens。
图像编辑 POST /v1/images/edits
三种参考图输入方式:
| 方式 | 字段 |
|---|---|
| multipart 上传 | 文件字段 image,多张重复 image[] |
| JSON Data URL | images: [{"image_url": "data:image/png;base64,..."}] |
| JSON 图片地址 | images: [{"image_url": "https://..."}](Sunburst 验证) |
参数与生成接口一致;流式完成事件为 image_edit.completed。参考图计入输入用量(1024×1024 参考图 ≈ 1024 图片输入 tokens,按张数重复计)。file_id 不支持,会返回 400。
Nano Banana 2.1(Gemini 原生画图)
模型 ID gemini-nano-banana-2.1,走 Gemini 原生接口,鉴权 x-goog-api-key:
| 用途 | 请求地址 |
|---|---|
| 生成 / 编辑 | POST /v1beta/models/gemini-nano-banana-2.1:generateContent |
| 流式 | POST /v1beta/models/gemini-nano-banana-2.1:streamGenerateContent?alt=sse(图片在一个事件里完整返回) |
支持 14 种画面比例、1K/2K/4K 清晰度、思考档位;编辑时参考图放在 parts 里(单图、两张、14 张均验证过)。旧 ID gemini-3.1-flash-image 自动转到 2.1。
视频 Seedance POST /api/v3/contents/generations/tasks
异步任务:创建返回 id,轮询 GET 同路径/{id} 拿成片链接,DELETE 同路径/{id} 删除已结束任务。需「Seedance 视频」分组 Key。
| 模型 ID | 清晰度 | 时长 |
|---|---|---|
doubao-seedance-2-0-260128 | 480p / 720p / 1080p / 4k | 4–15 秒 |
doubao-seedance-2-0-fast-260128 | 480p / 720p | 4–15 秒 |
doubao-seedance-2-0-mini-260615 | 480p / 720p | 4–15 秒 |
doubao-seedance-2-5-260628 | 480p / 720p / 1080p | 4–30 秒 |
{
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "一只手从枝头摘下沾着露水的红苹果,镜头缓慢推近"},
{"type": "image_url", "image_url": {"url": "https://.../first.jpg"}, "role": "first_frame"}
],
"resolution": "480p",
"ratio": "adaptive",
"duration": 5
}| 参数 | 说明 |
|---|---|
content* | 文字必填;首帧 first_frame、尾帧 last_frame、参考图 reference_image(2.0 系 ≤9 张 / 2.5 ≤30 张)、参考视频 reference_video(≤3 个合计 ≤15 秒 / ≤10 个 ≤30 秒)——首帧/首尾帧与参考素材互斥 |
ratio | 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive;带首帧时建议 adaptive(2.5 强制) |
duration | 秒,整数;-1 由模型自动决定,按实际时长计费 |
图片可填 https 链接或 data:image/png;base64,...;参考图可用自建素材 asset://asset-xxx(素材管理接口同域)。⚠️ 含真人人脸的图片/视频会被拒审(400,冻结余额退回)。未完成视频任务(Seedance + MiniMax 合计)最多 5 个,超出 429。
视频 MiniMax POST /v2/video_generation
异步任务:创建返回 task_id,轮询 GET /v2/query/video_generation/{task_id},删除 DELETE /v2/video_generation/{task_id}。需「MiniMax 视频」分组 Key。
| 模型 | 清晰度 | 时长 |
|---|---|---|
MiniMax-H3-Max | 480P / 768P | 5–15 秒 |
MiniMax-H3 | 768P / 2K | 4–15 秒 |
content 有且只有一项文字;首帧/尾帧与参考图(≤9)/参考视频(≤3 合计 ≤15 秒)互斥;纯文字必须填 ratio。参考图 H3-Max 前 2 张 / H3 前 5 张免费,超出按张计费。
配音 TTS POST /api/v3/tts/create
同步返回,一次请求直接拿音频。模型固定 seed-audio-1.0,鉴权用 X-Api-Key 头,需「豆包语音」分组 Key。
{
"model": "seed-audio-1.0",
"text_prompt": "@音频1:你好,今天阳光很好。",
"references": [{"speaker": "zh_female_vv_uranus_bigtts"}],
"audio_config": {"format": "mp3", "sample_rate": 24000, "enable_subtitle": true}
}| 参数 | 说明 |
|---|---|
text_prompt* | ≤3000 字符;@音频1/2/3 指定用 references 里第几个声音 |
references | 预设音色 speaker / 参考音频 audio_data·audio_url(声音克隆)/ 参考图;声音参考 ≤3 个,参考图只能 1 张且不与声音混用 |
audio_config | format: wav/mp3/pcm/ogg_opus;speech_rate -50~100;pitch_rate -12~12;enable_subtitle 返回逐字时间字幕 |
响应:audio(base64)、url(限时下载链接)、duration、subtitle(逐字毫秒时间)。计费 1 元/分钟按 original_duration(调慢语速不多扣)。
语音识别 ASR POST /api/v3/auc/bigmodel/submit
异步任务:提交后拿同一个 X-Api-Request-Id 查 POST /api/v3/auc/bigmodel/query。请求头固定 X-Api-Resource-Id: volc.seedasr.auc、X-Api-Sequence: -1,任务编号自己生成 UUID(同账号不可重复)。
{
"user": {"uid": "my-app"},
"audio": {"url": "https://.../voice.mp3", "format": "mp3"},
"request": {"model_name": "bigmodel", "enable_itn": true, "enable_punc": true}
}提交成功看响应头 X-Api-Status-Code: 20000000。计费 0.8 元/小时按实际时长(提交先冻结 1 小时费用,多退)。返回全文、分句、逐字时间。
计费机制
| 产品 | 计费方式 |
|---|---|
| 文本 / 图像 | 按 tokens(usage 字段返回) |
| 视频(异步) | 提交时按最大可能用量冻结余额,完成按实际用量结算,失败/拒审/超时全额退回 |
| 配音 TTS | 1 元/分钟,按原始时长 original_duration,保留 8 位小数 |
| 语音识别 | 0.8 元/小时,提交先冻结 1 小时,完成按实际时长多退 |
| 联网搜索 | DeepSeek web_search 按次收费 |
实际价格 = 官方价 × 分组倍率(如 ChatGPT 0.8 折、ClaudeCode 2 折),以「模型广场」和用量明细为准。
错误码
| 状态码 | 常见原因 | 处理 |
|---|---|---|
| 400 | Key 放 URL 参数;非法 JSON;缺 prompt;尺寸非 16 倍数;n>10;input 不是数组;含真人素材(InputImageSensitiveContentDetected) | 按接口说明修正请求 |
| 401 | 未提供或无效 Key | 检查 Key 与请求头 |
| 402 | 余额不足冻结本次费用(附 required/available) | 先充值 |
| 403 | Key 所在分组无该能力(PermissionDenied) | 换对应分组 Key |
| 404 | 路径错误;模型不存在;素材 ID 不存在 | 核对路径与 /v1/models |
| 429 | 并发超限 gateway_concurrency_limit;视频任务超 5 个 TooManyActiveTasks | 降并发 / 等任务完成 |
| 502/503 | 上游拒绝 / 暂时连不上(UpstreamOutcomeUnknown 时不要立即重试) | 稍后重试,冻结会自动结算或退回 |
错误结构:{"error": {"message", "type", "param", "code"}}。排查请保留状态码、error.type 与响应头 X-Client-Request-Id。
在线调试
用页面已保存的 API 配置真实调用(在首页齿轮里设置,或下方直接填 Key)。更多能力调试去 创作台。