算力AI 接口文档返回主站

> ## 统一对接(推荐) > > 一份文档、一套参数,适用于站内全部模型。换模型只需改 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 条硬约束;平台会在提交前自动处理前两条,后两条直接说明原因并明确「本次未扣费」,不会再出现含糊的「参数不太符合要求」:

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 为准。

③ 用对话接口直调视频模型(兼容模式)

如果你的客户端或软件只支持 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": "视频已生成完成。\ \

说明
参数兼容模式下 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。

字段名按接口区分:

图片格式支持 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 张。

固定规格档单独说明(时长 / 清晰度固定;其中一组连比例也固定)

专享sd2.0(fast9图/4-15秒/720p) 单独说明(新上模型,完全按通用文档调用)

通用文档字段实际送上游说明
imagesimages最多 9 张,公网可直读的链接
videosvideo_refs参考视频;上游目录未声明上限,建议少量
audiosaudio_refs参考音频;同上
secondsduration4–15 的整数,超范围自动收敛
aspect_ratio / sizeaspect_ratiosize 换算比例后自动删除
resolutionresolution归一为 720P

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 }'

高质量福利sd2.0-fast(满血933/720P) 单独说明(按次计费,2026-11-15 实测出片)

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 }'

稳定高速sd2.5(30参任选/4-30秒/720P) 单独说明(按条计费,与输出时长无关)

稳定官渠sd2.0mini/fast、官转稳定满血sd2.0/2.5单独说明(按秒计费)

火山官方sd2.0(933) / 火山官方sd2.0fast(933) / 火山官方sd2.0mini(933) / 火山官方sd2.5(30-10-10)(官方直连,按 token 计费)

高质量特惠sd2.5(满血原生过真人30-10-10/720P) 单独说明(按次收费,与时长、张数无关)

专享wan3.0(满血10-5-5/2-15秒/分辨率可选) 单独说明(按条计费,与输出时长无关)

提示词引用参考图(@图片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,原样复制)480P720P时长 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 计费与常见问题

> 价格以控制台与 /api/pricing 为准。经典系列 5 个型号已于 2026-11-16 完成全参数真实出片验证。