seedance-2.5-1080p-LM

seedance-2.5-1080p-LM 视频生成

Markdown
POSThttps://api.storymo.art/v1/videos

模型 ID:seedance-2.5-1080p-LM

使用文本或参考图片生成视频。提交后返回 task_id,使用任务查询接口获取结果。

请求地址

POST /v1/videos

API 服务域名:https://api.storymo.art。

请求头

名称必填值
Authorization是Bearer YOUR_API_KEY
Content-Type是application/json
Idempotency-Key是每次新任务使用独立值,例如 order-20261031-001;网络重试保持原值和参数

请求参数

参数类型必填本模型填写方式
modelstring是固定填写 seedance-2.5-1080p-LM
promptstring是1–20000 字符的生成描述,不可为空
aspect_ratiostring否16:9、9:16、3:4、4:3、1:1。省略时平台默认 16:9,建议显式填写
resolutionstring否1080p。省略时平台默认 720p,该默认值不适用于本模型,必须显式填写支持的值
durationinteger否支持 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 秒;默认 5 秒
referencesarray否默认 []。参考素材格式见下方
max_creditsnumber否本次预计积分上限;超过上限返回 budget_exceeded
ninteger否默认 1,目前仅支持 1

请求 JSON

{
  "model": "seedance-2.5-1080p-LM",
  "prompt": "雨后的城市街道,镜头缓慢向前推进,路面倒映霓虹灯光",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": 5
}

时长与清晰度组合

清晰度可用时长(秒)
1080p4、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 个。

references 每项必须包含 type,并在 url 与 file_id 中选择一种。file_id 来自文件上传接口;url 为可公开下载的 HTTPS 文件地址。参考数组总数最多 50,仍受本模型每类上限约束。

[
  {
    "type": "image",
    "file_id": "上传返回的file_id"
  }
]

只需参考图片时,将 references 添加到上面的请求 JSON,prompt 正常描述即可。需要指明某个素材时,使用 <<<image_1>>>、<<<video_1>>>、<<<audio_1>>>;每种媒体按 references 中出现的顺序分别编号。显式引用存在时,仅引用到的素材会参与生成,提交顺序按提示词中的引用顺序确定。

报价

POST /v1/videos/quote

使用相同请求参数获取本次预计积分;报价无需 Idempotency-Key,不扣费。以 data.credits 为预计值,实际以任务记录为准。

提交响应

HTTP 202。

{
  "code": "ok",
  "message": "success",
  "data": {
    "task_id": "task_example",
    "taskId": "task_example",
    "type": "video",
    "status": "queued",
    "credits": 20
  },
  "requestId": "req_example"
}

credits 为本次任务积分,上面的 20 仅为响应结构示例。taskId 是兼容字段,新接入使用 task_id。status=queued 表示排队,不能直接下载。

查询与下载

GET /v1/videos/{task_id}

携带相同 Authorization,每 3–5 秒查询一次。status 为 succeeded 时读取 data.outputs[0].url 下载视频;failed 或 canceled 时停止查询。

{
  "code": "ok",
  "message": "success",
  "data": {
    "task_id": "task_example",
    "type": "video",
    "status": "succeeded",
    "progress": 100,
    "outputs": [
      {
        "type": "video",
        "url": "https://cdn.example.com/result.mp4"
      }
    ],
    "error": null,
    "credits": 20,
    "created_at": "2026-10-31T04:00:00.000Z",
    "completed_at": "2026-10-31T04:01:00.000Z"
  },
  "requestId": "req_example"
}

下载地址可能过期;重新查询任务可获取链接。下载文件时不要发送 API Key。

错误处理

400:参数、素材类型或数量不支持。401:API Key 无效。402:积分不足。403:会员权限不足。409:幂等冲突或提交尚未确定。500/503:服务异常。错误响应包含 code、message、data 和 requestId。超时后使用相同幂等键重试提交,收到 task_id 后只需查询任务。

curl --request POST "https://api.storymo.art/v1/videos" \
  --header "Authorization: Bearer $DRAMAGEN_API_KEY" \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: order-272ba934-001' \
  --data '{
  "model": "seedance-2.5-1080p-LM",
  "prompt": "雨后的城市街道,镜头缓慢向前推进,路面倒映霓虹灯光",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": 5
}'
响应示例
{
  "code": "ok",
  "message": "success",
  "data": {
    "task_id": "task_example",
    "taskId": "task_example",
    "type": "video",
    "status": "queued",
    "credits": 20
  },
  "requestId": "req_example"
}