APIMPAPIMP
User GuideAI APIImage APIVideo APIPublic API

seedance-2.5

Submit with the unified seedance-2.5 model name. The platform automatically selects an available route and adapts its parameters. It supports text-to-video, image-to-video, multimodal reference, video editing, and video extension, with durations up to 30 seconds and mp4 / mov output.

POST
/api/generate/submit

Authorization

BearerAuth

AuthorizationBearer <token>

使用 Bearer Token 认证:Authorization: Bearer sk-xxxxxx

In: header

Request Body

application/json

model*string
prompt*string

生成、编辑或延长指令。参考素材可在提示词中用 @图片1、@视频1、@音频1 指代。

duration?integer

输出时长。支持 4~30;-1 表示自动时长。默认 5。

resolution?string
Default"720p"
Value in"480p" | "720p" | "1080p"
size?string

也接受别名 aspect_ratio。图生视频、编辑、延长及首尾帧模式建议或要求使用 adaptive。

Default"adaptive"
Value in"16:9" | "4:3" | "1:1" | "3:4" | "9:16" | "21:9" | "adaptive"
generate_audio?boolean

也接受别名 audio。

Defaulttrue
content_filter?boolean

内容过滤开关。设为 false 时不能同时开启 model_params.web_search,且价格增加 10%。

Defaulttrue
nsfw_check?boolean

提交前内容审核开关。

Defaultfalse
watermark?boolean

AI 生成水印开关。

Defaultfalse
seed?integer

随机种子;仅支持该字段的渠道会使用。

output_format?string
Default"mp4"
Value in"mp4" | "mov"
omni_reference_task_type?string

明确指定参考、编辑或延长模式。edit/extend 必须提供 video_urls;edit 仅支持 duration=-1。

Default"auto"
Value in"auto" | "reference" | "edit" | "extend"
image?string

单张首帧或参考图 URL。

Formaturi
images?array<string>

图片 URL 列表。图生视频通常使用 1~2 张;参考模式最多 30 张。

Itemsitems <= 30
image_urls?array<string>

上游兼容图片 URL 列表。

Itemsitems <= 30
image_with_roles?array<object>

角色图片;首尾帧模式的 size 必须为 adaptive。

Itemsitems <= 30
Array Item (object)
url*string
role*string
Value in"first_frame" | "last_frame" | "reference_image"
video_urls?array<string>

参考、编辑或延长视频;最多 10 个,总时长不超过 30 秒。

Itemsitems <= 10
audio_urls?array<string>

参考音频,最多 10 段,总时长不超过 30 秒;支持纯音频参考。

Itemsitems <= 10
return_last_frame?boolean

成功后额外返回尾帧。

Defaultfalse
tools?array<object>

扩展工具列表,例如 [{"type":"web_search"}]。

Array Item (object)
model_params?object

模型扩展参数。

web_search?boolean

文生视频联网搜索。

[key: string]?never

Response Body

application/json

application/json

curl -X POST "https://api.apimp.ai/api/generate/submit" \  -H "Content-Type: application/json" \  -d '{    "model": "seedance-2.5",    "prompt": "电影感蒸汽朋克微缩城市",    "size": "16:9",    "resolution": "720p",    "duration": 30  }'
{
  "code": 200,
  "data": {
    "task_id": "string",
    "status": "not_started",
    "progress": 100,
    "files": [
      {
        "file_url": "string",
        "file_type": "video"
      }
    ],
    "error_message": "string"
  }
}
{
  "code": 0,
  "error": {
    "message": "string",
    "type": "string"
  }
}
Empty
Empty
Empty

How is this guide?

Last updated on