视频生成

POSThttps://api.tokenbyte.ai/v1/videos

使用统一视频任务接口调用 Wonder-Ultra、Wonder-Pro 或 Wonder-Standard。请在控制台创建令牌，并将令牌分组选择为 SeeDance。

调用前说明

图片、视频和音频素材必须使用服务端能够访问的公网 URL。参考素材统一放入 medias。

`job_type`	用途
`text_to_video`	文生视频
`image_to_video`	图生视频
`first_last_frame`	首尾帧生视频
`reference_to_video`	多模态参考生视频
`video_extend`	视频延长，仅 `Wonder-Ultra` 有效
`video_edit`	视频编辑，仅 `Wonder-Ultra` 有效

文生视频

curl --request POST 'https://api.tokenbyte.ai/v1/videos' \
  --header 'Authorization: Bearer sk-替换为令牌' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "Wonder-Standard",
    "job_type": "text_to_video",
    "prompt": "一只橘猫穿过雨后的霓虹街道，电影感运镜，画面自然流畅",
    "duration": 5,
    "resolution": "720P",
    "aspect_ratio": "16:9",
    "n": 1,
    "job_parameters": {
      "EnableAudio": false,
      "Watermark": false
    }
  }'

图生视频

curl --request POST 'https://api.tokenbyte.ai/v1/videos' \
  --header 'Authorization: Bearer sk-替换为令牌' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "Wonder-Standard",
    "job_type": "image_to_video",
    "prompt": "人物自然转身并面向镜头，动作流畅，电影感运镜",
    "medias": [
      {
        "Type": "image",
        "Url": "https://example.com/reference.jpg"
      }
    ],
    "duration": 5,
    "resolution": "720P",
    "aspect_ratio": "16:9",
    "n": 1,
    "job_parameters": {
      "EnableAudio": false,
      "Watermark": false
    }
  }'

参考生视频

curl --request POST 'https://api.tokenbyte.ai/v1/videos' \
  --header 'Authorization: Bearer sk-替换为令牌' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "Wonder-Pro",
    "job_type": "reference_to_video",
    "prompt": "保持参考图片中的人物身份和外观一致，复刻参考视频中的动作、表情、节奏和镜头运动",
    "medias": [
      {
        "Type": "image",
        "Url": "https://example.com/person.jpg"
      },
      {
        "Type": "video",
        "Url": "https://example.com/action.mp4"
      }
    ],
    "duration": 10,
    "resolution": "720P",
    "aspect_ratio": "adaptive",
    "n": 1,
    "job_parameters": {
      "EnableAudio": true,
      "Watermark": false
    }
  }'

查询任务与获取视频

提交成功后保存响应中的 id。任务状态变为 completed 后，即可下载视频内容。

curl --request GET 'https://api.tokenbyte.ai/v1/videos/TASK_ID' \
  --header 'Authorization: Bearer sk-替换为令牌'

curl --location --request GET \
  'https://api.tokenbyte.ai/v1/videos/TASK_ID/content' \
  --header 'Authorization: Bearer sk-替换为令牌' \
  --output result.mp4

提交成功响应示例：

{
  "id": "task_公开任务ID",
  "object": "video",
  "model": "Wonder-Standard",
  "status": "queued",
  "progress": 0,
  "created_at": 1788429073
}

请求参数

参数	类型	必填	说明
`model`	string	是	`Wonder-Ultra`、`Wonder-Pro` 或 `Wonder-Standard`。
`job_type`	string	否	建议显式填写；未填写时根据是否存在媒体素材推断。
`prompt`	string	是	视频生成提示词。
`scene`	string	否	预留的场景类型，默认 `general`。
`medias`	object[]	视任务类型	媒体素材列表，规则见下文。
`job_parameters`	object	否	音频、水印、输出格式等功能参数。
`resolution`	string	否	`720P`、`1080P` 或 `4K`，默认 `720P`；实际支持值取决于模型。
`aspect_ratio`	string	否	`16:9`、`9:16`、`4:3`、`3:4`、`1:1`、`21:9` 或 `adaptive`，默认 `16:9`。
`duration`	number	否	输出时长，默认 5 秒；通常为 4～15 秒，`Wonder-Ultra` 最大支持 30 秒。
`n`	integer	否	输出数量，当前仅支持 `1`。

`medias`

image_to_video 需要 1 个图片素材，first_last_frame 需要 2 个图片素材。Wonder-Pro 和 Wonder-Standard 最多支持 15 个参考素材；Wonder-Ultra 最多支持 50 个，其中图片最多 30 个、视频最多 10 个、音频最多 10 个。

每个媒体对象支持 Type（image、video 或 audio）以及 Url 或 MediaId。字段也可以写成对应的小写形式 type、url、media_id。

真人脸素材

Wonder 模型不支持通过 URL 直接上传包含真人脸的参考图片或视频。请先通过 Yike ImportMedia 注册素材，再填写返回的 MediaId；当前任务接口不会代为注册。

素材	格式	大小与尺寸限制
图片	jpeg、jpg、png、webp	小于 20 MB；短边至少 400 px，长边不超过 8000 px
视频	mp4、mov	不超过 100 MB；宽高 300～4096 px；总像素 409600～927408
音频	mp3、wav	不超过 15 MB

`job_parameters`

字段	类型	说明
`EnableAudio`	boolean	是否输出音频。
`Watermark`	boolean	是否添加“AI 生成”水印。
`OutputFormat`	string	`mov` 或 `mp4`，仅 `Wonder-Ultra` 有效。
`ReturnLastFrame`	boolean	是否返回尾帧。