跳到正文

Seedance 超分版:1080p / 4K 视频 API

Seedance 2.0 / 2.5 超分版:低分辨率生成后经 AI 超分到 1080p / 4K,按秒计费。型号、参数、计费与限制。

超分版先用 Seedance 以较低分辨率生成,再经 AI 超分交付 1080p 或 4K。接口与 Seedance 相同:提交任务、按 ID 轮询、下载成片。

项目值
Base URLhttps://api.hop-base.com/v1
提交任务POST /v1/video/generate
查询任务GET /v1/video/tasks/{task_id}
密钥分组「Seedance 超分版」

可用型号

型号 ID参数规则分辨率时长(秒)官方价
dreamina-seedance-2-0-260128-srSeedance 2.01080p / 4k4-15 的整数或 -1$0.1588起/ 秒
dreamina-seedance-2-5-260628-srSeedance 2.51080p / 4k4-30 的整数或 -1$0.2324起/ 秒
  • 这两个型号只在 Seedance 超分版 分组提供,该分组也只提供这两个型号。把它加进密钥后,用 GET /v1/models 确认。
  • 本分组调原生 Seedance ID(不带 -sr),或在其他 Seedance 分组调 -sr ID,都会返回 404 model_not_found。
  • 想以低于原生 1080p / 4K 的价格交付 1080p / 4K 时选超分版。像素级细节由超分补出;要最清晰的原生画质,用原生 Seedance。

请求参数

请求体与 Seedance 相同:model、content(text、image_url、video_url、audio_url 元素,带 role)、resolution、ratio、duration、generate_audio、watermark、return_last_frame。时长、参考素材数量与素材限制分别沿用 Seedance 2.0 / 2.5 的规则,见 Seedance。不同之处:

项目超分版
resolution只支持 1080p 或 4k,默认 1080p;480p、720p、2k 返回 400
素材库不提供。asset:// 引用与 /v1/sd/assets 返回 400;参考素材直接传公网 URL(图片与音频也支持 data: base64)
真人参考图不支持,任务失败并提示 may contain real person;真人请用原生 Seedance 2.0 + 素材库
2.5 首帧任务的 ratio带 first_frame / last_frame 图时,dreamina-seedance-2-5-260628-sr 画幅跟随图片:不传 ratio 或传 adaptive,否则 400
视频编辑(2.5)参考视频被识别为编辑任务时,duration 必须为 -1,输出时长与画幅跟随输入视频
duration: -1由模型决定时长,按成片实际时长计费

seed、frames、camera_fixed、draft、service_tier 与 Seedance 一样返回 400。

计费

  • 按输出秒数与分辨率档计费,价格见模型卡:dreamina-seedance-2-0-260128-sr、dreamina-seedance-2-5-260628-sr。
  • 带参考视频时按更低的「有视频输入」单价,输入视频秒数也按同一单价另计(不足输出时长的 2/3 按 2/3 计)。
  • 参考图与参考音频不单独计费。
  • 失败任务与提交时 400 不计费。

示例

curl https://api.hop-base.com/v1/video/generate \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-5-260628-sr",
    "content": [
      {"type": "text", "text": "镜头缓缓推近画面"},
      {"type": "image_url", "image_url": {"url": "https://example.com/first.png"}, "role": "first_frame"}
    ],
    "resolution": "4k",
    "duration": 5
  }'

轮询 GET /v1/video/tasks/{task_id},直到 status 为 completed 或 failed,每条约 2-5 分钟。

返回

返回与 Seedance 相同的 task 包裹。task.id 以 vt 开头;完成后 task.outputs 为视频链接,task.last_frame_url 为末帧(2.5 默认返回)。结果链接自完成起 24 小时内有效,请及时下载。

报错

报错原因处理
404 model_not_found密钥分组不提供该型号换用包含「Seedance 超分版」的密钥
400 does not support resolutionresolution 不是 1080p / 4k改为 1080p 或 4k
400 has no asset library使用了 asset:// 引用改传公网 URL
400 follows the first-frame image's aspect ratio2.5 首帧任务传了 ratio去掉 ratio 或传 adaptive
任务失败:may contain real person参考图含真人改用原生 Seedance 2.0 + 素材库
任务失败:duration must be -12.5 参考视频被识别为编辑任务duration 改为 -1