0概述
所有接口都通过同一个请求域名 https://test12.5ghcy.com/apis.php,业务路径挂在 query 参数 ?path= 上(需 URL-encode)。请求体是 JSON,响应亦为 JSON。鉴权 header 为 Authorization: Bearer sk-...。
主链路
POST /v1/videos→GET /v1/videos/{job_id}→GET /v1/videos/{job_id}/signed_url另外两个只读接口(不产生任务、不扣费,随便调):GET /v1/balance(余额与本账号生效价)、GET /v1/videos(任务列表)。
端点总览
下面这张表自动生成 —— 和服务端路由同一份数据(ApiRoutes):加端点、删端点、404 提示里的清单,文档这边自动跟着变,不会写着写着就漏。
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /v1/balance | 余额与生效价 —— 查余额 + 这个账号当下真正生效的单价(模型 × 秒数)。只读,不扣费。 |
| POST | /v1/files | 上传参考素材 —— 上传图片/音频/视频素材,换一个 asset_id(专线1 专用)。 |
| POST | /v1/videos | 提交视频任务 —— 受理即扣费,立刻返回 202 + job_id。 |
| GET | /v1/videos(列表) | 任务列表 —— 列出本账号的视频 / 图片任务,分页。只读。 |
| GET | /v1/videos/{job_id}、/v1/videos/{job_id}/signed_url、/v1/videos/{job_id}/file | 轮询任务 / 取下载地址 —— 查任务状态;加 /signed_url 或 /file 再取签名下载链接。 |
| GET | /v1/bridge/key_check | 桥接 · 校验 Key —— 只读:校验 Key 是否有效,返回账号标识与余额。 |
| GET | /v1/bridge/videos | 桥接 · 视频列表 —— 只读:本账号生成成功的视频分页列表。 |
状态机(视频)
中间态 queued → running → 终态 succeeded 或 failed。只有 succeeded 时 file / download_url 才会返回有效签名链接。
幂等性:POST 提交请带上 Idempotency-Key header(最大 200 字符,按 API key 作用域内去重)。同一 key + 同一 body 重试直接返回原 job_id,不会重复扣费;改 body 会返回 409。
⚙鉴权 & 请求约定
公共 Header
| 名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| Authorization | string | 必填 | 格式 Bearer sk-...,填你自己账号的 API 密钥(个人中心 复制,建号/注册时自动生成、不可编辑)。这是本系统签发的客户密钥,与第三方平台的 Key 无关:请求进来后先用它定位你的账号,再查出你名下绑定的 Key 池 Key 去提交生成。余额、扣费、任务历史全部按这个账号隔离。 |
| Content-Type | string | JSON 请求必填 | 填 application/json(所有接口的请求体都是 JSON,没有裸字节上传)。 |
| Idempotency-Key | string | 推荐 | ≤ 200 字符,作用域为你的账号。同一账号 + 同一 body 重试不会重复扣费。 |
调用示例
先打一个只读接口确认 Key 有效(余额与生效价):
curl -sS 'https://test12.5ghcy.com/apis.php?path=%2Fv1%2Fbalance' \
-H 'Authorization: Bearer sk-xxxx'
响应(成功)
{
"user_id": 21,
"username": "your_account",
"balance": 100,
"pricing": {
"video": 4,
"video_cells": { "newsd25": { "5": { "price": 4, "enabled": true } } },
"image": 1
}
}
Key 无效返回 401;账号被禁用或没分配生成 Key 返回 403。完整字段见 第 3 节。
1创建视频 POST /v1/videos
提交一段视频生成任务。立即返回 202 + job_id,不等待生成完成。生成结果通过轮询接口拉取。
请求体:JSON。model / duration 为必填字段,resolution 随模型(不传用该模型默认档);model 与 duration 需按下表组合取值,画幅默认 16:9。
3 条专线的差异(先看这个)
平台有3 条独立专线,模型分属不同线路,请求方式一样,底下的通道不一样。下面每张卡是一条专线 —— 提交前扫一眼就知道该用哪条、素材该怎么传。
一段式提交(没有报价步骤);素材只用 image_urls / audio_b64s;成片是上游直链,24 小时有效(每次给新的)
newsd一段式提交;素材只用 image_urls / audio_b64s / video_b64s;成片是上游签名直链,24 小时有效(每次给新的)
haya一段式提交(带幂等键);素材只用 image_urls / audio_b64s / video_b64s;成片是上游签名直链(每次给新的)
lj模型矩阵
可选 model 共 8 个,按专线分组 —— 下表直接读后台的模型目录和开关:模型下架会自动从本页消失,某个秒数被后台关掉会标成「已关闭」(提交那个秒数返回 422)。传了表外的值一律 422(不扣费)。
专线2(zy 通道 · SD2.5 系列)
一段式提交(没有报价步骤);素材只用 image_urls / audio_b64s;成片是上游直链,24 小时有效(每次给新的)
| model | 名称 | 可选 duration | 参考图 | 参考音频 | 参考视频 | 画幅 ratio | 分辨率 | prompt 上限 | 状态 |
|---|---|---|---|---|---|---|---|---|---|
| newsd25 | 新SD2.5 | 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17 / 18 / 19 / 20 / 21 / 22 / 23 / 24 / 25 / 26 / 27 / 28 / 29 / 30 | ≤ 9 | ≤ 3 | — | 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 | 1080p (默认 1080p) |
10000 字 | 可用 |
专线3(haya 通道 · SD2.5 系列)
一段式提交;素材只用 image_urls / audio_b64s / video_b64s;成片是上游签名直链,24 小时有效(每次给新的)
| model | 名称 | 可选 duration | 参考图 | 参考音频 | 参考视频 | 画幅 ratio | 分辨率 | prompt 上限 | 状态 |
|---|---|---|---|---|---|---|---|---|---|
| yb25_480p | 按秒SD2.5 | 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17 / 18 / 19 / 20 / 21 / 22 / 23 / 24 / 25 / 26 / 27 / 28 / 29 / 30 | ≤ 30 | ≤ 10 | ≤ 10 | 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 | 480p (默认 480p) |
5000 字 | 可用 |
| fy25_1080p | 按次SD2.5 | 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 | ≤ 30 | ≤ 10 | ≤ 10 | 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 | 1080p (默认 1080p) |
10000 字 | 可用 |
专线4(lj 通道 · wan3 等)
一段式提交(带幂等键);素材只用 image_urls / audio_b64s / video_b64s;成片是上游签名直链(每次给新的)
| model | 名称 | 可选 duration | 参考图 | 参考音频 | 参考视频 | 画幅 ratio | 分辨率 | prompt 上限 | 状态 |
|---|---|---|---|---|---|---|---|---|---|
| lj_wan3_call | wan3 | 30 | ≤ 10 | ≤ 5 | ≤ 5 | 16:9 / 9:16 | 1080p (默认 1080p) |
5000 字 | 可用 |
| lj_sd25full_call | 按次sd2.5 | 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17 / 18 / 19 / 20 / 21 / 22 / 23 / 24 / 25 / 26 / 27 / 28 / 29 / 30 | ≤ 30 | ≤ 10 | — | 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 | 无此字段 | 10000 字 | 可用 |
| lj_sd25fullsec_call | 按秒sd2.5 | 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17 / 18 / 19 / 20 / 21 / 22 / 23 / 24 / 25 / 26 / 27 / 28 / 29 / 30 | ≤ 30 | ≤ 10 | — | 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 | 无此字段 | 10000 字 | 可用 |
| lj_h3_call | Minimax-H3 | 15 | ≤ 8 | ≤ 3 | ≤ 3 | 16:9 / 9:16 | 720p (默认 720p) |
10000 字 | 可用 |
| lj_sd20fast_call | SD2.0fast | 5 / 10 / 15 | ≤ 9 | ≤ 3 | ≤ 3 | 16:9 / 9:16 | 720p (默认 720p) |
10000 字 | 可用 |
当前不可提交:sd25_480p(全部时长都被后台关掉了)、lj_sd25flash_call(全部时长都被后台关掉了) —— 提交这些模型一律返回 422。
「已下架」是什么意思:后台「菜单配置」里把这个模型关了 —— 网页端不显示它、API 也拒收它(提交返回 422)。想彻底停用就把对应秒数的定价开关也关掉 —— 那样 GET /v1/balance 的 pricing.video_cells 里会标成 enabled:false,提交那个秒数同样返回 422。
最容易踩的坑:各模型的 ratio 白名单不一样 —— newsd25 / yb25_480p / fy25_1080p / lj_sd25full_call / lj_sd25fullsec_call → 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9;lj_wan3_call / lj_h3_call / lj_sd20fast_call → 16:9 / 9:16。
素材怎么传:新协议只认 asset_id。推荐先 POST /v1/files 上传素材拿 asset_id,再在 /v1/videos 里用 assets 传;也可以继续用 image_urls(服务端代为下载,带 SSRF 防护)/ audio_b64s / video_b64s,本站会转成 asset_id 再提交。参考图单张 ≤ 10 MiB,音视频单条 ≤ 50 MiB。
请求字段
| 字段 | 类型 | 约束 | 说明 |
|---|---|---|---|
| prompt | string | 必填 · 上限随 model | 视频内容描述。非空白字符串,UTF-8。字数上限随模型(newsd25 / fy25_1080p / lj_sd25full_call / lj_sd25fullsec_call / lj_h3_call / lj_sd20fast_call 10000 字;yb25_480p / lj_wan3_call 5000 字),超了返回 422。 |
| model | enum | 必填 | 见上方「模型矩阵」(动态渲染):newsd25 · yb25_480p · fy25_1080p · lj_wan3_call · lj_sd25full_call · lj_sd25fullsec_call · lj_h3_call · lj_sd20fast_call。 |
| duration | integer | 必填 · 随 model | 视频时长(秒)。每个模型的可选秒数见「模型矩阵」,传不支持的秒数返回 422(不扣费)。 |
| ratio | enum | 可选 · 随 model | 画幅,白名单随模型(见「模型矩阵」)。不传默认 16:9;传了该模型不支持的值返回 422。 |
| resolution | enum | 可选 · 随 model | 分辨率档位,白名单随模型(见「模型矩阵」)。不传用该模型默认档;传了该模型没有的档位返回 422。 |
| mode | enum | 可选 | 参考方式:reference(多素材参考,默认)。frames(首尾帧)当前没有模型开放,传了会被拒。 |
| assets | array | 可选 · 推荐 | 新协议的推荐传法:先 POST /v1/files 上传素材拿 asset_id,再在这里引用。数组元素形如 { "asset_id": "b9f4...", "kind": "image" },kind 取 image / audio / video(不传按 image 算)。素材必须是自己账号上传的,否则 422。 |
| image_urls | string[] | 可选 · 上限随 model | 参考图公网直链(也接受单个 image_url)。服务端代为下载(带 SSRF 防护:只收公网 http(s)),每张 ≤ 10 MiB,最多 3 次重定向。数量上限随模型,见「模型矩阵」。 |
| audio_b64s | string[] | 可选 · 上限随 model | 多段参考音频 base64(MP3 / M4A / WAV / OGG / FLAC)。每个模型的段数上限见「模型矩阵」,超了返回 422。 |
| video_b64s | string[] | 可选 · 上限随 model | 多段参考视频 base64(MP4 / MOV / WebM)。收参考视频的模型:yb25_480p ≤ 10 条、fy25_1080p ≤ 10 条、lj_wan3_call ≤ 5 条、lj_h3_call ≤ 3 条、lj_sd20fast_call ≤ 3 条;不收的模型(传了会被拒):newsd25、lj_sd25full_call、lj_sd25fullsec_call。 |
| camera_movement | enum | 已废弃 | 早期字段,现在传了不生效(不会报错,也不会改变生成结果),保留只是兼容老客户端。运镜请写进 prompt。 |
cURL · 纯文本生成
curl -sS -X POST 'https://test12.5ghcy.com/apis.php?path=%2Fv1%2Fvideos' \
-H 'Authorization: Bearer sk-xxxx' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: my-task-001' \
--data '{
"prompt": "一只橘猫在窗台晒太阳,镜头缓慢推进,电影感",
"model": "newsd25",
"duration": 30,
"resolution": "1080p",
"ratio": "16:9"
}'
cURL · 带参考图
参考图先传 POST /v1/files 拿 asset_id,再放进 assets;也可以直接给公网直链 image_urls(服务端代为下载)。
curl -sS -X POST 'https://test12.5ghcy.com/apis.php?path=%2Fv1%2Fvideos' \
-H 'Authorization: Bearer sk-xxxx' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: my-task-002' \
--data '{
"prompt": "女孩在海边奔跑,长发飘动",
"model": "newsd25",
"duration": 30,
"resolution": "1080p",
"ratio": "16:9",
"image_urls": ["https://cdn.example.com/face.png"]
}'
cURL · VIP专线2(新SD2.5)
字段跟上面一样(model / prompt / duration / ratio / resolution),两处不一样:① 素材用 image_urls / audio_b64s(不支持 asset_id)(asset_id 是专线1 图库里的 id,别的专线不认);② 提交是一段式(直接提交)。
curl -sS -X POST 'https://test12.5ghcy.com/apis.php?path=%2Fv1%2Fvideos' \
-H 'Authorization: Bearer sk-xxxx' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: my-task-vip-2-001' \
--data '{
"prompt": "女孩在海边奔跑,长发飘动,镜头缓慢跟拍",
"model": "newsd25",
"resolution": "1080p",
"duration": 30,
"ratio": "16:9" }'
cURL · VIP专线3(按秒SD2.5)
字段跟上面一样(model / prompt / duration / ratio / resolution),两处不一样:① 素材用 image_urls / audio_b64s / video_b64s(不支持 asset_id)(asset_id 是专线1 图库里的 id,别的专线不认);② 提交是一段式(直接提交)。
curl -sS -X POST 'https://test12.5ghcy.com/apis.php?path=%2Fv1%2Fvideos' \
-H 'Authorization: Bearer sk-xxxx' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: my-task-vip-3-001' \
--data '{
"prompt": "女孩在海边奔跑,长发飘动,镜头缓慢跟拍",
"model": "yb25_480p",
"resolution": "480p",
"duration": 30,
"ratio": "16:9" }'
cURL · VIP专线4(wan3)
字段跟上面一样(model / prompt / duration / ratio / resolution),两处不一样:① 素材用 image_urls / audio_b64s / video_b64s(不支持 asset_id)(asset_id 是专线1 图库里的 id,别的专线不认);② 提交是一段式(直接提交,带幂等键)。
curl -sS -X POST 'https://test12.5ghcy.com/apis.php?path=%2Fv1%2Fvideos' \
-H 'Authorization: Bearer sk-xxxx' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: my-task-vip-4-001' \
--data '{
"prompt": "女孩在海边奔跑,长发飘动,镜头缓慢跟拍",
"model": "lj_wan3_call",
"resolution": "1080p",
"duration": 30,
"ratio": "16:9" }'
cURL · 带参考视频
只有这几个模型收参考视频:yb25_480p / fy25_1080p / lj_wan3_call / lj_h3_call / lj_sd20fast_call。参考视频用 video_b64s 传(base64 的 MP4 / MOV);提示词里用 @视频1 引用它。
curl -sS -X POST 'https://test12.5ghcy.com/apis.php?path=%2Fv1%2Fvideos' \
-H 'Authorization: Bearer sk-xxxx' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: my-task-video-001' \
--data '{
"prompt": "参考视频里的动作,套到图片1 的人物身上,保留镜头",
"model": "yb25_480p",
"resolution": "480p",
"duration": 30,
"ratio": "16:9",
"image_urls": ["https://cdn.example.com/face.png"],
"video_b64s": [""] }'
响应(202)
{
"id": "12",
"status": "queued",
"idempotent": "1"
}
立即返回 job_id,status 通常为 queued;偶发秒级进入 running。请勿轮询过快——后端一般 5s 一次足够(极端 2s);429 时按 Retry-After 退避。
素材上传 · POST /v1/files
新协议只认 asset_id:参考素材先传到本站换 asset_id,再在 /v1/videos 的 assets 里引用。name 必填,image_b64 / audio_b64 / video_b64 三选一(纯 base64 或 data URL 都收)。
curl -sS -X POST 'https://test12.5ghcy.com/apis.php?path=%2Fv1%2Ffiles' \
-H 'Authorization: Bearer sk-xxxx' \
-H 'Content-Type: application/json' \
--data '{
"name": "ref.png",
"image_b64": "iVBORw0KGgo..."
}'
{
"asset_id": "b9f48ce34c1a4614801654d99301717b",
"kind": "image",
"name": "ref.png",
"mime": "image/png",
"size_bytes": 1485,
"sha256": "839c5181..."
}
限制:图片 ≤ 10 MiB,音视频 ≤ 50 MiB;素材是持久的(同一个 sha256 重复上传会复用同一份),提交时只能用自己账号上传的 asset_id。也可以不调这个接口,直接在 /v1/videos 里传 image_urls / audio_b64s / video_b64s,本站会代为转成 asset_id。
2轮询 & 下载
视频生成是异步任务,通过轮询 GET /v1/videos/{job_id} 拿到最新状态;状态到达 succeeded 后从响应的 file / download_url 取签名下载链接(10 分钟有效,过期请重新调此接口或单独调 /signed_url)。
轮询 · GET /v1/videos/{job_id}
curl -sS 'https://test12.5ghcy.com/apis.php?path=%2Fv1%2Fvideos%2F12' \
-H 'Authorization: Bearer sk-xxxx'
响应字段
| 字段 | 类型 | 约束 | 说明 |
|---|---|---|---|
| id | string | 必返 | 任务 id,与 URL 中的 {job_id} 一致。 |
| status | enum | 必返 | 任务状态:queued / running / succeeded / failed。 |
| file | string | 条件返回 | succeeded 时为签名下载 URL(绝对或站点相对),600 秒有效;其他状态为空串。 |
| download_url | string | 条件返回 | 同 file,便于跨 SDK 兼容。 |
| video_url | string | 已废弃 | 始终为空,仅保留字段名兼容。 |
| error | string | 条件返回 | failed 时为错误描述;其他状态为空串。退款金额请以余额账本为准。 |
| retryable | boolean | 恒为 false | 未提供 retry 接口;重提交(带同一 Idempotency-Key + 同一 body)会返回原任务。 |
| retry_reason | string | 可选 | 信息性提示字段,不要作为任务状态或指令使用。 |
| cancelable | boolean | 恒为 false | 不支持取消。 |
| cancel_reason | string | 恒为 "unsupported" | —— |
响应(running)
{
"id": "12",
"status": "running",
"file": "",
"download_url": "",
"video_url": "",
"error": "",
"retryable": false,
"retry_reason": "",
"cancelable": false,
"cancel_reason": "unsupported"
}
响应(succeeded)
{
"id": "12",
"status": "succeeded",
"file": "https://cdn.example.com/v_c8d2...mp4?exp=...&sig=...",
"download_url": "https://cdn.example.com/v_c8d2...mp4?exp=...&sig=...",
"video_url": "",
"error": "",
"retryable": false,
"retry_reason": "",
"cancelable": false,
"cancel_reason": "unsupported"
}
响应(failed)
{
"id": "12",
"status": "failed",
"file": "",
"download_url": "",
"video_url": "",
"error": "content_policy_violation: prompt contains disallowed content",
"retryable": false,
"retry_reason": "submission_rejected",
"cancelable": false,
"cancel_reason": "unsupported"
}
下载 · GET /v1/videos/{job_id}/signed_url
仅在 succeeded 后可用。返回一条新的 600 秒有效签名链接,可用于刷新过期链接、写入自己的存储等场景。
curl -sS 'https://test12.5ghcy.com/apis.php?path=%2Fv1%2Fvideos%2F12%2Fsigned_url' \
-H 'Authorization: Bearer sk-xxxx'
响应字段
| 字段 | 类型 | 约束 | 说明 |
|---|---|---|---|
| url | string | 必返 | 首方下载 URL(绝对或站点相对)。若为相对路径需拼上基址解析,不要无脑前缀。免鉴权。 |
| expires_at | integer | 必返 | Unix 秒,发出后 600 秒过期。过期请重新请求新链接。 |
| quality | enum | 必返 | preview(预览)或 original(原画质)。 |
响应
{
"url": "/v1/videos/v_c8d2.../file?exp=1700003600&sig=abcdef...",
"expires_at": 1700003600,
"quality": "original"
}
轮询建议:建议间隔 3–5 秒;不要并发打同一 job_id(拿到 succeeded 后立刻停)。429 时按响应 header Retry-After 退避(秒)。
3余额 & 任务列表
两个只读接口:不产生任务、不扣费,可以随便调。
余额与生效价 · GET /v1/balance
返回账号余额,以及你这个账号当下真正生效的单价(模型 × 秒数)。代理商可能有覆盖价,提交前先查这里的价,别用别处的报价。
curl -sS 'https://test12.5ghcy.com/apis.php?path=%2Fv1%2Fbalance' \
-H 'Authorization: Bearer sk-xxxx'
响应字段
| 字段 | 类型 | 约束 | 说明 |
|---|---|---|---|
| user_id | integer | 必返 | 账号 id。 |
| username | string | 必返 | 账号名。 |
| balance | number | 必返 | 当前可用余额(元)。失败任务已自动退回。 |
| pricing | object | 必返 | 生效价表,见下。 |
| pricing.video | number | 必返 | 默认模型(newsd25)首个秒数的单价。 |
| pricing.video_cells | object | 必返 | 模型 × 秒数 的单价与开关:{ "newsd25": { "5": { "price": 4, "enabled": true } } }。enabled:false 的档位提交时返回 422。 |
任务列表 · GET /v1/videos
列出你自己账号的视频 / 图片任务,按 id 倒序。Query 参数:page(默认 1)、limit(默认 20,最大 100)、type(可选 video / image,不传=全部)。
curl -sS 'https://test12.5ghcy.com/apis.php?path=%2Fv1%2Fvideos&page=1&limit=20&type=video' \
-H 'Authorization: Bearer sk-xxxx'
响应字段
| 字段 | 类型 | 约束 | 说明 |
|---|---|---|---|
| object | string | 恒为 "list" | —— |
| total | integer | 必返 | 符合条件的任务总数。 |
| page | integer | 必返 | 当前页码。 |
| limit | integer | 必返 | 每页条数。 |
| data[] | array | 必返 | 任务数组,字段见下。 |
| data[].id / job_id | string | 必返 | 任务 id,可直接拿去轮询 /v1/videos/{id}。 |
| data[].type | string | 必返 | 任务类型:video / image / newsd 等。 |
| data[].status | enum | 必返 | 同视频状态机:queued / running / succeeded / failed。 |
| data[].cost | number | 必返 | 该任务实际扣掉的余额。 |
| data[].created_at | integer | 必返 | 创建时间(Unix 秒)。 |
| data[].download_url | string | 条件返回 | 成功任务的成品链接(直链,可能过期);未成功为空串。要长期有效的签名链接请调 /v1/videos/{id}/signed_url。 |
| data[].error | object|null | 条件返回 | 失败时为 { "type": "generation_failed", "message": "..." },成功时为 null。 |
桥接专用 · GET /v1/bridge/key_check · /v1/bridge/videos
给「混剪平台」这类第三方站点做绑定校验用的只读接口,普通调用方用不到。
GET /v1/bridge/key_check—— 校验 Key 是否有效并返回账号标识:{ "user_id": 21, "username": "your_account", "balance": 100 }(不产生任何业务数据)。GET /v1/bridge/videos—— 当前账号「生成成功」的 Seedance 视频分页列表(page≥ 1、limit1–50,默认 20),字段:id/prompt(截断 200 字)/model/duration/ratio/result_url(相对路径已补成绝对地址)/storage_driver/created_at/finished_at。
4模型明细
逐个模型列参数(时长 / 画幅 / 分辨率 / 素材上限),给你的请求字段跟第 1 节完全一致 —— 你按第 1 节的写法提交就行,平台会自动把任务派给对应线路的 worker。
专线2(zy 通道 · SD2.5 系列)
新SD2.5
参考音频必须搭配参考图或参考视频(上游不收单独的音频)
专线3(haya 通道 · SD2.5 系列)
按秒SD2.5
按次SD2.5
专线4(lj 通道 · wan3 等)
wan3
按次sd2.5
按秒sd2.5
Minimax-H3
SD2.0fast
几个坑(提交前扫一眼)
① 素材方式按专线走 —— POST /v1/files 拿到的 asset_id 只在专线1 认;其它专线请用 image_urls(公网直链)/ audio_b64s / video_b64s(base64),平台会先落盘再由后台任务推上游。
2 VIP专线2 —— 素材:image_urls / audio_b64s(不支持 asset_id);提交:一段式(直接提交);成片:上游直链,24 小时有效;任务在列表里 type 是 newsd。
3 VIP专线3 —— 素材:image_urls / audio_b64s / video_b64s(不支持 asset_id);提交:一段式(直接提交);成片:上游签名直链,24 小时有效;任务在列表里 type 是 haya。
4 VIP专线4 —— 素材:image_urls / audio_b64s / video_b64s(不支持 asset_id);提交:一段式(直接提交,带幂等键);成片:上游签名直链,每次给新的;任务在列表里 type 是 lj。
轮询永远用 /v1/videos/{job_id} —— 不管哪条专线、任务 type 是什么,URL 都一样。
当前可用的模型
| model | 名称 | 可选 duration | 参考图 | 参考音频 | 参考视频 | 画幅 ratio | 分辨率 | prompt 上限 | 状态 |
|---|---|---|---|---|---|---|---|---|---|
| newsd25 | 新SD2.5 | 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17 / 18 / 19 / 20 / 21 / 22 / 23 / 24 / 25 / 26 / 27 / 28 / 29 / 30 | ≤ 9 | ≤ 3 | — | 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 | 1080p (默认 1080p) |
10000 字 | 可用 |
| model | 名称 | 可选 duration | 参考图 | 参考音频 | 参考视频 | 画幅 ratio | 分辨率 | prompt 上限 | 状态 |
|---|---|---|---|---|---|---|---|---|---|
| yb25_480p | 按秒SD2.5 | 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17 / 18 / 19 / 20 / 21 / 22 / 23 / 24 / 25 / 26 / 27 / 28 / 29 / 30 | ≤ 30 | ≤ 10 | ≤ 10 | 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 | 480p (默认 480p) |
5000 字 | 可用 |
| fy25_1080p | 按次SD2.5 | 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 | ≤ 30 | ≤ 10 | ≤ 10 | 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 | 1080p (默认 1080p) |
10000 字 | 可用 |
| model | 名称 | 可选 duration | 参考图 | 参考音频 | 参考视频 | 画幅 ratio | 分辨率 | prompt 上限 | 状态 |
|---|---|---|---|---|---|---|---|---|---|
| lj_wan3_call | wan3 | 30 | ≤ 10 | ≤ 5 | ≤ 5 | 16:9 / 9:16 | 1080p (默认 1080p) |
5000 字 | 可用 |
| lj_sd25full_call | 按次sd2.5 | 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17 / 18 / 19 / 20 / 21 / 22 / 23 / 24 / 25 / 26 / 27 / 28 / 29 / 30 | ≤ 30 | ≤ 10 | — | 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 | 无此字段 | 10000 字 | 可用 |
| lj_sd25fullsec_call | 按秒sd2.5 | 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17 / 18 / 19 / 20 / 21 / 22 / 23 / 24 / 25 / 26 / 27 / 28 / 29 / 30 | ≤ 30 | ≤ 10 | — | 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 | 无此字段 | 10000 字 | 可用 |
| lj_h3_call | Minimax-H3 | 15 | ≤ 8 | ≤ 3 | ≤ 3 | 16:9 / 9:16 | 720p (默认 720p) |
10000 字 | 可用 |
| lj_sd20fast_call | SD2.0fast | 5 / 10 / 15 | ≤ 9 | ≤ 3 | ≤ 3 | 16:9 / 9:16 | 720p (默认 720p) |
10000 字 | 可用 |
!错误码 & 重试
所有非 2xx 响应体均为统一结构(error.type 是机器可读的分类,error.message 是中文说明,可直接展示给用户):
{
"error": {
"type": "validation_error",
"message": "ratio 不合法:99:1(该模型可选 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9)"
}
}
HTTP 状态码
按端点区分。下表列出本页覆盖的全部端点实际返回的状态码:
| 状态码 | 端点 | 含义 & 建议 |
|---|---|---|
| 200 | GET /v1/videos/{id} · /signed_url · /file · /v1/balance · GET /v1/videos(列表) · /v1/bridge/* | 成功。 |
| 201 | POST /v1/files | 素材上传成功,返回 asset_id。 |
| 202 | POST /v1/videos | 异步任务已接受,立即返回 job_id。 |
| 400 | POST /v1/videos | 请求体无法解析或 schema 严重不符(如非 JSON)。 |
| 401 | 全部 | API 密钥缺失或无效(unauthorized)。 |
| 402 | POST /v1/videos | 你账号余额不足(insufficient_balance),本次未扣费。 |
| 403 | 全部 | 账号已禁用,或该账号尚未分配生成 Key(account_unavailable),请联系代理 / 管理员。 |
| 404 | GET 端点 | 任务不存在,或不属于你的账号(not_found)。 |
| 409 | GET /v1/videos/{id}/signed_url · /file | 文件尚未就绪,或任务已失败(file_not_ready),稍后再试。 |
| 422 | POST /v1/videos · POST /v1/files | 字段不合法 / 模型或时长不支持 / 模型已下架 / 参考素材超限 / 素材不属于本账号(validation_error)。 |
| 502 | POST /v1/files | 素材服务异常(upstream_error)。 |
| 500 | 全部 | 服务端错误(internal_error)。 |
error.type 枚举(节选)
重试原则:对于 5xx / 网络错误 / 429,按指数退避 + 抖动重试;对于 4xx 中的 idempotency_in_progress(425)请 用同一 key + 同一 body 重试;对于 idempotency_conflict(409)必须重新生成 Idempotency-Key。所有响应均带 X-Request-ID header,遇到问题请带上它上报。
https://test12.5ghcy.com/apis.php · OpenAPI 字段以服务方实现为准