S
本系统客户接口
视频生成 API 接入指南 · 按账号余额计费
请求域名 https://test12.5ghcy.com/apis.php?path=/<endpoint>

怎么开始:登录 video.php → 个人中心 复制 API 密钥,请求域名就是 https://test12.5ghcy.com/apis.php?path=/<endpoint>,Authorization 填你的密钥即可,下面示例可直接照抄。

视频生成 API

本页文档面向本系统注册用户:鉴权用你自己账号的 API 密钥(登录 video.php → 个人中心 → API 密钥 复制,建号时自动生成、不可编辑),每次提交按你账号余额扣费、生成失败自动退回。覆盖:① 创建视频(POST /v1/videos)② 轮询视频任务并获取下载链接(GET /v1/videos/{job_id} & /signed_url)③ 余额与任务列表两个只读接口(GET /v1/balance、GET /v1/videos)④ 模型明细(见第 4 节)。所有路径均挂在 ?path= query 参数,鉴权使用 Authorization: Bearer sk-...(填你自己的客户密钥,不是第三方平台的 Key)。

OpenAPI Skill: video Bearer auth 幂等键:Idempotency-Key 状态轮询 8 个模型:新SD2.5 / 按秒SD2.5 / 按次SD2.5 / wan3 / 按次sd2.5 / 按秒sd2.5 / Minimax-H3 / SD2.0fast 余额 / 生效价:GET /v1/balance 任务列表:GET /v1/videos

0概述

所有接口都通过同一个请求域名 https://test12.5ghcy.com/apis.php,业务路径挂在 query 参数 ?path= 上(需 URL-encode)。请求体是 JSON,响应亦为 JSON。鉴权 header 为 Authorization: Bearer sk-...。

主链路

1 · 创建视频POST /v1/videos→
2 · 轮询任务GET /v1/videos/{job_id}→
3 · 下载成片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

名称类型是否必填说明
Authorizationstring必填格式 Bearer sk-...,填你自己账号的 API 密钥(个人中心 复制,建号/注册时自动生成、不可编辑)。这是本系统签发的客户密钥,与第三方平台的 Key 无关:请求进来后先用它定位你的账号,再查出你名下绑定的 Key 池 Key 去提交生成。余额、扣费、任务历史全部按这个账号隔离。
Content-TypestringJSON 请求必填填 application/json(所有接口的请求体都是 JSON,没有裸字节上传)。
Idempotency-Keystring推荐≤ 200 字符,作用域为你的账号。同一账号 + 同一 body 重试不会重复扣费。

调用示例

先打一个只读接口确认 Key 有效(余额与生效价):

cURL
curl -sS 'https://test12.5ghcy.com/apis.php?path=%2Fv1%2Fbalance' \
  -H 'Authorization: Bearer sk-xxxx'

响应(成功)

JSON
{
  "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 条独立专线,模型分属不同线路,请求方式一样,底下的通道不一样。下面每张卡是一条专线 —— 提交前扫一眼就知道该用哪条、素材该怎么传。

VIP专线2 专线2(zy 通道 · SD2.5 系列)

一段式提交(没有报价步骤);素材只用 image_urls / audio_b64s;成片是上游直链,24 小时有效(每次给新的)

模型新SD2.5
提交方式一段式(直接提交)
素材怎么传image_urls / audio_b64s(不支持 asset_id)
成片链接上游直链,24 小时有效
任务 typenewsd
VIP专线3 专线3(haya 通道 · SD2.5 系列)

一段式提交;素材只用 image_urls / audio_b64s / video_b64s;成片是上游签名直链,24 小时有效(每次给新的)

模型按秒SD2.5 / 按次SD2.5
提交方式一段式(直接提交)
素材怎么传image_urls / audio_b64s / video_b64s(不支持 asset_id)
成片链接上游签名直链,24 小时有效
任务 typehaya
VIP专线4 专线4(lj 通道 · wan3 等)

一段式提交(带幂等键);素材只用 image_urls / audio_b64s / video_b64s;成片是上游签名直链(每次给新的)

模型wan3 / 按次sd2.5 / 按秒sd2.5 / Minimax-H3 / SD2.0fast
提交方式一段式(直接提交,带幂等键)
素材怎么传image_urls / audio_b64s / video_b64s(不支持 asset_id)
成片链接上游签名直链,每次给新的
任务 typelj

模型矩阵

可选 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。

请求字段

字段类型约束说明
promptstring必填 · 上限随 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。
modelenum必填 见上方「模型矩阵」(动态渲染):newsd25 · yb25_480p · fy25_1080p · lj_wan3_call · lj_sd25full_call · lj_sd25fullsec_call · lj_h3_call · lj_sd20fast_call。
durationinteger必填 · 随 model 视频时长(秒)。每个模型的可选秒数见「模型矩阵」,传不支持的秒数返回 422(不扣费)。
ratioenum可选 · 随 model 画幅,白名单随模型(见「模型矩阵」)。不传默认 16:9;传了该模型不支持的值返回 422。
resolutionenum可选 · 随 model 分辨率档位,白名单随模型(见「模型矩阵」)。不传用该模型默认档;传了该模型没有的档位返回 422。
modeenum可选 参考方式:reference(多素材参考,默认)。frames(首尾帧)当前没有模型开放,传了会被拒。
assetsarray可选 · 推荐 新协议的推荐传法:先 POST /v1/files 上传素材拿 asset_id,再在这里引用。数组元素形如 { "asset_id": "b9f4...", "kind": "image" },kind 取 image / audio / video(不传按 image 算)。素材必须是自己账号上传的,否则 422。
image_urlsstring[]可选 · 上限随 model 参考图公网直链(也接受单个 image_url)。服务端代为下载(带 SSRF 防护:只收公网 http(s)),每张 ≤ 10 MiB,最多 3 次重定向。数量上限随模型,见「模型矩阵」。
audio_b64sstring[]可选 · 上限随 model 多段参考音频 base64(MP3 / M4A / WAV / OGG / FLAC)。每个模型的段数上限见「模型矩阵」,超了返回 422。
video_b64sstring[]可选 · 上限随 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_movementenum已废弃 早期字段,现在传了不生效(不会报错,也不会改变生成结果),保留只是兼容老客户端。运镜请写进 prompt。

cURL · 纯文本生成

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
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
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
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
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
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)

