视频生成超分 API

视频生成超分接口用于创建高分辨率视频生成任务。接口采用异步任务模式：先创建任务取得 id，再轮询查询任务状态，成功后读取 content.video_url。

本接口的请求格式与视频生成接口保持一致，适合希望直接获得目标清晰度视频的场景。

接口地址

操作	方法与地址
创建任务	`POST https://art-api.yuyuflow.com/api/v3/contents/generations/tasks`
查询任务	`GET https://art-api.yuyuflow.com/api/v3/contents/generations/tasks/{id}`

鉴权

请先在 https://art-api.yuyuflow.com/dashboard/overview 获取 API Key，并在请求头中传入：

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

创建任务

请求参数

参数	必填	示例	说明
`model`	是	`ai-video-gen-sr-v1`	固定值。视频生成超分模型 ID
`generation_model`	否	`seedance-2`	底层视频生成模型版本。当前支持 `seedance-2`、`seedance-2.5`
`content`	是	见下方示例	输入内容，支持文本、图片、音频
`resolution`	否	`720p`	目标输出清晰度。支持 `480p`、`720p`、`1080p`、`4k`，默认 `720p`
`ratio`	否	`16:9`	视频比例。支持 `21:9`、`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`9:21`、`adaptive`
`duration`	否	`5`	视频时长，单位秒
`seed`	否	`42`	随机种子，相同参数下可提高结果复现性
`generate_audio`	否	`true`	是否生成有声视频

注意

当前暂不支持视频输入。
当前暂不支持 draft / 样片任务。
seedance-2.5 当前最高支持生成到 1080p，暂不支持 4k。
图片、音频等资源 URL 需要可被服务端访问。

选择生成场景

同一个请求中，请先确定一种生成场景，不要混用不同图片语义。

场景	输入内容	图片 `role`
文生视频	文本	无
图生视频 - 首帧	1 张图片，可加文本	`first_frame`，单图场景也可不填
图生视频 - 首尾帧	2 张图片，可加文本	`first_frame` + `last_frame`
图生视频 - 参考图	1 张或多张参考图，可加文本	`reference_image`
音频参考生成	参考音频 + 至少 1 张参考图，可加文本	图片使用 `reference_image`，音频使用 `reference_audio`

场景不可混用

first_frame / last_frame 表示让图片控制视频的起止画面；reference_image 表示让图片作为风格、主体或内容参考。它们不是同一种语义，同一个请求中不要混用。

请求示例

文生视频

bash

curl --location 'https://art-api.yuyuflow.com/api/v3/contents/generations/tasks' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "ai-video-gen-sr-v1",
    "generation_model": "seedance-2",
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "content": [
      {
        "type": "text",
        "text": "一只猫在阳光下奔跑，电影感镜头，画面自然明亮"
      }
    ]
  }'

图生视频 - 首帧

使用一张图片作为视频的起始画面。

bash

curl --location 'https://art-api.yuyuflow.com/api/v3/contents/generations/tasks' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "ai-video-gen-sr-v1",
    "generation_model": "seedance-2",
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "content": [
      {
        "type": "text",
        "text": "人物从画面中央自然向前走，镜头缓慢推进"
      },
      {
        "type": "image_url",
        "role": "first_frame",
        "image_url": {
          "url": "https://your-oss-domain/path/first-frame.png"
        }
      }
    ]
  }'

图生视频 - 首尾帧

使用两张图片分别控制视频的开始画面和结束画面。

bash

curl --location 'https://art-api.yuyuflow.com/api/v3/contents/generations/tasks' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "ai-video-gen-sr-v1",
    "generation_model": "seedance-2",
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "content": [
      {
        "type": "text",
        "text": "镜头平滑推进，人物从站立变为转身挥手，动作自然连贯"
      },
      {
        "type": "image_url",
        "role": "first_frame",
        "image_url": {
          "url": "https://your-oss-domain/path/start.png"
        }
      },
      {
        "type": "image_url",
        "role": "last_frame",
        "image_url": {
          "url": "https://your-oss-domain/path/end.png"
        }
      }
    ]
  }'

图生视频 - 单张参考图

使用图片作为主体、风格或场景参考，而不是固定为首帧。

bash

curl --location 'https://art-api.yuyuflow.com/api/v3/contents/generations/tasks' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "ai-video-gen-sr-v1",
    "generation_model": "seedance-2",
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "content": [
      {
        "type": "text",
        "text": "参考图片中的人物形象和服装风格，生成一段自然走动的视频"
      },
      {
        "type": "image_url",
        "role": "reference_image",
        "image_url": {
          "url": "https://your-oss-domain/path/reference-image.png"
        }
      }
    ]
  }'

图生视频 - 多张参考图

bash

curl --location 'https://art-api.yuyuflow.com/api/v3/contents/generations/tasks' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "ai-video-gen-sr-v1",
    "generation_model": "seedance-2",
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "content": [
      {
        "type": "text",
        "text": "参考多张图片中的产品外观和场景氛围，生成一段产品展示视频"
      },
      {
        "type": "image_url",
        "role": "reference_image",
        "image_url": {
          "url": "https://your-oss-domain/path/reference-1.png"
        }
      },
      {
        "type": "image_url",
        "role": "reference_image",
        "image_url": {
          "url": "https://your-oss-domain/path/reference-2.png"
        }
      }
    ]
  }'

参考图 + 参考音频

bash

curl --location 'https://art-api.yuyuflow.com/api/v3/contents/generations/tasks' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "ai-video-gen-sr-v1",
    "generation_model": "seedance-2.5",
    "resolution": "1080p",
    "ratio": "16:9",
    "duration": 8,
    "content": [
      {
        "type": "text",
        "text": "参考图片中的舞台和人物造型，根据音频节奏生成一段舞台表演视频"
      },
      {
        "type": "image_url",
        "role": "reference_image",
        "image_url": {
          "url": "https://your-oss-domain/path/reference-image.png"
        }
      },
      {
        "type": "audio_url",
        "role": "reference_audio",
        "audio_url": {
          "url": "https://your-oss-domain/path/reference-audio.wav"
        }
      }
    ]
  }'

创建成功响应

json

{
  "id": "video-gen-sr-875387844930248742"
}

请保存返回的 id，后续通过查询接口获取任务状态和结果。

查询任务

bash

curl --location 'https://art-api.yuyuflow.com/api/v3/contents/generations/tasks/video-gen-sr-875387844930248742' \
  --header 'Authorization: Bearer YOUR_API_KEY'

处理中响应

json

{
  "id": "video-gen-sr-875387844930248742",
  "status": "running",
  "content": {
    "video_url": null,
    "last_frame_url": null
  },
  "error": null,
  "created_at": 1786516988,
  "updated_at": 1786516996,
  "resolution": "720p",
  "duration": 5,
  "usage": {
    "completion_tokens": 46,
    "total_tokens": 46
  }
}

成功响应

json

{
  "id": "video-gen-sr-875387844930248742",
  "status": "succeeded",
  "content": {
    "video_url": "https://your-cdn-domain/path/result.mp4",
    "last_frame_url": null
  },
  "error": null,
  "created_at": 1786516988,
  "updated_at": 1786517020,
  "resolution": "720p",
  "duration": 5,
  "usage": {
    "completion_tokens": 46,
    "total_tokens": 46
  }
}

任务成功后，请从 content.video_url 读取视频结果，并及时下载或转存。

失败响应

json

{
  "id": "video-gen-sr-875387844930248742",
  "status": "failed",
  "content": {
    "video_url": null,
    "last_frame_url": null
  },
  "error": {
    "code": "render_task_failed",
    "message": "render task failed"
  },
  "created_at": 1786516988,
  "updated_at": 1786517020,
  "resolution": "720p",
  "duration": 5
}

状态说明

`status`	说明	客户端处理
`queued`	任务已创建，等待处理	继续轮询
`running`	任务处理中	继续轮询
`succeeded`	任务完成	读取 `content.video_url`
`failed`	任务失败	读取 `error.code` 和 `error.message`

常见错误

错误信息	原因	处理方式
`invalid API key`	鉴权失败	检查 `Authorization` 请求头和 API Key
`content must contain text or image_url`	`content` 中没有可用文本或图片	至少传入文本、图片或支持的参考素材
`video_url content is not supported by this model yet`	当前接口暂不支持视频输入	移除 `video_url` 内容
`first_frame/last_frame cannot be mixed with reference_image/audio_url`	首帧/首尾帧场景与参考图或参考音频混用	选择一种生成场景后重新组织 `content`
`Seedance 2.5 does not support 4k output yet`	`seedance-2.5` 当前不支持 `4k`	改用 `720p` 或 `1080p`，或选择支持 `4k` 的模型

视频生成超分 API​

接口地址​

鉴权​

创建任务​

请求参数​

选择生成场景​

请求示例​

文生视频​

图生视频 - 首帧​

图生视频 - 首尾帧​

图生视频 - 单张参考图​

图生视频 - 多张参考图​

参考图 + 参考音频​

创建成功响应​

查询任务​

处理中响应​

成功响应​

失败响应​

状态说明​

常见错误​

视频生成超分 API

接口地址

鉴权

创建任务

请求参数

选择生成场景

请求示例

文生视频

图生视频 - 首帧

图生视频 - 首尾帧

图生视频 - 单张参考图

图生视频 - 多张参考图

参考图 + 参考音频

创建成功响应

查询任务

处理中响应

成功响应

失败响应

状态说明

常见错误