Seedance 2.0 VIP3 视频生成接口说明

泽西童学主站视频任务接口，支持文生视频、图生视频、任务查询和鉴权下载。示例均使用主站对外地址，不包含第三方域名或账号信息。

基础信息

项目	值
基础地址	`https://zexitongxue.com`
视频任务入口	`POST /v1/videos`
鉴权方式	`Authorization: Bearer YOUR_API_KEY`
请求格式	`Content-Type: application/json`
推荐轮询间隔	`5` 秒

请使用当前账号分配的 API Key。不要在公开页面、截图或群聊中泄露完整密钥。

适用模型

`sora-vip3-pro-720p`

支持 480p、720p 输出，适合常规短视频与预览生成。

`sora-vip3-pro-1080p`

支持 480p、720p、1080p 输出，适合正式交付和高清素材。

创建视频任务

方法	路径	说明
`POST`	`/v1/videos`	提交文生视频或图生视频任务，成功后返回任务 ID。

文生视频请求体

{
  "model": "sora-vip3-pro-720p",
  "prompt": "雨夜霓虹街道，镜头缓慢推进，电影感光影",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "seconds": "5"
}

图生视频请求体

{
  "model": "sora-vip3-pro-1080p",
  "prompt": "保持人物外貌和服装一致，自然缓慢走动",
  "image_url": "https://example.com/input-image.jpg",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "seconds": "5"
}

成功返回示例

{
  "id": "task_xxx",
  "object": "video",
  "model": "sora-vip3-pro-720p",
  "status": "queued",
  "progress": 0,
  "created_at": 1779560000
}

查询任务状态

方法	路径	说明
`GET`	`/v1/videos/{task_id}`	查询任务状态、进度和完成后的结果地址。

完成态返回示例

{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "object": "video",
  "model": "sora-vip3-pro-1080p",
  "status": "completed",
  "progress": 100,
  "created_at": 1779560000,
  "completed_at": 1779560150,
  "seconds": "5",
  "size": "1920x1080",
  "video_url": "https://zexitongxue.com/v1/videos/task_xxx/content",
  "url": "https://zexitongxue.com/v1/videos/task_xxx/content"
}

状态	说明
`queued`	任务已提交，等待执行。
`in_progress`	任务执行中。
`completed`	任务完成，可读取 `video_url` 或 `url`。
`failed`	任务失败，请查看错误信息或重新提交。

下载视频内容

方法	路径	说明
`GET`	`/v1/videos/{task_id}/content`	返回视频二进制内容，通常为 `video/mp4`。

下载内容时同样需要携带 Authorization: Bearer YOUR_API_KEY。建议任务完成后尽快下载或转存到自己的存储。

支持参数

参数	类型	必填	说明
`model`	string	是	视频模型名。
`prompt`	string	是	视频生成提示词。
`aspect_ratio`	string	是	输出比例。
`resolution`	string	是	输出分辨率。
`seconds`	string / number	是	视频时长。
`image_url`	string	否	主参考图，用于图生视频。
`reference_image_urls`	array	否	多张参考图。
`reference_video`	string	否	参考视频。
`audio_url`	string	否	参考音频。

参数范围

类别	支持值
比例	`16:9`、`9:16`、`4:3`、`3:4`、`1:1`、`21:9`
时长	`5`、`10`、`15` 秒
`sora-vip3-pro-720p` 分辨率	`480p`、`720p`
`sora-vip3-pro-1080p` 分辨率	`480p`、`720p`、`1080p`

快速接入示例

创建文生视频任务

curl -X POST 'https://zexitongxue.com/v1/videos' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "sora-vip3-pro-720p",
    "prompt": "雨夜霓虹街道，镜头缓慢推进，电影感光影",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "seconds": "5"
  }'

创建图生视频任务

curl -X POST 'https://zexitongxue.com/v1/videos' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "sora-vip3-pro-1080p",
    "prompt": "保持人物外貌和服装一致，自然缓慢走动",
    "image_url": "https://example.com/input-image.jpg",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "seconds": "5"
  }'

查询任务

curl 'https://zexitongxue.com/v1/videos/{task_id}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

下载结果

curl 'https://zexitongxue.com/v1/videos/{task_id}/content' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  --output result.mp4

接入注意事项

任务异步执行

视频生成耗时会随模型、分辨率、时长、参考素材和提示词复杂度波动。正式业务建议以前端或服务端轮询任务状态为主。

参考素材

图生视频请提供可访问、清晰、完整的参考图地址。参考图质量会直接影响生成稳定性。

结果下载

结果地址不是公开免鉴权链接，请继续携带 API Key 下载，并在结果可用后及时转存。

文档口径

本页按泽西童学主站对外接口整理，所有示例地址统一为 zexitongxue.com，模型、端点、状态值和参数范围来自本次提供的 Seedance 2.0 VIP3 视频接口说明。