JSON
{
  "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
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..."
}'
JSON · 201
{
  "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
curl -sS 'https://test12.5ghcy.com/apis.php?path=%2Fv1%2Fvideos%2F12' \
  -H 'Authorization: Bearer sk-xxxx'

响应字段

字段类型约束说明
idstring必返任务 id,与 URL 中的 {job_id} 一致。
statusenum必返任务状态:queued / running / succeeded / failed。
filestring条件返回succeeded 时为签名下载 URL(绝对或站点相对),600 秒有效;其他状态为空串。
download_urlstring条件返回同 file,便于跨 SDK 兼容。
video_urlstring已废弃始终为空,仅保留字段名兼容。
errorstring条件返回failed 时为错误描述;其他状态为空串。退款金额请以余额账本为准。
retryableboolean恒为 false未提供 retry 接口;重提交(带同一 Idempotency-Key + 同一 body)会返回原任务。
retry_reasonstring可选信息性提示字段,不要作为任务状态或指令使用。
cancelableboolean恒为 false不支持取消。
cancel_reasonstring恒为 "unsupported"——

响应(running)

JSON
{
  "id": "12",
  "status": "running",
  "file": "",
  "download_url": "",
  "video_url": "",
  "error": "",
  "retryable": false,
  "retry_reason": "",
  "cancelable": false,
  "cancel_reason": "unsupported"
}

响应(succeeded)

JSON
{
  "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)

JSON
{
  "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
curl -sS 'https://test12.5ghcy.com/apis.php?path=%2Fv1%2Fvideos%2F12%2Fsigned_url' \
  -H 'Authorization: Bearer sk-xxxx'

响应字段

字段类型约束说明
urlstring必返首方下载 URL(绝对或站点相对)。若为相对路径需拼上基址解析,不要无脑前缀。免鉴权。
expires_atinteger必返Unix 秒,发出后 600 秒过期。过期请重新请求新链接。
qualityenum必返preview(预览)或 original(原画质)。

响应

JSON
{
  "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
curl -sS 'https://test12.5ghcy.com/apis.php?path=%2Fv1%2Fbalance' \
  -H 'Authorization: Bearer sk-xxxx'

响应字段

字段类型约束说明
user_idinteger必返账号 id。
usernamestring必返账号名。
balancenumber必返当前可用余额(元)。失败任务已自动退回。
pricingobject必返生效价表,见下。
pricing.videonumber必返默认模型(newsd25)首个秒数的单价。
pricing.video_cellsobject必返模型 × 秒数 的单价与开关:{ "newsd25": { "5": { "price": 4, "enabled": true } } }。enabled:false 的档位提交时返回 422。

任务列表 · GET /v1/videos

列出你自己账号的视频 / 图片任务,按 id 倒序。Query 参数:page(默认 1)、limit(默认 20,最大 100)、type(可选 video / image,不传=全部)。

cURL
curl -sS 'https://test12.5ghcy.com/apis.php?path=%2Fv1%2Fvideos&page=1&limit=20&type=video' \
  -H 'Authorization: Bearer sk-xxxx'

响应字段

字段类型约束说明
objectstring恒为 "list"——
totalinteger必返符合条件的任务总数。
pageinteger必返当前页码。
limitinteger必返每页条数。
data[]array必返任务数组,字段见下。
data[].id / job_idstring必返任务 id,可直接拿去轮询 /v1/videos/{id}。
data[].typestring必返任务类型:video / image / newsd 等。
data[].statusenum必返同视频状态机:queued / running / succeeded / failed。
data[].costnumber必返该任务实际扣掉的余额。
data[].created_atinteger必返创建时间(Unix 秒)。
data[].download_urlstring条件返回成功任务的成品链接(直链,可能过期);未成功为空串。要长期有效的签名链接请调 /v1/videos/{id}/signed_url。
data[].errorobject|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、limit 1–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

模型 id
newsd25
名称
新SD2.5
时长
5 ~ 30 秒(逐秒,26 档)
分辨率
1080p
画幅
16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9
参考素材
图 ≤ 9 · 音频 ≤ 3 · 视频 不支持
参考音频必须搭配参考图或参考视频(上游不收单独的音频)
prompt
≤ 10000 字

专线3(haya 通道 · SD2.5 系列)

按秒SD2.5

模型 id
yb25_480p
名称
按秒SD2.5
时长
4 ~ 30 秒(逐秒,27 档)
分辨率
480p
画幅
16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9
参考素材
图 ≤ 30 · 音频 ≤ 10 · 视频 ≤ 10
prompt
≤ 5000 字

按次SD2.5

模型 id
fy25_1080p
名称
按次SD2.5
时长
5 ~ 15 秒(逐秒,11 档)
分辨率
1080p
画幅
16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9
参考素材
图 ≤ 30 · 音频 ≤ 10 · 视频 ≤ 10
prompt
≤ 10000 字

专线4(lj 通道 · wan3 等)

wan3

模型 id
lj_wan3_call
名称
wan3
时长
30(逐秒,1 档)
分辨率
1080p
画幅
16:9 / 9:16
参考素材
图 ≤ 10 · 音频 ≤ 5 · 视频 ≤ 5
prompt
≤ 5000 字

按次sd2.5

模型 id
lj_sd25full_call
名称
按次sd2.5
时长
4 ~ 30 秒(逐秒,27 档)
分辨率
无此字段
画幅
16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9
参考素材
图 ≤ 30 · 音频 ≤ 10 · 视频 不支持
prompt
≤ 10000 字

按秒sd2.5

模型 id
lj_sd25fullsec_call
名称
按秒sd2.5
时长
4 ~ 30 秒(逐秒,27 档)
分辨率
无此字段
画幅
16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9
参考素材
图 ≤ 30 · 音频 ≤ 10 · 视频 不支持
prompt
≤ 10000 字

Minimax-H3

模型 id
lj_h3_call
名称
Minimax-H3
时长
15(逐秒,1 档)
分辨率
720p
画幅
16:9 / 9:16
参考素材
图 ≤ 8 · 音频 ≤ 3 · 视频 ≤ 3
prompt
≤ 10000 字

SD2.0fast

模型 id
lj_sd20fast_call
名称
SD2.0fast
时长
5 ~ 15 秒(逐秒,3 档)
分辨率
720p
画幅
16:9 / 9:16
参考素材
图 ≤ 9 · 音频 ≤ 3 · 视频 ≤ 3
prompt
≤ 10000 字

几个坑(提交前扫一眼)

① 素材方式按专线走 —— 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 是中文说明,可直接展示给用户):

JSON
{
  "error": {
    "type": "validation_error",
    "message": "ratio 不合法:99:1(该模型可选 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9)"
  }
}

HTTP 状态码

按端点区分。下表列出本页覆盖的全部端点实际返回的状态码:

状态码端点含义 & 建议
200GET /v1/videos/{id} · /signed_url · /file · /v1/balance · GET /v1/videos(列表) · /v1/bridge/*成功。
201POST /v1/files素材上传成功,返回 asset_id。
202POST /v1/videos异步任务已接受,立即返回 job_id。
400POST /v1/videos请求体无法解析或 schema 严重不符(如非 JSON)。
401全部API 密钥缺失或无效(unauthorized)。
402POST /v1/videos你账号余额不足(insufficient_balance),本次未扣费。
403全部账号已禁用,或该账号尚未分配生成 Key(account_unavailable),请联系代理 / 管理员。
404GET 端点任务不存在,或不属于你的账号(not_found)。
409GET /v1/videos/{id}/signed_url · /file文件尚未就绪,或任务已失败(file_not_ready),稍后再试。
422POST /v1/videos · POST /v1/files字段不合法 / 模型或时长不支持 / 模型已下架 / 参考素材超限 / 素材不属于本账号(validation_error)。
502POST /v1/files素材服务异常(upstream_error)。
500全部服务端错误(internal_error)。

error.type 枚举(节选)

validation_error invalid_request unauthorized account_unavailable insufficient_balance not_found file_not_ready payload_too_large upstream_error generation_failed

重试原则:对于 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 字段以服务方实现为准