嗦龙 AI API

一个 API 调用所有模型:文本、图像、视频、音频。Base URL:https://suolong.hiqzcar.com

快速开始

  1. 在控制台创建 API Key。Key 绑定能力分组:画图选画图分组、视频选视频分组、配音选豆包语音分组——跨组调用返回 403。
  2. 先查询你的 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)。

请求头内容适用
AuthorizationBearer <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/responsesgpt-5.5 · gpt-5.6-luna/sol/terra · gpt-6-astra · gpt-6.2-astra · gpt-6.2-sol
文本(Chat)/v1/chat/completionsgpt-5.5
Claude/v1/messagesclaude-sonnet-5 · claude-opus-5 · claude-haiku-4-5-20251001
Gemini/v1beta/models/{id}:generateContentgemini-3.8-flash · gemini-4-argon/carbon/hydrogen
DeepSeek三种协议均可deepseek-flash · deepseek-v4-pro
图像/v1/images/generations · /v1/images/editsgpt-image-2.6-flare/sunburst · gpt-image-2.5-flare/sunburst · gpt-image-2
图像(Gemini 系)/v1beta/models/...:generateContentgemini-nano-banana-2.1
视频/api/v3/contents/generations/tasksdoubao-seedance-2-0/2-0-fast/2-0-mini/2-5
视频/v2/video_generationMiniMax-H3-Max · MiniMax-H3
配音/api/v3/tts/createseed-audio-1.0
语音识别/api/v3/auc/bigmodel/submitvolc.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)
streamtrue 返回 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
streamtrue 返回 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 SDKhttps://suolong.hiqzcar.com/v1/v1/chat/completions 或 /v1/responses
Anthropic SDKhttps://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
size1024x1024 / 1536x1024 / 1024x1536 / 2048x2048 / 2880x2880 / 3840x2160 / auto;宽高必须是 16 的倍数
qualitylow / medium / high / xhigh / max / auto
output_formatpng / jpeg / webp / gif
backgroundtransparent / opaque / auto(透明需配 png)
streamtrue 返回 SSE;完成事件 image_generation.completed,预览事件 image_generation.partial_image;GIF 不支持流式
partial_images流式预览张数 1–3,实际可能更少
frame_countGIF 帧数 2–16,默认 9(仅 output_format=gif)
frame_duration_msGIF 每帧毫秒 ≥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 URLimages: [{"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-260128480p / 720p / 1080p / 4k4–15 秒
doubao-seedance-2-0-fast-260128480p / 720p4–15 秒
doubao-seedance-2-0-mini-260615480p / 720p4–15 秒
doubao-seedance-2-5-260628480p / 720p / 1080p4–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 秒)——首帧/首尾帧与参考素材互斥
ratio16: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-Max480P / 768P5–15 秒
MiniMax-H3768P / 2K4–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_configformat: 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 字段返回)
视频(异步)提交时按最大可能用量冻结余额,完成按实际用量结算,失败/拒审/超时全额退回
配音 TTS1 元/分钟,按原始时长 original_duration,保留 8 位小数
语音识别0.8 元/小时,提交先冻结 1 小时,完成按实际时长多退
联网搜索DeepSeek web_search 按次收费

实际价格 = 官方价 × 分组倍率(如 ChatGPT 0.8 折、ClaudeCode 2 折),以「模型广场」和用量明细为准。

错误码

状态码常见原因处理
400Key 放 URL 参数;非法 JSON;缺 prompt;尺寸非 16 倍数;n>10;input 不是数组;含真人素材(InputImageSensitiveContentDetected)按接口说明修正请求
401未提供或无效 Key检查 Key 与请求头
402余额不足冻结本次费用(附 required/available)先充值
403Key 所在分组无该能力(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)。更多能力调试去 创作台。

等待请求…