> ## 统一对接(推荐) > > 一份文档、一套参数,适用于站内全部模型。换模型只需改 model,其余字段不用改;新增模型无需重新对接。 > > | 字段 | 统一写法 | > | --- | --- | > | model | 从模型列表复制展示名 | > | prompt | 文本,可用 @图片1 引用参考图 | > | images | 参考图 URL 数组 | > | size | 比例 16:9 / 9:16 | > | seconds | 整数 4–30 | > | resolution | 小写,如 720p | > > 写法不同也不会卡住:括号全/半角、大小写、前后空格,seconds 写成字符串或带单位,size 写成 720p / 全角冒号 / 像素尺寸,resolution 写成 720P,以及同时传了多个时长字段或多余字段——网关都会自动归一并清理,不会因为写法差异直接拒绝。 > > 各模型在时长档位、参考素材数量、比例与清晰度上的差异,由服务端在实际转发前自动适配;客户端不需要传模型专属字段、渠道参数或计费字段。 > > 若提交失败,请看任务记录里的「怎么办」提示,它会给出可直接执行的修改建议,并保留上游原始说明;「服务暂时不可用」不代表模型或本站服务故障。 > > 下方各章节为参考与附录;其中涉及「按模型分别对接」的历史说明均不影响统一参数提交。
算力AI 开放接口 Base URL https://suanliai.top/v1
开始
接口
统一对接 推理 / 对话 图片生成 图片编辑 / 修图 MJ 生图 视频生成
说明
算力AI 接口文档
算力AI 全面兼容 OpenAI 接口规范。用任意 OpenAI SDK 或 HTTP 客户端,把 Base URL 换成 https://suanliai.top/v1、填入你的密钥即可调用全部模型:对话推理、图片生成、图片编辑(修图)、视频生成。
推理 / 对话
Claude、Gemini、GPT、DeepSeek 等,流式输出,/chat/completions
图片生成
gpt-image、火山 2.5 系列等,/images/generations
图片编辑 / 修图
gpt-image 系列,支持参考图换背景 / 改风格 / 多图融合,/images/edits
视频生成
001–007、SVIP、专享等系列,提交后轮询,/videos
01鉴权
所有请求在 HTTP 头里带上你的 API 密钥(在控制台「API 密钥」页创建):
HTTP Header
Authorization: Bearer sk-你的密钥 Content-Type: application/json
分组与计费密钥可绑定不同分组(default 等),分组决定走哪条线路与价格。余额在控制台「钱包」查看。
02获取模型列表
模型很多且会更新,建议用接口实时拉取全部可用模型名,而不是写死:
GET/v1/models
cURL
curl https://suanliai.top/v1/models \\ -H "Authorization: Bearer sk-你的密钥"
返回 data[].id 即模型名,直接用于下面各接口的 model 字段。
/v1/models 只告诉你模型叫什么,不含各模型的参考素材数量、是否支持音频等能力限制。能力请看本文「模型能力对照」一节。
03推理 / 对话接口
标准 OpenAI Chat Completions。支持多轮对话、流式(stream:true)、多模态(在 content 里放图片)。
POST/v1/chat/completions
请求
curl https://suanliai.top/v1/chat/completions \\ -H "Authorization: Bearer sk-你的密钥" \\ -H "Content-Type: application/json" \\ -d '{ "model": "claude-opus-5-5-max", "messages": [{"role":"user", "content":"你好"}], "stream": true }'
常见模型示例
claude-opus-5-5-maxclaude-sonnet-5-5-max gemini-3.8-flash-优质deepseek-v4-flash-高质量… 全部见 /v1/models
| 参数 | 类型 | 统一口径(全部模型一致) |
|---|---|---|
model 必填 | string | 从 /v1/models 复制展示名;括号/大小写/空格的细微差异自动兼容 |
prompt 必填 | string | 视频描述 / 分镜台词,可用 @图片1 / [图1] 引用参考图 |
images 可选 | array | 公网图片直链或 base64,最多 9 张,服务端按模型能力自动裁剪 |
size 可选 | string | 推荐写比例 16:9 / 9:16;其它写法自动归一 |
seconds 可选 | integer | 推荐写整数 4–30;写成字符串或带单位会自动归一 |
resolution 可选 | string | 推荐小写,如 720p;大写/空格自动归一 |
audios 可选 | array | 参考音频公网直链,合计 ≤30 秒,超限由服务端按帧边界截断 |
videos 可选 | array | 参考视频公网直链 |
> 只需这一套参数:换模型只改 model,其余字段不用改。不需要传模型专属字段、渠道参数或计费字段,服务端会在实际转发前自动完成适配。参考图/音频数量与格式由服务端自动适配,新增模型无需重新对接。
> 模型名只认 /v1/models 返回的那一列。 任务记录里会额外显示一次投递时所用的内部名称,那是给排查用的,不要照抄去提交;照抄内部名称会提示「没有可用线路」。
时长会自动吸附到模型允许档位部分系列只接受固定时长(如 5 / 10 / 30 秒)。若你传的秒数不在允许档位,平台会自动就近调整并重新提交,不会直接失败。
参考素材的数量上限、是否支持音频,不是所有模型都写在模型名里。模型名里的标注(如「30图10音/4-30秒」)存在时不保证覆盖全部模型,请以下方「模型能力对照」为准;未在表中的模型,以提交时返回的错误提示为准。
部分模型属于固定规格档:出片时长与清晰度由该档位固定,seconds 会自动收敛到该档位允许的取值,保证计费与成片一致;resolution 也会按该档位归一。其中只有少数档位连画面比例也固定(aspect_ratio 不改变成片),其余档位仍按 aspect_ratio 出横 / 竖屏。具体以「模型能力对照」表为准。
模型系列
不同系列对应不同线路、质量与价格,功能相近时可按价格/稳定性选择。完整列表以 /v1/models 为准。
001–007 系列 各线路 sd2.0 / sd2.5 / wan3 / grok SVIP系列 官方直连 / 高质量 专享 sd2.5 多图多音 高质量 / 优质特价
003 系列(原生过人脸 9 图) 原生人脸,参考图可用真人照片。参考图最多 9 张(与价格无关),不支持参考视频与参考音频,去掉这两个字段即可;seconds 为 4–30 的整数(不传按 15 秒),清晰度固定 720P,aspect_ratio 支持 16:9 / 9:16 / 1:1 / 4:3 / 3:4(不传按 16:9),成片带声音。
> 003 系列各模型对时长、清晰度、画面比例的要求各不相同,平台会自动把通用参数收敛到该模型接受的档位(含固定 15 秒、仅 5 / 10 / 15 秒、768P 大写、1280×720 / 720×1280 像素尺寸等),按通用文档写即可,不需要记这些差异。个别模型(如 sd2.0-mini)必须带至少 1 张参考图,缺图会在提交前直接提示,本次不扣费。
官方直连视频系列 全部使用中文模型名,调用方式与上面完全一致:POST /v1/videos 提交、GET /v1/videos/{task_id} 轮询,字段仍是 model / prompt / images / videos / audios / seconds(或 duration) / resolution / aspect_ratio。平台会按每个模型的要求自动整理参数,客户不用改写法。 官渠 sd2.5-flash 系列(固定分辨率 / 按条计费)
官渠sd2.5-flash(20参任选/10-5-5/5-30秒/480P) 与 官渠sd2.5-flash(20参任选/10-5-5/5-30秒/720P) 是两个固定分辨率档,按条计费(与输出时长无关)。选好模型名就选定了清晰度,resolution 传了会自动归一到该档,不必为了换清晰度去换模型名。
按通用文档写就行,但这两个模型有 4 条硬约束;平台会在提交前自动处理前两条,后两条直接说明原因并明确「本次未扣费」,不会再出现含糊的「参数不太符合要求」:
- 必须带至少 1 张参考图:不支持纯文生视频。只写
prompt、不传images会在提交前提示「该模型必须带至少 1 张参考图」。 - 参考图 ≤10 张、参考视频 ≤5 段、参考音频 ≤5 段,素材合计 ≤20 份;超出部分平台自动截断到上限(若
prompt里的@图片N指向被截掉的图,会提前拒绝并说明)。 seconds支持 5–30 秒,不接受 12 秒:传 12 秒自动吸附为 13 秒,不足 5 按 5、超过 30 按 30。prompt最多 5000 字;超长分镜请拆成多段提交。
aspect_ratio 支持 16:9 / 9:16 / 3:4 等常见比例、prompt_extend 可按需传。价格以控制台与 /v1/models 为准。
可直接复制的 30 秒示例(把图片链接换成自己的即可):
`json POST /v1/videos Content-Type: application/json Authorization: Bearer <你的密钥>
{ "model": "官渠sd2.5-flash(20参任选/10-5-5/5-30秒/720P)", "prompt": "一段 30 秒、带完整起承转合的冒险短片……", "images": ["https://suanliai.top/testmedia/img1.jpg"], "seconds": 30, "aspect_ratio": "16:9", "resolution": "720p" } `
模型名已合并:每个模型名内部就包含该档位的全部清晰度与「有 / 无参考视频」, 不要再按 720P / 1080P 或带不带参考视频去换模型名 —— 只改 resolution、videos 两个字段, 价格由多参计费按分辨率档 / 有参考视频档自动计算。模型统一命名为 官方直连<N>区-<系列>-满血稳定高速,按版本分成 1 / 2 / 3 区:
| 区 | 模型名 | 计费口径 | 清晰度 |
|---|---|---|---|
| 1 区(特价版) | 官方直连1区-SD2.0-满血稳定高速、官方直连1区-SD2.0-fast-满血稳定高速、官方直连1区-SD2.0-mini-满血稳定高速、官方直连1区-SD2.5-满血稳定高速、官方直连1区-wan3-viedo-满血稳定高速、官方直连1区-wan3-prime-满血稳定高速、官方直连1区-MiniMax H3-768P-满血稳定高速、官方直连1区-MiniMax H3-1080P-满血稳定高速 | 按秒 × 分辨率(MiniMax H3 按次) | 480P / 720P / 1080P / 2K / 4K |
| 2 区(折扣版) | 官方直连2区-SD2.0-满血稳定高速、官方直连2区-SD2.0-fast-满血稳定高速、官方直连2区-SD2.0-mini-满血稳定高速、官方直连2区-SD2.5-满血稳定高速、官方直连2区-wan3-viedo-满血稳定高速、官方直连2区-MiniMax H3-768P-满血稳定高速 | SD2 系列按量(token)× 分辨率;WAN 按秒;MiniMax H3 按次 | 480P / 720P / 1080P / 2K / 4K |
| 3 区(官转版) | 官方直连3区-SD2.5-满血稳定高速 | 按量(token)× 分辨率 | 480P / 720P / 1080P |
同一区内不同系列的时长与素材上限不同:SD2.0 / fast / mini 为 4–15 秒、9 图 / 3 视频 / 3 音频; SD2.5 为 4–30 秒、30 图 / 10 视频 / 10 音频;WAN 为 4–30 秒、10 图 / 5 视频 / 5 音频; MiniMax H3 为 10–15 秒、9 图 / 3 视频 / 3 音频。完整模型列表以 /v1/models 为准。
- 分辨率大小写(如
720P)不用管,平台会归一;传了该模型不支持的档位会自动收敛到主档,不会直接失败。 - 时长同理:每个模型只接受固定档位或固定区间,平台会自动就近调整,不会直接失败。
videos里传了参考视频会走「有参考视频」单价,价格与纯文生 / 图生视频不同,请留意。- 只传
audios、不带任何图片或视频会被拒绝(400,不扣费),请至少同时带一张参考图或一段参考视频。 - 按量的模型按 token 结算,且同一模型不同分辨率单价不同:提交时按估算预扣,任务完成后按实际用量多退少补;带参考视频会走「有参考视频」档,价格都在多参计费里按分辨率设置,不用换模型名。完整价格以控制台与
/v1/models为准。
③ 用对话接口直调视频模型(兼容模式)
如果你的客户端或软件只支持 OpenAI 的对话接口,也可以直接用 /v1/chat/completions 调视频模型:把画面描述写进 messages,参考图写成 image_url 内容块,平台会自动把它转成视频任务并等待成片,然后在回复内容里返回视频地址和任务 ID。
POST/v1/chat/completions
curl https://suanliai.top/v1/chat/completions \\ -H "Authorization: Bearer sk-你的密钥" \\ -H "Content-Type: application/json" \\ -d '{ "model": "002系列/sd2.0(933满血不卡脸1080P)", "messages": [ {"role": "user", "content": [ {"type": "text", "text": "镜头缓缓推近,人物微笑转头"}, {"type": "image_url", "image_url": {"url": "https://你的图床/a.png"}} ]} ] }'
返回(choices[0].message.content 是视频地址,video_task 是任务信息)
` { "choices": [{ "message": { "role": "assistant", "content": "视频已生成完成。\ \
- 任务 ID:task_xxx\
- 视频地址:https://..." } }],
"video_task": { "id": "task_xxx", "status": "completed", "url": "https://..." } } `
| 说明 | |
|---|---|
| 参数 | 兼容模式下 seconds / size / aspect_ratio / resolution 会原样透传给视频接口;不传就按模型默认档位 |
| 耗时 | 视频要几分钟,请求会保持到成片(最长 10 分钟)。stream: true 时可以实时拿到进度 |
| 未出片 | 超过时长上限还没完成时不报错,回复里会带上任务 ID,用 GET /v1/videos/{task_id} 继续查 |
| 完整能力 | 参考音频、参考视频、多图数量控制等只在 /v1/videos 上支持,需要时用原生视频接口 |
06参考素材(图片 / 音频)
参考图和音频可以用两种方式传,二选一:
公网直链
稳定可访问的图床 / 对象存储地址(http/https)。不要用会过期、要登录或会回源超时的临时中转链接。
base64 内联
data:image/png;base64,<内容>,适合本地图片直接上传。
链接要稳定若参考图链接下载失败或超时,任务会在提交阶段就被拒绝(不扣费)并提示换链接。临时中转图床(会过期 / 回源慢)最容易踩坑,优先用稳定图床或直接传 base64。
字段名按接口区分:
- 视频接口(/v1/videos)统一用
images,平台会按各模型要求自动改写成对应的字段名(例如部分系列要的是image_urls);其他接口写法里常见的image_url、image_urls、reference_images、image_refs等写法同样会被识别并合并。 - 修图接口(/v1/images/edits)统一用
image(JSON 数组或 multipart 文件);image[]、input_images、images等写法同样会被识别。
图片格式支持 PNG / JPEG / GIF / WebP / BMP / TIFF。坏图(下载不完整、编码损坏)会被模型服务拒绝,报「参考图片无法解码」,换一张图或改传 base64 即可。
07模型能力对照
MJ 生图是异步任务模型,调用方式与出图规则见 04 节「MJ 生图(Midjourney)」,下表为视频模型的限制。
不同模型对参考图数量、是否支持参考音频、时长范围、分辨率的限制不同,请按下表提交,可避免无谓的失败。表外模型以提交返回的错误提示为准。
| 模型名 | 参考图 | 参考音频 | 时长 | 分辨率 |
|---|---|---|---|---|
| 特价sd2.0mini(3图/4-15秒/720P) | 必传,1–3 张(超过会被拒,纯文生不支持) | 不支持,传了会失败 | 4–15 秒 | 720P |
| 003系列/sd2.5(原生过人脸9图/5-30秒/720P) | 最多 9 张 | 不支持(也不支持参考视频) | 4–30 秒(不传按 15 秒) | 720P |
| SVIP系列/高质量/Minimax-H3(9图3音/10-15秒/768P/2K) | 最多 9 张 | 最多 3 段(参考视频另最多 3 段,素材合计不超过 12) | 10–15 秒 | 768P / 2K |
| 稳定sd2.5(原生过人脸5-30秒/30参可选/720P) | 最多 10 张(标称;实测 20 张也能受理,建议 ≤10 更稳);提示词可写 @图片N 指代第 N 张 | 最多 10 段 | 5–30 秒 | 720P |
| 高质量特惠sd2.5(满血原生过真人30-10-10/720P) | 最多 30 张(标称,实测 1–3 张稳定);也支持不传图纯文生;提示词可写 @图片N,N 不能超过实传张数 | 最多 10 段(标称,实测 1 段正常) | 5–30 秒(不足 5 按 5、超过 30 按 30) | 720P 固定 |
| 优质特价sd2.5(满血933原生过真人/720P) | 支持参考图(图生视频) | 支持参考音频 | 4–30 秒 | 720P |
| 稳定官渠sd2.0mini(全参933/480P) | 最多 9 张(933 = 9 图 3 音 3 视频;纯文生也可) | 最多 3 段(参考视频另最多 3 段) | 5–12 秒(不足 5 按 5、超过 12 按 12) | 480P 固定 |
| 稳定官渠sd2.0fast(全参933/480P) | 最多 9 张(同上) | 最多 3 段(参考视频另最多 3 段) | 5–12 秒 | 480P 固定 |
| 稳定官渠sd2.0mini(全参933/720P) | 最多 9 张(同上) | 最多 3 段(参考视频另最多 3 段) | 5–12 秒 | 720P 固定 |
| 稳定官渠sd2.0fast(全参933/720P) | 最多 9 张(同上) | 最多 3 段(参考视频另最多 3 段) | 5–12 秒 | 720P 固定 |
| 官转稳定满血sd2.0(933/4-15秒/720P) | 最多 9 张(933) | 最多 3 段(参考视频另最多 3 段) | 4–15 秒 | 720P 固定 |
| 官转稳定满血sd2.5(30-10-10/4-15秒/720P) | 最多 30 张(30-10-10) | 最多 10 段(参考视频另最多 10 段) | 4–15 秒 | 720P 固定 |
| 火山官方sd2.0(933)(官方 2.0 满血) | 最多 9 张(933 = 9 图 3 音 3 视频) | 最多 3 段(参考视频另最多 3 段) | 4–15 秒 | 480P / 720P / 1080P |
| 火山官方sd2.0fast(933)(官方 2.0 Fast) | 最多 9 张(同上) | 最多 3 段(参考视频另最多 3 段) | 4–15 秒 | 480P / 720P |
| 火山官方sd2.0mini(933)(官方 2.0 Mini) | 最多 9 张(同上) | 最多 3 段(参考视频另最多 3 段) | 4–15 秒 | 480P / 720P |
| 火山官方sd2.5(30-10-10)(官方 2.5) | 最多 30 张(30-10-10) | 最多 10 段(参考视频另最多 10 段) | 4–30 秒 | 480P / 720P / 1080P |
| 稳定高速sd2.5(30参任选/4-30秒/720P) | 最多 30 张;图片 / 视频 / 音频合计最多 30 份 | 最多 10 段音频、10 段视频;音视频每段 2–30 秒、合计 ≤30 秒 | 4–30 秒(含音视频或超过 9 张图时 5–30 秒,不传按 30 秒) | 720P 固定 |
| SVIP系列/官转-高质量/SD2.0mini、SVIP系列/高质量/SD2.0mini、SVIP系列/官转-高质量/SD2.0fast、SVIP系列/高质量/SD2.0、SVIP系列/高质量/SD2.0fast | 最多 9 张(不支持参考视频) | 最多 3 段 | 固定 15 秒:传 4 / 10 / 30 秒都会自动收敛为 15 秒 | 720P 固定;比例按 aspect_ratio 出片,支持 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 / 9:21(不传或传范围外按 16:9) |
| 008系列/sd2.0(mini933/720P)、特惠mini/sd2.0(933/720P)、优质特价/sd2.0(mini933/5-15秒720P) | 支持参考图与参考音视频 | 支持 | 4–15 秒任意整数(超出自动收敛) | 固定 720×1280(9:16·720P):传 aspect_ratio: "16:9" 出片仍是竖屏 |
| 008系列/sd2.5(30-10-10/5-30秒/720P) | 最多 30 张(30-10-10);提示词可写 @图片N,N 不能超过实传张数 | 最多 10 段音频、10 段参考视频 | 5–30 秒(不足 5 按 5、超过 30 按 30) | 720P 固定 |
| 008系列/sd2.5(30-10-10/5-30秒/480P) | 最多 30 张(30-10-10);提示词可写 @图片N,N 不能超过实传张数 | 最多 10 段音频、10 段参考视频 | 5–30 秒(不足 5 按 5、超过 30 按 30) | 480P 固定 |
| 官渠sd2.5-flash(20参任选/10-5-5/5-30秒/480P) | 必传,1–10 张(纯文生不支持) | 最多 5 段(参考视频另最多 5 段,素材合计 ≤20);提示词 ≤5000 字 | 5–30 秒(不接受 12 秒,传 12 自动吸附为 13) | 480P 固定 |
| 官渠sd2.5-flash(20参任选/10-5-5/5-30秒/720P) | 必传,1–10 张(纯文生不支持) | 最多 5 段(参考视频另最多 5 段,素材合计 ≤20);提示词 ≤5000 字 | 5–30 秒(不接受 12 秒,传 12 自动吸附为 13) | 720P 固定 |
| 专享sd2.0(fast9图/4-15秒/720p) | 最多 9 张参考图(建议 1–9 张);提示词可用 @图片N | 上游目录只声明参考图;videos / audios 可同传(网关转 video_refs / audio_refs),是否参与生成以上游为准 | 4–15 秒(seconds 传整数,超范围自动收敛) | 720P 固定 |
| 高质量福利sd2.0-fast(满血933/720P) | 最多 9 张参考图(建议 1–9 张);提示词可用 @图片N,N 不能超过实传张数 | 不支持参考音频:传 audios 会被上游直接拒绝(不扣费) | 4–15 秒,按次计费(与时长无关) | 固定 720P |
008系列 sd2.5 两个新档位:008系列/sd2.5(30-10-10/5-30秒/720P) 与 008系列/sd2.5(30-10-10/5-30秒/480P) 都按本文档的通用字段提交即可——model / prompt / images / videos / audios / seconds / resolution / aspect_ratio / size,换模型只改 model,其余参数不用改。清晰度由模型名固定:720P 档出 720P、480P 档出 480P,resolution 字段不会改变成片档位,因此换档只需改 model,不必为了清晰度改其他参数;seconds 支持 5–30 秒(30 秒长片可直接传 seconds: 30)。两个档位都支持一次最多 30 张参考图,提示词可用 @图片N 指代第 N 张。
固定规格档单独说明(时长 / 清晰度固定;其中一组连比例也固定)
SVIP系列/官转-高质量/SD2.0mini、SVIP系列/高质量/SD2.0mini、SVIP系列/官转-高质量/SD2.0fast、SVIP系列/高质量/SD2.0、SVIP系列/高质量/SD2.0fast:按次出片,固定 15 秒 / 720P,传seconds: 5 / 10 / 30都会自动收敛为 15 秒。画面比例按aspect_ratio生效:传9:16出竖屏、16:9出横屏,另支持1:1 / 4:3 / 3:4 / 21:9 / 9:21,不传按 16:9;也可传size: "720x1280"由平台换算比例。最多 9 张参考图、3 段参考音频,不支持参考视频(传了会自动忽略);resolution固定按 720P 归一。008系列/sd2.0(mini933/720P)、特惠mini/sd2.0(933/720P)、优质特价/sd2.0(mini933/5-15秒720P):固定 720×1280(9:16)/ 720P,seconds支持 4–15 任意整数(超出自动收敛)。传aspect_ratio: "16:9"成片仍是 720×1280;支持纯文生与参考素材,按通用文档传images/videos/audios即可。- 其中
008系列那组连画面比例也固定;SVIP系列这五个模型只有时长与清晰度固定,比例可按通用文档自由指定。两组都能跑通,只是规格范围不同。调用写法不用改,仍按本文档POST /v1/videos的通用字段提交。
专享sd2.0(fast9图/4-15秒/720p) 单独说明(新上模型,完全按通用文档调用)
- 按次计费档:固定 720P、4–15 秒、最多 9 张参考图;与输出时长、素材张数无关,每单只扣一次。选好模型名即选定清晰度,
resolution写720p/720P/1280x720都会被归一成上游需要的720P。 - 调用写法不用改,仍用本文 05 节的
POST /v1/videos通用字段;平台自动把通用参数翻译成该上游的字段名:
| 通用文档字段 | 实际送上游 | 说明 |
|---|---|---|
images | images | 最多 9 张,公网可直读的链接 |
videos | video_refs | 参考视频;上游目录未声明上限,建议少量 |
audios | audio_refs | 参考音频;同上 |
seconds | duration | 4–15 的整数,超范围自动收敛 |
aspect_ratio / size | aspect_ratio | size 换算比例后自动删除 |
resolution | resolution | 归一为 720P |
- 一次填齐全部参数的真实示例(精彩打斗动画;2026-11-15 实测成功出片,成片 5.4 MB MP4):
bash curl https://suanliai.top/v1/videos \ -H "Authorization: Bearer sk-你的密钥" \ -H "Content-Type: application/json" \ -d '{ "model": "专享sd2.0(fast9图/4-15秒/720p)", "prompt": "精彩打斗动画:@图片1 的青衣剑客与 @图片2 的黑甲武士在暴雨屋顶决战,@图片3 的古城全景作开场远景。快速推近、拔剑横斩、重刀格挡、腾空翻转、双刃交锁特写,电影级运镜。", "images": ["https://你的域名/img1.jpg", "https://你的域名/img2.jpg"], "videos": ["https://你的域名/ref.mp4"], "audios": ["https://你的域名/bgm.mp3"], "seconds": 15, "aspect_ratio": "16:9", "resolution": "720p", "size": "1280x720", "prompt_extend": true, "seed": 20261115, "n": 1, "watermark": false }'
- 提交返回
task_id与status: queued,轮询GET /v1/videos/{task_id}直到completed;用返回的download_url下载(带download=1、7 天有效)。参考图链接需公网可直读,建议先走POST /v1/assets/review换成本站链接。
高质量福利sd2.0-fast(满血933/720P) 单独说明(按次计费,2026-11-15 实测出片)
- 按次计费档:固定 720P、4–15 秒,每单只扣一次,与输出时长、素材张数无关。
resolution写720p/720P都会被归一。 - 素材上限(以上游能力表为准):参考图最多 9 张、参考视频最多 1 段、参考音频 0 段。传
audios会被上游拒绝并返回「该模型最多支持 0 个参考音频」,本次不扣费,去掉该字段重试即可。 - 参考素材有分辨率硬要求:宽、高均需 ≥300px,且总像素需 ≥409600(建议 ≥480P,如 1280×720 / 720×1280)。320×240 的参考视频、640×360 的参考图都会被上游 422 拒绝并提示「参考视频分辨率过低」(本次不扣费)。素材务必用清晰的公网直链,或先走
POST /v1/assets/review换成本站链接。 - 调用写法不用改:仍用本文 05 节的
POST /v1/videos通用字段。该线路按历史透传方式把images/videos/seconds/aspect_ratio/resolution等字段原样送上游,不做字段名改写;prompt_extend/seed/n/watermark上游忽略,可传,不影响出片与计费。 - 一次填齐全部支持参数的实测示例(精彩打斗动画;2026-11-15 真实提交,约 5 分钟出片,成片 14.8 MB MP4):
bash curl https://suanliai.top/v1/videos \ -H "Authorization: Bearer sk-你的密钥" \ -H "Content-Type: application/json" \ -d '{ "model": "高质量福利sd2.0-fast(满血933/720P)", "prompt": "精彩打斗动画:@图片1 的青衣剑客与 @图片2 的黑甲武士在暴雨屋顶决战,快速推近、拔剑横斩、重刀格挡、腾空翻转、双刃交锁特写,电影级运镜。", "images": ["https://你的域名/img1.jpg", "https://你的域名/img2.jpg"], "videos": ["https://你的域名/ref720.mp4"], "seconds": 15, "aspect_ratio": "16:9", "resolution": "720p", "size": "1280x720", "prompt_extend": true, "seed": 20261115, "n": 1, "watermark": false }'
- 提交返回
task_id与status: queued,轮询GET /v1/videos/{task_id}直到completed(中间会经历in_progress、delivery_status: archiving/ready),用返回的download_url下载。
稳定高速sd2.5(30参任选/4-30秒/720P) 单独说明(按条计费,与输出时长无关)
- 按通用文档写就行:
model/prompt/images/videos/audios/seconds/aspect_ratio(或size)。平台会自动整理成该模型实际需要的写法,resolution、seed、watermark、n等字段会自动忽略,不用自己改参数名。 - 清晰度固定 720P;
seconds必须是整数,纯文字或不超过 9 张图时 4–30 秒,含音视频或超过 9 张图时 5–30 秒。传了范围外的值会自动就近调整,不传按 30 秒。 - 支持不传素材纯文生;三类参考素材可单独或混合使用,合计最多 30 份(图片 ≤30、视频 ≤10、音频 ≤10)。参考音视频每段 2–30 秒、全部合计不超过 30 秒,平台会在提交前按文件真实时长校验,不合规会中文提示且本次不扣费。
- 提示词里可用
@图片1、@视频1、@音频1按同类素材的出现顺序引用,编号不能超过本次实际提交的该类型份数;引用了没传的素材会在提交阶段直接提示(不扣费)。 - 素材链接需公网可直接读取;无文件后缀的链接或 base64 会自动补上真实格式名称,不需要客户自己命名。
- 实测(2026-11-10):2 张图 + 1 段 5 秒视频 + 1 段 3 秒音频,
seconds: 10、aspect_ratio: "16:9"→ 10.05 秒 / 1280×720 成片,四类素材均生效。
稳定官渠sd2.0mini/fast、官转稳定满血sd2.0/2.5单独说明(按秒计费)
- 参考素材三类都支持:
images/audios/videos(933 = 9 图 3 音 3 视频,30-10-10 = 30 图 10 音 10 视频),也支持不传图纯文生。 - 参考素材有时长上限:参考视频 1.8–30.2 秒(建议 ≤15 秒)、参考音频 ≤15.2 秒。超限模型服务会直接 400(「…duration (seconds) … must be less than or equal to 15.2」),本次不扣费。
- 时长超出范围会自动收敛:mini/fast 5–12 秒,官转满血 4–15 秒,不会因为传了 15 秒而报错(按 12 秒出片)。
- 分辨率固定档位:xxx/480P 与 xxx/720P 分别对应 480P、720P,传其它值会被忽略。
- 实测(2026-11-06):1 图 + 1 音 + 1 段 14.7 秒视频 + 5 秒 16:9 480P,150 秒出片,成片 864×496 / 5.09 秒。
火山官方sd2.0(933) / 火山官方sd2.0fast(933) / 火山官方sd2.0mini(933) / 火山官方sd2.5(30-10-10)(官方直连,按 token 计费)
- 模型名直接用上面这四个,调用
/v1/videos通用格式,参数写法与其它模型一致:prompt、seconds、aspect_ratio、resolution、images、videos、audios。 - 计费按 token(按视频 token 收费,输入与输出同价):sd2.0 31.75 元/百万 token、sd2.0fast 25.55、sd2.0mini 15.92、sd2.5 48.50。
- 参考价格:4 秒 720P 约 8.6 万 token ≈ 2.7 元;4 秒 1080P 约 19.4 万 token ≈ 6.2 元;时长翻倍价格翻倍,带参考视频再约翻倍。提交时按预估 token 预扣,出片后按实际 token 多退少补。
- 分辨率:480P / 720P / 1080P,不传默认 720P;像素越高 token 越多、价格越高。
- 时长:2.0 系列(满血 / Fast / Mini)4–15 秒,2.5 4–30 秒;超范围网关直接拦下(本次不扣费),不会提交到模型服务。
- 参考素材:
images/videos/audios三类都支持;2.0 系列最多 9 图 + 3 视频 + 3 音频(933),2.5 最多 30 图 + 10 视频 + 10 音频(30-10-10)。提示词里可用@图片1指代第 1 张图。 - 实测(2026-11-06):
火山官方sd2.0(933)1 图 + 1 段 5.05 秒视频 + 1 段音频,5 秒 720P 16:9 → 成片 1280×720 / 5.04 秒;同模型纯文生 4 秒 1080P → 1920×1080 / 4.04 秒。 - 实测(2026-11-06):
火山官方sd2.0(933)纯文生 4 秒 720P → 1280×720 / 4.04 秒,实计 87 299 token,按 token 计费 2.77 元(预扣 2.74,出片后按实际微调)。
高质量特惠sd2.5(满血原生过真人30-10-10/720P) 单独说明(按次收费,与时长、张数无关)
- 不支持参考视频:传
videos/video_urls会被直接拦下,返回 400「该模型不支持参考视频…(本次未扣费)」。要参考镜头运动,请把运镜、节奏写进prompt。 - 分辨率固定 720P:传 1080p / 480p 会按 720P 提交,不会报错。
- 时长 5–30 秒整数:传 4 会按 5 秒提交,传 35 会按 30 秒提交。
- 支持
@图片N,但 N 不能大于本次images的张数(见下节)。 - 实测:2 图 + 1 音 + 30 秒正常出片;5743 字提示词可正常受理;纯文生(不传图)也能提交。
专享wan3.0(满血10-5-5/2-15秒/分辨率可选) 单独说明(按条计费,与输出时长无关)
- 模型名沿用历史写法「2-15秒」,实际支持 2–30 秒:传
seconds: 30可以一次生成 30 秒成片,不用分段拼接,也不会因超范围被拦下。 - 按条计费,与时长、参考素材数量无关:480p 1.95 元 / 720p 3.35 元 / 1080p 4.25 元,每单只扣一次。
- 分辨率可写
480p/720p/1080p(大小写均可,也可用1280x720这类像素尺寸),平台会自动整理成模型服务要求的档位;不传按默认档。 - 支持纯文生(不传
images),也支持images/videos/audios三类参考素材;aspect_ratio支持16:9/9:16/1:1等。 - 调用写法与其它模型完全一致,不需要改字段名:
POST /v1/videos,字段model/prompt/seconds/aspect_ratio/resolution/images。
提示词引用参考图(@图片N)
部分模型(如「稳定sd2.5(原生过人脸5-30秒/30参可选/720P)」「高质量特惠sd2.5(满血原生过真人30-10-10/720P)」)允许在 prompt 里用 @图片1…@图片N 精确指代第 N 张参考图,用来把角色 / 场景 / 道具固定到具体某张图。
硬性规则:N 必须 ≤ 本次 images 的实际张数。
引用了没传的序号,平台会在提交阶段直接拦下并返回 400 中文提示「提示词里引用了 @图片N,但本次只传了 M 张参考图」(不扣费);个别模型只回「请求未被接受,请检查模型、参数和输入内容」,也不会告诉你差哪一张。同一模型、同一段约 5,900 字分镜提示词的实测对照:
| 传图张数 | 提示词引用的最大序号 | 结果 |
|---|---|---|
| 8 张 | @图片8 | ✅ 正常出片 |
| 20 张 | @图片21 | ❌ 400(引用了不存在的第 21 张) |
| 1 张 | @图片2 | ❌ 400 |
| 1 张 | @图片1 | ✅ 正常受理 |
所以:提示词里写到第几张图,就要真的传几张图;分镜脚本多预留了一个占位(比如写了 @图片21)而只传 20 张,就一定会失败。改法二选一:补上缺的那张,或把 @图片21 改成实际存在的序号。
提示词长度也要控制:该模型约 5,900 字以内可正常提交,同一段再补 400 余字(约 6,300 字)就会被拒。长分镜建议按「每镜一段」分批提交。
常踩的几个坑
① 「该模型不支持参考音频」 —— 该模型确实不支持音频参考,去掉 audios 字段重新提交即可。
② 「参考图必须是 1–9 张」 —— 这条提示的含义是:模型服务没有收到可用的参考图,通常不是"图传多了"。最常见的原因是按"文生视频可以不传图"的写法省略了 images,而该模型必须传参考图;其次是参考图链接失效或不可公网访问。请至少传 1 张(该模型上限 3 张)稳定的公网直链或 base64。
(参考图数量超过上限时会返回另一条提示「参考图最多 3 张」,含义是图已收到但超限。)
③ 修图传图被拒 / 不生效 —— 修图(/v1/images/edits)必须用支持参考图的模型(gpt-image 系列);flare / sunburst 纯文生图档位不接受参考图。另外 size 只接受宽x高(如 1024x1024),写 16:9 这类比例会报错,比例请用 aspect_ratio。 ④ 「这次请求参数不太符合要求」 —— 最常见的原因是按「文生视频」写法省略了参考图(官渠 sd2.5-flash 系列必须至少 1 张),其次是传了 12 秒、提示词超过 5000 字、素材合计超过 20 份。现在平台会在提交前把时长与素材自动吸附 / 截断,其余情况直接给出具体原因并注明「本次未扣费」,不用反复试参数。
08计费与退款
| 方式 | 说明 |
|---|---|
| 按次 | 每次调用固定价,与时长无关(如专享系列) |
| 按秒 | 价格 × 实际时长 |
| 按量 | 推理类按 token 计费 |
失败自动退款任务失败会在判定失败时即时全额退回预扣的费用(内容/版权被拒、参数不符等)。提交阶段被拦的(余额不足、参考图不可用)本就不扣费。
09错误处理
| 现象 | 怎么办 |
|---|---|
| 余额不足 | 控制台「钱包」充值后重试 |
| 内容/版权被拒 | 换参考素材或改提示词;这类已自动退款 |
| 参考图下载失败 | 换稳定公网直链或改传 base64 |
| 「参考图片无法解码或实际格式无效」 | 参考图文件不完整或编码损坏,换一张图重试,或改传 base64(见「参考素材」) |
| size 传了 16:9 这类比例报错 | size 只接受宽x高(如 1024x1024);比例请改用 aspect_ratio |
| 「The requested image size is invalid」 | 该模型不接受这个尺寸,换常见宽x高:1024x1024 / 1536x864 / 2048x1152 / 3840x2160 |
| 「输入的图片有误,请确认图片格式…」 | 修图参考图需为 PNG/JPEG/GIF/WebP/BMP/TIFF 且链接公网可直接访问;改传 base64 最稳 |
| 「参考图最多 N 张」 | 减少参考图数量后重试(见「模型能力对照」) |
| 「参考图必须是 1–9 张」 | 补上参考图并检查链接可用性;详见「常踩的三个坑」 |
| 「该模型不支持参考音频」 | 去掉 audios 字段后重试 |
| MJ 任务 status=FAILURE | 看 failReason(多为提示词或素材被拒);保留任务 ID 联系客服,不要重复提交 |
| 「No available channel … under group mj」 | 模型名不在本站:换成 04 节表格里的模型名或别名后重试 |
MJ 接口返回 405 或 openai_error | 旧版本会这样:用对话 / 图片接口调 MJ 时被模型服务拒绝。现已修复,网关会自动转成 MJ 任务;若仍出现,先确认模型名是 04 节表格里的名字,仍不行把「请求编号」发给客服(未出图不扣费) |
| 「该模型是 Midjourney 模型,不支持 /v1/images/generations」 | 旧版本提示,现已支持该接口;如仍出现请联系客服升级网关 |
| 「该模型是视频生成模型,不支持对话接口 /v1/chat/completions」 | 平台已识别出它是视频模型、但没能转成视频任务:请确认 messages 里写了画面描述;仍不行就直接用 POST /v1/videos(见 05 节 ③) |
| 「请求未被接受,请检查模型、参数和输入内容」(400,不扣费) | 模型服务在提交阶段就拒了。按顺序自查:① 提示词里的 @图片N 是否大于实际传图张数(最常见);② 提示词是否过长(该模型约 5,900 字上限);③ images/audios/videos 是否超上限。仍失败时把返回里的「请求编号」发给客服核查 |
| 「提示词里引用了 @图片N,但本次只传了 M 张参考图」(400,不扣费) | 补齐第 N 张图,或把 @图片N 改成实际存在的序号后重新提交 |
| 「该模型(…)不支持参考视频」(400,不扣费) | 去掉 videos 字段;需要特定运镜时把镜头运动写进 prompt |
| 「task_not_exist」(400) | 这个任务 ID 不存在或已过期:失败任务、超出保留期的任务都查不到。请重新提交新任务,不要反复轮询同一个 ID |
| 服务暂时异常 | 稍后重试;持续出现联系客服 |
视频任务请以轮询结果为准:提交返回只代表已受理,最终成功/失败以 GET /v1/videos/{task_id} 的 status 为准。
10 大文件下载加速
视频原片可能达几十 MB。下载接口支持 HTTP Range(断点续传),在跨境或移动网络下用多线程分块下载可以明显缩短等待:实测 6 个并发分块约为单连接的 2–5 倍,30 MB 原片从约 20 秒降到 8 秒左右。
页面里的「下载」按钮已自动启用分块加速,无需改动写法;命令行 / 程序调用可直接用支持多连接的下载器:
aria2c -x 6 -s 6 -H "Authorization: Bearer sk-你的令牌" \ "https://suanliai.top/v1/videos/task_xxxxxxxx/content" -o out.mp4
也可以用 IDM / 迅雷等多线程下载器,或自行按 Range: bytes=start-end 并发拉取后按序合并。服务端会返回 206 与 Content-Range;不支持分块的客户端会自动退化为单连接下载,功能不受影响。合并后的文件与原片逐字节一致。
视频免费保留 18 小时,请在保留期内下载。
算力AI · https://suanliai.top · 全面兼容 OpenAI 接口 · 模型与价格以控制台和 /v1/models 为准
---
<a id="classic"></a>
11 经典系列(SD2.0 / SD2.5)— 通用接入
经典系列是视频生成模型,全部走标准 POST /v1/videos 提交、GET /v1/videos/{task_id} 轮询,和 05 节写法完全一致。按条计费,与输出时长无关;只要选好模型名和分辨率档位即可,不需要为了换清晰度去换模型。
11.1 模型与价格
模型名(model,原样复制) | 480P | 720P | 时长 seconds | 参考素材上限 |
|---|---|---|---|---|
经典系列/sd2.5(30-10-10/4-30秒/分辨率可选) | ¥5.20 / 条 | ¥8.45 / 条 | 4–30 秒 | 30 图 / 10 视频 / 10 音频 |
经典系列/sd2.5(30-10-10/5-30秒/分辨率可选) | ¥4.85 / 条 | ¥5.95 / 条 | 5–30 秒 | 30 图 / 10 视频 / 10 音频 |
经典系列/sd2.0(9图3音/4-15秒/分辨率可选) | ¥1.80 / 条 | ¥2.50 / 条 | 4–15 秒 | 9 图 / 3 音频(不支持参考视频) |
经典系列/sd2.0-fast(9图3音/4-15秒/分辨率可选) | ¥1.20 / 条 | ¥1.65 / 条 | 4–15 秒 | 9 图 / 3 音频(不支持参考视频) |
经典系列/sd2.0-mini(9图3音/4-15秒/分辨率可选) | ¥0.65 / 条 | ¥0.99 / 条 | 4–15 秒 | 9 图 / 3 音频(不支持参考视频) |
> 分辨率只开放 480p / 720p 两档。不传 resolution 按 480p;传 1080p / 4K / 其它值会自动收敛到 720p,绝不会按更高档扣费。sd2.0 三个型号请不要传 videos,上游不接受。
11.2 请求参数
| 字段 | 必填 | 说明 |
|---|---|---|
model | 是 | 上表任一完整模型名(含中文、括号、斜杠,需 UTF-8) |
prompt | 是 | 画面与剧情描述,支持 @图片1 / @视频1 指代素材 |
seconds | 否 | 整数秒数,按上表范围;超出会自动收敛到边界。直接写数字即可,平台会自动适配上游要求的格式 |
resolution | 否 | 480p / 720p(大小写均可,如 720P);不传按 480p |
aspect_ratio | 否 | 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 |
images | 否 | 参考图公网 HTTPS URL 数组,如 ["https://.../a.jpg"] |
videos | 否 | 参考视频 URL 数组(仅 sd2.5 两个型号支持) |
audios | 否 | 参考音频 URL 数组 |
素材链接必须公网可直接 GET 200;本站工作台上传后返回的 https://suanliai.top/api/media/input/... 链接可直接用。
11.3 可直接复制的完整示例(高质量打斗情节动画)
curl -X POST https://suanliai.top/v1/videos \ -H "Authorization: Bearer sk-你的令牌" \ -H "Content-Type: application/json" \ -d '{ "model": "经典系列/sd2.5(30-10-10/5-30秒/分辨率可选)", "prompt": "高质量武侠打斗动画,完整剧情短片:暴雨夜,古老屋顶,青衣剑客与黑甲武士拔刀对峙,疾冲交锋,剑光横斩、重刀格挡、火星四溅,腾空翻转,双刃交锁特写,最后回旋斩定格收势。电影级运镜,动作流畅有力,戏剧性光影,无字幕无水印。", "seconds": 30, "resolution": "720p", "aspect_ratio": "16:9", "images": ["https://你的域名/ref1.jpg", "https://你的域名/ref2.jpg"], "videos": ["https://你的域名/ref.mp4"], "audios": ["https://你的域名/bgm.mp3"] }'
成功返回(HTTP 200):
{"task_id":"task_xxxxxxxx","status":"queued","progress":0,"model":"经典系列/sd2.5(...)","object":"video"}
轮询(建议 5–10 秒一次,客户端超时设 300 秒以上):
curl -H "Authorization: Bearer sk-你的令牌" \ https://suanliai.top/v1/videos/task_xxxxxxxx
status 为 completed 时取结果 URL 播放或下载;也可直接下载原片:
curl -L -H "Authorization: Bearer sk-你的令牌" \ "https://suanliai.top/v1/videos/task_xxxxxxxx/content" -o out.mp4
Python(任意 OpenAI SDK / httpx 均可,无需专用 SDK):
import requests, time H = {"Authorization": "Bearer sk-你的令牌"} body = { "model": "经典系列/sd2.0-fast(9图3音/4-15秒/分辨率可选)", "prompt": "高质量武侠打斗动画,雨夜屋顶对决,电影级运镜,无字幕", "seconds": 15, "resolution": "720p", "aspect_ratio": "16:9", } t = requests.post("https://suanliai.top/v1/videos", json=body, headers=H, timeout=60).json()["task_id"] while True: j = requests.get("https://suanliai.top/v1/videos/" + t, headers=H, timeout=60).json() if j["status"] in ("completed", "SUCCESS", "failed", "FAILURE"): break time.sleep(8) print(j)
11.4 计费与常见问题
- 按条计费:价格只由
model+resolution决定,和seconds、参考素材数量无关。提交时预扣,任务失败自动原路退回(不扣费)。 seconds写数字就行:部分上游要求字符串格式,平台已在网关层自动适配,客户无需按模型记忆差异。- 不要传
1080p想拿更高清:本系列只卖 480P/720P,传了会自动收敛到 720P,不会额外扣费。 - 「请求未被接受」400:先查 ① 提示词里
@图片N是否超过实传张数;②sd2.0系列是否误传了videos;③ 素材链接是否公网可访问;④ 模型名是否完整复制。失败不扣费,把「请求编号」发给客服可查。 - 视频为异步任务,提交 200 只代表已受理,最终以轮询
status为准。
> 价格以控制台与 /api/pricing 为准。经典系列 5 个型号已于 2026-11-16 完成全参数真实出片验证。