AI ad creatives: clone reference ads, AI spokesperson videos, video generation, translation, images.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional. 'Bearer <AdsTurbo API key>' (create one at https://adsturbo.ai/iris/api). Without it, clients sign in with OAuth.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
视频复刻 — 分析
圈选结束时间（秒）；须 clip_end > clip_start，且 clip_end - clip_start ≤ 12（片段最长 12 秒）
源视频 URL
圈选起始时间（秒，非负）
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
视频复刻 — 分析
| Argument | Type | Description |
|---|---|---|
| clip_end | integer | 圈选结束时间（秒）；须 clip_end > clip_start，且 clip_end - clip_start ≤ 12（片段最长 12 秒） |
| video_url | string | 源视频 URL |
| clip_start | integer | 圈选起始时间（秒，非负） |
{
"type": "object",
"properties": {
"clip_end": {
"type": "integer",
"format": "int32",
"minimum": 0,
"description": "圈选结束时间（秒）；须 clip_end > clip_start，且 clip_end - clip_start ≤ 12（片段最长 12 秒）"
},
"video_url": {
"type": "string",
"description": "源视频 URL"
},
"clip_start": {
"type": "integer",
"format": "int32",
"minimum": 0,
"description": "圈选起始时间（秒，非负）"
}
},
"description": "视频复刻 — 分析源视频并生成 prompt。"
}视频复刻 — 生成
| Argument | Type | Description |
|---|---|---|
| ratio | string | 视频比例，空 = `9:16` |
| prompt | string | prompt（可在 Analyze 返回基础上修改） |
| duration | integer | 生成时长（秒）；不在可选值内（含不传）按 12 |
| video_url | string | 源视频片段 URL（Analyze 返回的 video_segment_url） |
| callback_id | string | 自定义追踪 ID，webhook URL 后台配置 |
{
"type": "object",
"properties": {
"ratio": {
"type": "string",
"description": "视频比例，空 = `9:16`"
},
"prompt": {
"type": "string",
"description": "prompt（可在 Analyze 返回基础上修改）"
},
"duration": {
"enum": [
4,
8,
12,
16,
20
],
"type": "integer",
"format": "int32",
"description": "生成时长（秒）；不在可选值内（含不传）按 12"
},
"video_url": {
"type": "string",
"description": "源视频片段 URL（Analyze 返回的 video_segment_url）"
},
"callback_id": {
"type": "string",
"description": "自定义追踪 ID，webhook URL 后台配置"
}
},
"description": "视频复刻 — 提交生成任务；响应含异步任务 ID（`workspace_id`）。"
}系统演员列表
| Argument | Type | Description |
|---|---|---|
| age | array | |
| pose | array | |
| limit | integer | |
| gender | array | |
| offset | integer | |
| sort_by | string | |
| industry | array | 按服务端行业分类过滤（如 `beauty` / `fitness` / `finance` 等）；取值集以服务端注册表为准。 |
| ethnicity | array | |
| shot_type | array | |
| situation | array |
{
"type": "object",
"properties": {
"age": {
"type": "array",
"items": {
"enum": [
"senior",
"adult",
"young-adult",
"kid"
],
"type": "string"
}
},
"pose": {
"type": "array",
"items": {
"enum": [
"arms-crossed",
"cross-legged",
"gesturing",
"leaning",
"leaning-forward",
"legs-crossed",
"pointing",
"reclining",
"sitting",
"standing"
],
"type": "string"
}
},
"limit": {
"type": "integer",
"format": "int32"
},
"gender": {
"type": "array",
"items": {
"enum": [
"female",
"male"
],
"type": "string"
}
},
"offset": {
"type": "integer",
"format": "int32"
},
"sort_by": {
"type": "string"
},
"industry": {
"type": "array",
"items": {
"type": "string"
},
"description": "按服务端行业分类过滤（如 `beauty` / `fitness` / `finance` 等）；取值集以服务端注册表为准。\n"
},
"ethnicity": {
"type": "array",
"items": {
"enum": [
"asian",
"caucasian",
"african",
"latino"
],
"type": "string"
}
},
"shot_type": {
"type": "array",
"items": {
"enum": [
"close-up",
"full-shot",
"long-shot",
"medium-close-up",
"medium-full-shot",
"medium-shot"
],
"type": "string"
}
},
"situation": {
"type": "array",
"items": {
"enum": [
"balcony",
"beach",
"bedroom",
"car",
"coffee-shop",
"grwm",
"home",
"kitchen",
"medical",
"news-anchor",
"office",
"podcast",
"snow",
"studio"
],
"type": "string"
}
}
},
"description": "系统演员列表筛选与分页；筛选项为小写，英文短语中空格用连字符。"
}演员演出（系统演员或 Persona） `actor_id` 既可为系统演员 ID，也可为自定义 Persona 的 `actor_id`，共用同一套演出参数与异步任务响应。
| Argument | Type | Description |
|---|---|---|
| speed | number | |
| style | number | |
| script | string | |
| actor_id | string | 系统演员 ID，或 Persona 的 actor_id |
| stability | number | |
| similarity | number | |
| callback_id | string | 自定义追踪 ID，webhook URL 后台配置 |
| auto_emotion | boolean | |
| speaker_boost | boolean |
{
"type": "object",
"properties": {
"speed": {
"type": "number",
"format": "float"
},
"style": {
"type": "number",
"format": "float"
},
"script": {
"type": "string"
},
"actor_id": {
"type": "string",
"description": "系统演员 ID，或 Persona 的 actor_id"
},
"stability": {
"type": "number",
"format": "float"
},
"similarity": {
"type": "number",
"format": "float"
},
"callback_id": {
"type": "string",
"description": "自定义追踪 ID，webhook URL 后台配置"
},
"auto_emotion": {
"type": "boolean"
},
"speaker_boost": {
"type": "boolean"
}
},
"description": "演出任务请求；适用于系统演员与自定义 Persona。"
}系统演员语音生成
| Argument | Type | Description |
|---|---|---|
| speed | number | |
| script | string | |
| actor_id | string | |
| stability | number | |
| similarity | number | |
| auto_emotion | boolean |
{
"type": "object",
"properties": {
"speed": {
"type": "number",
"format": "float"
},
"script": {
"type": "string"
},
"actor_id": {
"type": "string"
},
"stability": {
"type": "number",
"format": "float"
},
"similarity": {
"type": "number",
"format": "float"
},
"auto_emotion": {
"type": "boolean"
}
},
"description": "系统演员语音合成请求。"
}批量查询异步任务状态
| Argument | Type | Description |
|---|---|---|
| workspace_ids | array |
{
"type": "object",
"properties": {
"workspace_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"description": "批量按 `workspace_ids` 查询异步任务状态。"
}解析平台视频链接，换取可用的视频素材
| Argument | Type | Description |
|---|---|---|
| urls* | array | 视频分享链接，最多 5 个。可以直接传用户复制来的整段分享文案，会自动取出其中的链接。 |
{
"type": "object",
"required": [
"urls"
],
"properties": {
"urls": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 5,
"minItems": 1,
"description": "视频分享链接，最多 5 个。可以直接传用户复制来的整段分享文案，会自动取出其中的链接。"
}
},
"description": "用户给的是抖音、TikTok、YouTube、Instagram、小红书、视频号上的视频分享链接（或包含链接的整段分享文案）时，先调用本工具：它会抓取视频并转存到 AdsTurbo，返回可直接下载的 video_url，以及封面、时长、标题和作者。之后把 video_url 传给 ad_clone_analyze、video_analyze、video_translate、video_subtitle 等工具。不要自己请求平台网页去抓视频，也不要把平台分享链接直接传给其他工具。已经是 .mp4 等可直接下载的链接就不用调用。抓到的视频只用于拆解分析和借鉴创意结构，不要原样转发或发布他人的作品。不消耗积分，新抓取的视频会存进用户的素材库。"
}查询 Persona 状态
| Argument | Type | Description |
|---|---|---|
| actor_id | string |
{
"type": "object",
"properties": {
"actor_id": {
"type": "string"
}
},
"description": "按 `actor_id` 查询 Persona 状态。"
}查询异步任务状态
| Argument | Type | Description |
|---|---|---|
| workspace_id | string |
{
"type": "object",
"properties": {
"workspace_id": {
"type": "string"
}
},
"description": "按 `workspace_id` 查询异步任务状态。"
}图片生成 / 编辑 每次调用固定生成 **1 张**。 默认异步：返回 `workspace_id`（`status=pending`，`result_type=image`），用 `work/status` 轮询取 `result_url`； `sync_mod=true` 时同步阻塞到出图，响应里 `result_url` 直接为图片 URL（`status=completed`）。
| Argument | Type | Description |
|---|---|---|
| model | string | 可选。默认 `nanobanana-pro`。 |
| ratio | string | 取值集因 model 而异，详见请求体表格。 |
| prompt | string | 生成 / 编辑指令 |
| sync_mod | boolean | `true` 同步阻塞到出图（最长约 60 秒）；默认 `false` 异步返回 `workspace_id`。 |
| image_urls | array | 文生图时为空数组；编辑时非空，上限因 model 而异。 |
| resolution | string | 仅 `nanobanana-pro` / `nano-banana-2` / `nano-banana-2-fast` / `seedream-5.0-pro` / `gpt-image-2` 支持；取值集详见请求体表格。 |
| callback_id | string | 自定义追踪 ID，在响应中原样回传 |
| idempotency_key | string | 幂等键（预留字段，当前服务端未对本接口做去重） |
{
"type": "object",
"properties": {
"model": {
"enum": [
"nanobanana-pro",
"nano-banana-2",
"nano-banana-2-fast",
"seedream-5.0-pro",
"seedream-5.0-lite",
"gpt-image-2",
"grok-2-image",
"grok-imagine-image"
],
"type": "string",
"example": "nanobanana-pro",
"description": "可选。默认 `nanobanana-pro`。"
},
"ratio": {
"enum": [
"1:1",
"1:2",
"2:1",
"1:3",
"3:1",
"1:4",
"4:1",
"1:8",
"8:1",
"2:3",
"3:2",
"3:4",
"4:3",
"4:5",
"5:4",
"5:7",
"7:5",
"9:16",
"16:9",
"9:21",
"21:9"
],
"type": "string",
"example": "9:16",
"description": "取值集因 model 而异，详见请求体表格。"
},
"prompt": {
"type": "string",
"description": "生成 / 编辑指令"
},
"sync_mod": {
"type": "boolean",
"example": false,
"description": "`true` 同步阻塞到出图（最长约 60 秒）；默认 `false` 异步返回 `workspace_id`。"
},
"image_urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "文生图时为空数组；编辑时非空，上限因 model 而异。\n"
},
"resolution": {
"enum": [
"0.5k",
"1k",
"2k",
"4k",
"8k"
],
"type": "string",
"example": "2k",
"description": "仅 `nanobanana-pro` / `nano-banana-2` / `nano-banana-2-fast` / `seedream-5.0-pro` / `gpt-image-2` 支持；取值集详见请求体表格。\n"
},
"callback_id": {
"type": "string",
"description": "自定义追踪 ID，在响应中原样回传"
},
"idempotency_key": {
"type": "string",
"description": "幂等键（预留字段，当前服务端未对本接口做去重）"
}
},
"description": "图片生成或编辑。`model` 为模型短名称，省略时服务端默认 `nanobanana-pro`。\n文生图：`image_urls` 为空；图片编辑：`image_urls` 非空。每次固定生成 1 张。\n\n**模式支持**：\n- 仅文生图：`grok-2-image`\n- 仅编辑：`grok-imagine-image`\n- 文生 + 编辑：`nanobanana-pro`、`nano-banana-2`、`nano-banana-2-fast`、`seedream-5.0-pro`、`seedream-5.0-lite`、`gpt-image-2`\n\n**参数支持（按模型不同，服务端校验为准）**：\n\n| model | ratio | resolution | 编辑输入图上限 |\n|---|---|---|---|\n| `nanobanana-pro` | 1:1 / 3:2 / 2:3 / 3:4 / 4:3 / 4:5 / 5:4 / 5:7 / 7:5 / 9:16 / 16:9 / 21:9 / 1:4 / 4:1 | 1k / 2k / 4k / 8k | 14 |\n| `nano-banana-2` | 同上 + 1:8 / 8:1 | 0.5k / 1k / 2k / 4k | 14 |\n| `nano-banana-2-fast` | 同上 + 1:8 / 8:1 | 2k / 4k | 14 |\n| `seedream-5.0-pro` | 1:1 / 1:2 / 2:1 / 1:3 / 3:1 / 2:3 / 3:2 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 9:21 / 21:9 | 2k（默认）/ 1k | 10 |\n| `seedream-5.0-lite` | 1:1 / 1:2 / 2:1 / 1:3 / 3:1 / 1:4 / 4:1 / 1:8 / 8:1 / 2:3 / 3:2 / 3:4 / 4:3 / 4:5 / 5:4 / 5:7 / 7:5 / 9:16 / 16:9 / 9:21 / 21:9 | — | 10 |\n| `gpt-image-2` | 1:1 / 1:2 / 2:1 / 1:3 / 3:1 / 2:3 / 3:2 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 9:21 / 21:9 | 1k / 2k / 4k | 10 |\n| `grok-2-image` | 不校验 | — | 不支持编辑 |\n| `grok-imagine-image` | 1:1 / 3:2 / 2:3 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 21:9 | — | 1 |\n\n- `ratio` 留空由模型按 prompt 决定；prompt 内写明的比例（如 `16:9`、「竖屏」）优先于 `ratio` 参数。\n- `resolution` 不支持的模型必须留空；`4k` 及以上需订阅身份。\n- `image_urls` 只收 http(s) URL，不收 data URI；单张像素 ≤ 3600 万。\n"
}图片抠图
| Argument | Type | Description |
|---|---|---|
| method | string | 抠图方法 |
| image_url | string | 原图 URL |
| resolution | string | 输出分辨率 |
| callback_id | string | 回调标识 |
| workspace_id | string | 工作空间 ID，用于关联异步任务 |
| output_format | string | 输出格式 |
| idempotency_key | string | 幂等键，防止重复提交 |
{
"type": "object",
"properties": {
"method": {
"type": "string",
"description": "抠图方法"
},
"image_url": {
"type": "string",
"description": "原图 URL"
},
"resolution": {
"type": "string",
"description": "输出分辨率"
},
"callback_id": {
"type": "string",
"description": "回调标识"
},
"workspace_id": {
"type": "string",
"description": "工作空间 ID，用于关联异步任务"
},
"output_format": {
"type": "string",
"description": "输出格式"
},
"idempotency_key": {
"type": "string",
"description": "幂等键，防止重复提交"
}
},
"description": "图片抠图请求"
}电商产品图
| Argument | Type | Description |
|---|---|---|
| methods | array | 生成方法列表 |
| language | string | 语言 |
| resolution | string | 输出分辨率 |
| user_input | string | 用户输入描述 |
| callback_id | string | 回调标识 |
| aspect_ratio | string | 宽高比 |
| product_info | string | 产品信息 |
| workspace_id | string | 工作空间 ID |
| idempotency_key | string | 幂等键 |
| reference_image_urls | array | 参考图片 URL 列表 |
{
"type": "object",
"properties": {
"methods": {
"type": "array",
"items": {
"type": "string"
},
"description": "生成方法列表"
},
"language": {
"type": "string",
"description": "语言"
},
"resolution": {
"type": "string",
"description": "输出分辨率"
},
"user_input": {
"type": "string",
"description": "用户输入描述"
},
"callback_id": {
"type": "string",
"description": "回调标识"
},
"aspect_ratio": {
"type": "string",
"description": "宽高比"
},
"product_info": {
"type": "string",
"description": "产品信息"
},
"workspace_id": {
"type": "string",
"description": "工作空间 ID"
},
"idempotency_key": {
"type": "string",
"description": "幂等键"
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "参考图片 URL 列表"
}
},
"description": "电商产品图请求"
}图片增强
| Argument | Type | Description |
|---|---|---|
| scale | integer | 放大倍数 |
| method | string | 增强方法 |
| image_url | string | 原图 URL |
| resolution | string | 输出分辨率 |
| callback_id | string | 回调标识 |
| workspace_id | string | 工作空间 ID |
| idempotency_key | string | 幂等键 |
{
"type": "object",
"properties": {
"scale": {
"type": "integer",
"format": "int32",
"description": "放大倍数"
},
"method": {
"type": "string",
"description": "增强方法"
},
"image_url": {
"type": "string",
"description": "原图 URL"
},
"resolution": {
"type": "string",
"description": "输出分辨率"
},
"callback_id": {
"type": "string",
"description": "回调标识"
},
"workspace_id": {
"type": "string",
"description": "工作空间 ID"
},
"idempotency_key": {
"type": "string",
"description": "幂等键"
}
},
"description": "图片增强请求"
}AI 图片消除
| Argument | Type | Description |
|---|---|---|
| method | string | 消除方法 |
| mask_url | string | 蒙版 URL |
| quantity | integer | 生成数量 |
| image_url | string | 原图 URL |
| resolution | string | 输出分辨率 |
| callback_id | string | 回调标识 |
| instruction | string | 消除指令描述 |
| aspect_ratio | string | 宽高比 |
| workspace_id | string | 工作空间 ID |
| idempotency_key | string | 幂等键 |
{
"type": "object",
"properties": {
"method": {
"type": "string",
"description": "消除方法"
},
"mask_url": {
"type": "string",
"description": "蒙版 URL"
},
"quantity": {
"type": "integer",
"format": "int32",
"description": "生成数量"
},
"image_url": {
"type": "string",
"description": "原图 URL"
},
"resolution": {
"type": "string",
"description": "输出分辨率"
},
"callback_id": {
"type": "string",
"description": "回调标识"
},
"instruction": {
"type": "string",
"description": "消除指令描述"
},
"aspect_ratio": {
"type": "string",
"description": "宽高比"
},
"workspace_id": {
"type": "string",
"description": "工作空间 ID"
},
"idempotency_key": {
"type": "string",
"description": "幂等键"
}
},
"description": "AI 图片消除请求"
}活动海报图
| Argument | Type | Description |
|---|---|---|
| method | string | 海报生成方法 |
| language | string | 语言 |
| event_info | string | 活动信息 |
| resolution | string | 输出分辨率 |
| callback_id | string | 回调标识 |
| aspect_ratio | string | 宽高比 |
| workspace_id | string | 工作空间 ID |
| idempotency_key | string | 幂等键 |
| reference_image_urls | array | 参考图片 URL 列表 |
{
"type": "object",
"properties": {
"method": {
"type": "string",
"description": "海报生成方法"
},
"language": {
"type": "string",
"description": "语言"
},
"event_info": {
"type": "string",
"description": "活动信息"
},
"resolution": {
"type": "string",
"description": "输出分辨率"
},
"callback_id": {
"type": "string",
"description": "回调标识"
},
"aspect_ratio": {
"type": "string",
"description": "宽高比"
},
"workspace_id": {
"type": "string",
"description": "工作空间 ID"
},
"idempotency_key": {
"type": "string",
"description": "幂等键"
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "参考图片 URL 列表"
}
},
"description": "活动海报图请求"
}创建自定义 Persona
| Argument | Type | Description |
|---|---|---|
| name | string | |
| photo_url | string | |
| callback_id | string | 自定义追踪 ID，webhook URL 后台配置 |
| voice_audio_url | string | 可选，用于语音克隆 |
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"photo_url": {
"type": "string"
},
"callback_id": {
"type": "string",
"description": "自定义追踪 ID，webhook URL 后台配置"
},
"voice_audio_url": {
"type": "string",
"description": "可选，用于语音克隆"
}
},
"description": "创建自定义 Persona 请求。"
}删除自定义 Persona
| Argument | Type | Description |
|---|---|---|
| actor_id | string |
{
"type": "object",
"properties": {
"actor_id": {
"type": "string"
}
},
"description": "删除 Persona 请求。"
}个人创建演员列表 分页查询当前用户创建的个人演员（Persona）列表。
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"format": "int32"
},
"offset": {
"type": "integer",
"format": "int32"
}
},
"description": "个人创建演员列表分页查询；`offset`、`limit` 为分页参数。"
}视频拉片
| Argument | Type | Description |
|---|---|---|
| video_url | string | 源视频 URL |
| callback_id | string | 自定义追踪 ID，webhook URL 后台配置 |
| workspace_id | integer | 关联工作区 ID，无则传 0 |
{
"type": "object",
"properties": {
"video_url": {
"type": "string",
"description": "源视频 URL"
},
"callback_id": {
"type": "string",
"description": "自定义追踪 ID，webhook URL 后台配置"
},
"workspace_id": {
"type": "integer",
"format": "int64",
"description": "关联工作区 ID，无则传 0"
}
},
"description": "视频拉片任务。"
}视频换脸
| Argument | Type | Description |
|---|---|---|
| image_url | string | 目标人脸参考图 URL |
| video_url | string | |
| callback_id | string | 自定义追踪 ID，webhook URL 后台配置 |
| workspace_id | integer |
{
"type": "object",
"properties": {
"image_url": {
"type": "string",
"description": "目标人脸参考图 URL"
},
"video_url": {
"type": "string"
},
"callback_id": {
"type": "string",
"description": "自定义追踪 ID，webhook URL 后台配置"
},
"workspace_id": {
"type": "integer",
"format": "int64"
}
},
"description": "视频换脸任务。"
}视频编辑 **仅支持 `seedance-2.0` 模型基座**。 源视频二选一：`workspace_id` 或 `video_url`；同时传 / 同时空均报错。 `mask_url` 可选；非空时为局部编辑掩码。
| Argument | Type | Description |
|---|---|---|
| model | string | 仅支持 `seedance-2.0`。 |
| ratio | string | |
| prompt | string | |
| mask_url | string | |
| video_url | string | |
| resolution | string | |
| callback_id | string | 自定义追踪 ID，webhook URL 后台配置 |
| workspace_id | string | |
| idempotency_key | string | |
| reference_images | array |
{
"type": "object",
"properties": {
"model": {
"enum": [
"seedance-2.0"
],
"type": "string",
"default": "seedance-2.0",
"description": "仅支持 `seedance-2.0`。"
},
"ratio": {
"type": "string"
},
"prompt": {
"type": "string"
},
"mask_url": {
"type": "string"
},
"video_url": {
"type": "string"
},
"resolution": {
"enum": [
"720p",
"1080p"
],
"type": "string"
},
"callback_id": {
"type": "string",
"description": "自定义追踪 ID，webhook URL 后台配置"
},
"workspace_id": {
"type": "string"
},
"idempotency_key": {
"type": "string"
},
"reference_images": {
"type": "array",
"items": {
"type": "string"
}
}
},
"description": "视频编辑。源视频二选一：`workspace_id` 或 `video_url`；同时传 / 同时空均报错。\n`mask_url` 可选；非空时为局部编辑掩码（模型支持度以服务端为准）。\n\n**仅支持 `seedance-2.0` 模型基座**，不开放其他模型。`resolution` 取 `720p` / `1080p`。\n"
}视频增强
| Argument | Type | Description |
|---|---|---|
| method | string | 增强方法 |
| duration | integer | 时长（秒） |
| video_url | string | 视频 URL |
| resolution | string | 输出分辨率 |
| callback_id | string | 回调标识 |
| workspace_id | string | 工作空间 ID |
| idempotency_key | string | 幂等键 |
{
"type": "object",
"properties": {
"method": {
"type": "string",
"description": "增强方法"
},
"duration": {
"type": "integer",
"format": "int32",
"description": "时长（秒）"
},
"video_url": {
"type": "string",
"description": "视频 URL"
},
"resolution": {
"type": "string",
"description": "输出分辨率"
},
"callback_id": {
"type": "string",
"description": "回调标识"
},
"workspace_id": {
"type": "string",
"description": "工作空间 ID"
},
"idempotency_key": {
"type": "string",
"description": "幂等键"
}
},
"description": "视频增强请求"
}视频延长（在源视频末尾追加 N 秒） **仅支持 `seedance-2.0` 模型基座**。 源视频二选一：`workspace_id`（内部）或 `video_url`（外部）；同时传 / 同时空均报错。 `duration` 为增量秒数：原 8s + duration=4 → 输出 12s。
| Argument | Type | Description |
|---|---|---|
| model | string | 仅支持 `seedance-2.0`。 |
| ratio | string | |
| prompt | string | |
| duration | integer | 在源视频末尾追加的秒数；范围 4~15，默认 15。 |
| video_url | string | |
| resolution | string | |
| callback_id | string | 自定义追踪 ID，webhook URL 后台配置 |
| workspace_id | string | |
| idempotency_key | string |
{
"type": "object",
"properties": {
"model": {
"enum": [
"seedance-2.0"
],
"type": "string",
"default": "seedance-2.0",
"description": "仅支持 `seedance-2.0`。"
},
"ratio": {
"type": "string"
},
"prompt": {
"type": "string"
},
"duration": {
"type": "integer",
"format": "int32",
"maximum": 15,
"minimum": 4,
"description": "在源视频末尾追加的秒数；范围 4~15，默认 15。"
},
"video_url": {
"type": "string"
},
"resolution": {
"enum": [
"720p",
"1080p"
],
"type": "string"
},
"callback_id": {
"type": "string",
"description": "自定义追踪 ID，webhook URL 后台配置"
},
"workspace_id": {
"type": "string"
},
"idempotency_key": {
"type": "string"
}
},
"description": "视频延长。源视频二选一：`workspace_id`（内部）或 `video_url`（外部）；同时传 / 同时空均报错。\n`duration` 为增量秒数。\n\n**仅支持 `seedance-2.0` 模型基座**，不开放其他模型。`duration` 取值范围 4~15（默认 15），`resolution` 取 `720p` / `1080p`。\n"
}视频生成（文生 / 图生 / 首尾帧 / 多参考媒体） 异步任务；状态走 `/openapi/v1/work/status`，结果走 webhook。 `model` 各能力差异以服务端注册表为准（duration / ratio / resolution / reference_* 上限按模型而定）。
| Argument | Type | Description |
|---|---|---|
| model | string | 模型短名称，省略时走服务端默认。 |
| ratio | string | 取值集因 model 而异，详见请求体表格。 |
| prompt | string | |
| duration | integer | 视频时长（秒）。取值集 / 范围因 model 而异，详见请求体表格。 |
| end_frame | string | 尾帧图片 URL |
| resolution | string | 仅部分模型支持；取值集因 model 而异，详见请求体表格。 |
| callback_id | string | 自定义追踪 ID，webhook URL 后台配置 |
| start_frame | string | 首帧图片 URL |
| idempotency_key | string | 幂等键，相同 key 重复请求复用同一任务 |
| reference_audios | array | |
| reference_images | array |
视频水印消除
| Argument | Type | Description |
|---|---|---|
| video_url | string | |
| callback_id | string | 自定义追踪 ID，webhook URL 后台配置 |
| workspace_id | integer |
{
"type": "object",
"properties": {
"video_url": {
"type": "string"
},
"callback_id": {
"type": "string",
"description": "自定义追踪 ID，webhook URL 后台配置"
},
"workspace_id": {
"type": "integer",
"format": "int64"
}
},
"description": "视频水印消除任务。"
}视频对口型
| Argument | Type | Description |
|---|---|---|
| prompt | string | |
| audio_url | string | |
| avatar_url | string | |
| callback_id | string | 自定义追踪 ID，webhook URL 后台配置 |
{
"type": "object",
"properties": {
"prompt": {
"type": "string"
},
"audio_url": {
"type": "string"
},
"avatar_url": {
"type": "string"
},
"callback_id": {
"type": "string",
"description": "自定义追踪 ID，webhook URL 后台配置"
}
},
"description": "视频对口型任务。"
}AI 视频消除
| Argument | Type | Description |
|---|---|---|
| method | string | 消除方法 |
| duration | integer | 时长（秒） |
| video_url | string | 视频 URL |
| callback_id | string | 回调标识 |
| workspace_id | string | 工作空间 ID |
| idempotency_key | string | 幂等键 |
{
"type": "object",
"properties": {
"method": {
"type": "string",
"description": "消除方法"
},
"duration": {
"type": "integer",
"format": "int32",
"description": "时长（秒）"
},
"video_url": {
"type": "string",
"description": "视频 URL"
},
"callback_id": {
"type": "string",
"description": "回调标识"
},
"workspace_id": {
"type": "string",
"description": "工作空间 ID"
},
"idempotency_key": {
"type": "string",
"description": "幂等键"
}
},
"description": "AI 视频消除请求"
}视频动作控制
| Argument | Type | Description |
|---|---|---|
| mode | string | |
| prompt | string | |
| image_url | string | |
| video_url | string | |
| callback_id | string | 自定义追踪 ID，webhook URL 后台配置 |
| workspace_id | integer | |
| negative_prompt | string | |
| keep_original_sound | boolean | |
| character_orientation | string | 角色朝向，默认与视频一致时可传 video |
{
"type": "object",
"properties": {
"mode": {
"type": "string"
},
"prompt": {
"type": "string"
},
"image_url": {
"type": "string"
},
"video_url": {
"type": "string"
},
"callback_id": {
"type": "string",
"description": "自定义追踪 ID，webhook URL 后台配置"
},
"workspace_id": {
"type": "integer",
"format": "int64"
},
"negative_prompt": {
"type": "string"
},
"keep_original_sound": {
"type": "boolean"
},
"character_orientation": {
"type": "string",
"description": "角色朝向，默认与视频一致时可传 video"
}
},
"description": "视频动作控制任务。"
}视频字幕
| Argument | Type | Description |
|---|---|---|
| video_url | string | |
| style_type | string | |
| callback_id | string | 自定义追踪 ID，webhook URL 后台配置 |
| workspace_id | integer | |
| source_language | string | |
| subtitle_format | string | |
| translate_language | string |
{
"type": "object",
"properties": {
"video_url": {
"type": "string"
},
"style_type": {
"type": "string"
},
"callback_id": {
"type": "string",
"description": "自定义追踪 ID，webhook URL 后台配置"
},
"workspace_id": {
"type": "integer",
"format": "int64"
},
"source_language": {
"type": "string"
},
"subtitle_format": {
"type": "string"
},
"translate_language": {
"type": "string"
}
},
"description": "视频字幕任务。"
}视频翻译
| Argument | Type | Description |
|---|---|---|
| video_url | string | |
| callback_id | string | 自定义追踪 ID，webhook URL 后台配置 |
| target_lang | string | 目标语言 |
| workspace_id | integer |
{
"type": "object",
"properties": {
"video_url": {
"type": "string"
},
"callback_id": {
"type": "string",
"description": "自定义追踪 ID，webhook URL 后台配置"
},
"target_lang": {
"type": "string",
"description": "目标语言"
},
"workspace_id": {
"type": "integer",
"format": "int64"
}
},
"description": "视频翻译任务。"
}视频超分
| Argument | Type | Description |
|---|---|---|
| video_url | string | |
| callback_id | string | 自定义追踪 ID，webhook URL 后台配置 |
| workspace_id | integer |
{
"type": "object",
"properties": {
"video_url": {
"type": "string"
},
"callback_id": {
"type": "string",
"description": "自定义追踪 ID，webhook URL 后台配置"
},
"workspace_id": {
"type": "integer",
"format": "int64"
}
},
"description": "视频超分任务。"
}| reference_videos | array |
{
"type": "object",
"properties": {
"model": {
"enum": [
"veo-3.1",
"kling-3.0",
"grok",
"seedance-2.0",
"happyhorse-1.0"
],
"type": "string",
"example": "veo-3.1",
"description": "模型短名称，省略时走服务端默认。"
},
"ratio": {
"enum": [
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
],
"type": "string",
"example": "16:9",
"description": "取值集因 model 而异，详见请求体表格。"
},
"prompt": {
"type": "string"
},
"duration": {
"type": "integer",
"format": "int32",
"description": "视频时长（秒）。取值集 / 范围因 model 而异，详见请求体表格。"
},
"end_frame": {
"type": "string",
"description": "尾帧图片 URL"
},
"resolution": {
"enum": [
"720p",
"1080p",
"4k"
],
"type": "string",
"example": "1080p",
"description": "仅部分模型支持；取值集因 model 而异，详见请求体表格。"
},
"callback_id": {
"type": "string",
"description": "自定义追踪 ID，webhook URL 后台配置"
},
"start_frame": {
"type": "string",
"description": "首帧图片 URL"
},
"idempotency_key": {
"type": "string",
"description": "幂等键，相同 key 重复请求复用同一任务"
},
"reference_audios": {
"type": "array",
"items": {
"type": "string"
}
},
"reference_images": {
"type": "array",
"items": {
"type": "string"
}
},
"reference_videos": {
"type": "array",
"items": {
"type": "string"
}
}
},
"description": "视频生成。文生视频时 `start_frame` / `end_frame` / `reference_*` 留空；\n图生视频时通过 `start_frame`（可叠加 `end_frame`）控制首尾帧；多参考媒体由 `reference_images` / `reference_videos` / `reference_audios` 携带。\n\n**各模型规则**（取值集与上限按模型而定，服务端校验为准）：\n\n| model | duration | resolution | ratio | start/end_frame | reference_images | reference_videos | reference_audios | 备注 |\n|---|---|---|---|---|---|---|---|---|\n| `veo-3.1` | 4/6/8（默认 8） | 720p / 1080p / 4k | 16:9 / 9:16 | ≤2 | 无上限 | — | — | frame 与 reference 互斥 |\n| `kling-3.0` | 3~15（默认 8） | — | — | ≤2 | ≤1 | — | — | |\n| `grok` | 6/10（默认 6） | — | — | 不支持 | ≤1（作为首帧使用） | — | — | |\n| `seedance-2.0` | 4~15（默认 15） | 720p / 1080p | — | ≤2 | ≤9 | ≤3 | ≤3 | frame 与 reference 互斥；audio 需配 image/video |\n| `happyhorse-1.0` | 3~15（默认 5） | 720p / 1080p | 16:9 / 9:16 / 1:1 / 4:3 / 3:4 | ≤1 | ≤9 | ≤1（有视频时图片改限 ≤5） | — | frame 与 reference 互斥 |\n"
}