AdsTurbo

AI ad creatives: clone reference ads, AI spokesperson videos, video generation, translation, images.

사용해야 할까요

품질 및 안전성

B
설명 품질
33%
스키마 완전성
80%
이름 품질
81%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

발견 사항 (48)

  • LOWTool 'ad_clone_analyze' has short descriptionad_clone_analyze에서
  • LOWTool 'ad_clone_analyze' description lacks action verbad_clone_analyze에서
  • LOWTool 'ad_clone_generate' has short descriptionad_clone_generate에서
  • LOWTool 'ad_clone_generate' description lacks action verbad_clone_generate에서
  • LOWTool 'ai_actor_list' has short descriptionai_actor_list에서
  • LOWTool 'ai_actor_list' description lacks action verbai_actor_list에서
  • LOWTool 'ai_actor_perform' description lacks action verbai_actor_perform에서
  • LOWTool 'ai_actor_say' has short descriptionai_actor_say에서
  • LOWTool 'ai_actor_say' description lacks action verbai_actor_say에서
  • LOWTool 'batch_get_work_status' description lacks action verbbatch_get_work_status에서

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~7,335토큰 (도구 정의)
~1.5 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 5.73%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`claude_desktop_config.json` 파일에 다음을 추가하세요:

{
  "mcpServers": {
    "adsturbo": {
      "url": "https://adsturbo.ai/klian/novartapi/mcp"
    }
  }
}

원격 엔드포인트

https://adsturbo.ai/klian/novartapi/mcpstreamable-http

할 수 있는 일

도구 목록

도구 (30)

🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢ad_clone_analyze(clip_end, clip_start, video_url)

视频复刻 — 分析

입력 스키마

{
  "type": "object",
  "properties": {
    "clip_end": {
      "description": "圈选结束时间(秒);须 clip_end > clip_start,且 clip_end - clip_start ≤ 12(片段最长 12 秒)",
      "format": "int32",
      "minimum": 0,
      "type": "integer"
    },
    "clip_start": {
      "description": "圈选起始时间(秒,非负)",
      "format": "int32",
      "minimum": 0,
      "type": "integer"
    },
    "video_url": {
      "description": "源视频 URL",
      "type": "string"
    }
  },
  "description": "视频复刻 — 分析源视频并生成 prompt。"
}
⚪ad_clone_generate(callback_id, duration, prompt, ratio, video_url)

视频复刻 — 生成

입력 스키마

{
  "type": "object",
  "properties": {
    "callback_id": {
      "description": "自定义追踪 ID,webhook URL 后台配置",
      "type": "string"
    },
    "duration": {
      "description": "生成时长(秒);不在可选值内(含不传)按 12",
      "enum": [
        4,
        8,
        12,
        16,
        20
      ],
      "format": "int32",
      "type": "integer"
    },
    "prompt": {
      "description": "prompt(可在 Analyze 返回基础上修改)",
      "type": "string"
    },
    "ratio": {
      "description": "视频比例,空 = `9:16`",
      "type": "string"
    },
    "video_url": {
      "description": "源视频片段 URL(Analyze 返回的 video_segment_url)",
      "type": "string"
    }
  },
  "description": "视频复刻 — 提交生成任务;响应含异步任务 ID(`workspace_id`)。"
}
🟢ai_actor_list(age, ethnicity, gender, industry, limit, ...)

系统演员列表

입력 스키마

{
  "type": "object",
  "properties": {
    "age": {
      "items": {
        "enum": [
          "senior",
          "adult",
          "young-adult",
          "kid"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "ethnicity": {
      "items": {
        "enum": [
          "asian",
          "caucasian",
          "african",
          "latino"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "gender": {
      "items": {
        "enum": [
          "female",
          "male"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "industry": {
      "description": "按服务端行业分类过滤(如 `beauty` / `fitness` / `finance` 等);取值集以服务端注册表为准。\n",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "limit": {
      "format": "int32",
      "type": "integer"
    },
    "offset": {
      "format": "int32",
      "type": "integer"
    },
    "pose": {
      "items": {
        "enum": [
          "arms-crossed",
          "cross-legged",
          "gesturing",
          "leaning",
          "leaning-forward",
          "legs-crossed",
          "pointing",
          "reclining",
          "sitting",
          "standing"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "shot_type": {
      "items": {
        "enum": [
          "close-up",
          "full-shot",
          "long-shot",
          "medium-close-up",
          "medium-full-shot",
          "medium-shot"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "situation": {
      "items": {
        "enum": [
          "balcony",
          "beach",
          "bedroom",
          "car",
          "coffee-shop",
          "grwm",
          "home",
          "kitchen",
          "medical",
          "news-anchor",
          "office",
          "podcast",
          "snow",
          "studio"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "sort_by": {
      "type": "string"
    }
  },
  "description": "系统演员列表筛选与分页;筛选项为小写,英文短语中空格用连字符。"
}
⚪ai_actor_perform(actor_id, auto_emotion, callback_id, script, similarity, ...)

演员演出(系统演员或 Persona) `actor_id` 既可为系统演员 ID,也可为自定义 Persona 的 `actor_id`,共用同一套演出参数与异步任务响应。

입력 스키마

{
  "type": "object",
  "properties": {
    "actor_id": {
      "description": "系统演员 ID,或 Persona 的 actor_id",
      "type": "string"
    },
    "auto_emotion": {
      "type": "boolean"
    },
    "callback_id": {
      "description": "自定义追踪 ID,webhook URL 后台配置",
      "type": "string"
    },
    "script": {
      "type": "string"
    },
    "similarity": {
      "format": "float",
      "type": "number"
    },
    "speaker_boost": {
      "type": "boolean"
    },
    "speed": {
      "format": "float",
      "type": "number"
    },
    "stability": {
      "format": "float",
      "type": "number"
    },
    "style": {
      "format": "float",
      "type": "number"
    }
  },
  "description": "演出任务请求;适用于系统演员与自定义 Persona。"
}
⚪ai_actor_say(actor_id, auto_emotion, script, similarity, speed, ...)

系统演员语音生成

입력 스키마

{
  "type": "object",
  "properties": {
    "actor_id": {
      "type": "string"
    },
    "auto_emotion": {
      "type": "boolean"
    },
    "script": {
      "type": "string"
    },
    "similarity": {
      "format": "float",
      "type": "number"
    },
    "speed": {
      "format": "float",
      "type": "number"
    },
    "stability": {
      "format": "float",
      "type": "number"
    }
  },
  "description": "系统演员语音合成请求。"
}
🟢batch_get_work_status(workspace_ids)

批量查询异步任务状态

입력 스키마

{
  "type": "object",
  "properties": {
    "workspace_ids": {
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "description": "批量按 `workspace_ids` 查询异步任务状态。"
}
🟢get_persona_status(actor_id)

查询 Persona 状态

입력 스키마

{
  "type": "object",
  "properties": {
    "actor_id": {
      "type": "string"
    }
  },
  "description": "按 `actor_id` 查询 Persona 状态。"
}
🟢get_work_status(workspace_id)

查询异步任务状态

입력 스키마

{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string"
    }
  },
  "description": "按 `workspace_id` 查询异步任务状态。"
}
🟡image_create(callback_id, idempotency_key, image_urls, model, prompt, ...)

图片生成 / 编辑 每次调用固定生成 **1 张**。 默认异步:返回 `workspace_id`(`status=pending`,`result_type=image`),用 `work/status` 轮询取 `result_url`; `sync_mod=true` 时同步阻塞到出图,响应里 `result_url` 直接为图片 URL(`status=completed`)。

입력 스키마

{
  "type": "object",
  "properties": {
    "callback_id": {
      "description": "自定义追踪 ID,在响应中原样回传",
      "type": "string"
    },
    "idempotency_key": {
      "description": "幂等键(预留字段,当前服务端未对本接口做去重)",
      "type": "string"
    },
    "image_urls": {
      "description": "文生图时为空数组;编辑时非空,上限因 model 而异。\n",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "model": {
      "description": "可选。默认 `nanobanana-pro`。",
      "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"
      ],
      "example": "nanobanana-pro",
      "type": "string"
    },
    "prompt": {
      "description": "生成 / 编辑指令",
      "type": "string"
    },
    "ratio": {
      "description": "取值集因 model 而异,详见请求体表格。",
      "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"
      ],
      "example": "9:16",
      "type": "string"
    },
    "resolution": {
      "description": "仅 `nanobanana-pro` / `nano-banana-2` / `nano-banana-2-fast` / `seedream-5.0-pro` / `gpt-image-2` 支持;取值集详见请求体表格。\n",
      "enum": [
        "0.5k",
        "1k",
        "2k",
        "4k",
        "8k"
      ],
      "example": "2k",
      "type": "string"
    },
    "sync_mod": {
      "description": "`true` 同步阻塞到出图(最长约 60 秒);默认 `false` 异步返回 `workspace_id`。",
      "example": false,
      "type": "boolean"
    }
  },
  "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"
}
⚪image_cutout(callback_id, idempotency_key, image_url, method, output_format, ...)

图片抠图

입력 스키마

{
  "type": "object",
  "properties": {
    "callback_id": {
      "description": "回调标识",
      "type": "string"
    },
    "idempotency_key": {
      "description": "幂等键,防止重复提交",
      "type": "string"
    },
    "image_url": {
      "description": "原图 URL",
      "type": "string"
    },
    "method": {
      "description": "抠图方法",
      "type": "string"
    },
    "output_format": {
      "description": "输出格式",
      "type": "string"
    },
    "resolution": {
      "description": "输出分辨率",
      "type": "string"
    },
    "workspace_id": {
      "description": "工作空间 ID,用于关联异步任务",
      "type": "string"
    }
  },
  "description": "图片抠图请求"
}
⚪image_ecommerce(aspect_ratio, callback_id, idempotency_key, language, methods, ...)

电商产品图

입력 스키마

{
  "type": "object",
  "properties": {
    "aspect_ratio": {
      "description": "宽高比",
      "type": "string"
    },
    "callback_id": {
      "description": "回调标识",
      "type": "string"
    },
    "idempotency_key": {
      "description": "幂等键",
      "type": "string"
    },
    "language": {
      "description": "语言",
      "type": "string"
    },
    "methods": {
      "description": "生成方法列表",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "product_info": {
      "description": "产品信息",
      "type": "string"
    },
    "reference_image_urls": {
      "description": "参考图片 URL 列表",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "resolution": {
      "description": "输出分辨率",
      "type": "string"
    },
    "user_input": {
      "description": "用户输入描述",
      "type": "string"
    },
    "workspace_id": {
      "description": "工作空间 ID",
      "type": "string"
    }
  },
  "description": "电商产品图请求"
}
⚪image_enhance(callback_id, idempotency_key, image_url, method, resolution, ...)

图片增强

입력 스키마

{
  "type": "object",
  "properties": {
    "callback_id": {
      "description": "回调标识",
      "type": "string"
    },
    "idempotency_key": {
      "description": "幂等键",
      "type": "string"
    },
    "image_url": {
      "description": "原图 URL",
      "type": "string"
    },
    "method": {
      "description": "增强方法",
      "type": "string"
    },
    "resolution": {
      "description": "输出分辨率",
      "type": "string"
    },
    "scale": {
      "description": "放大倍数",
      "format": "int32",
      "type": "integer"
    },
    "workspace_id": {
      "description": "工作空间 ID",
      "type": "string"
    }
  },
  "description": "图片增强请求"
}
⚪image_magic_eraser(aspect_ratio, callback_id, idempotency_key, image_url, instruction, ...)

AI 图片消除

입력 스키마

{
  "type": "object",
  "properties": {
    "aspect_ratio": {
      "description": "宽高比",
      "type": "string"
    },
    "callback_id": {
      "description": "回调标识",
      "type": "string"
    },
    "idempotency_key": {
      "description": "幂等键",
      "type": "string"
    },
    "image_url": {
      "description": "原图 URL",
      "type": "string"
    },
    "instruction": {
      "description": "消除指令描述",
      "type": "string"
    },
    "mask_url": {
      "description": "蒙版 URL",
      "type": "string"
    },
    "method": {
      "description": "消除方法",
      "type": "string"
    },
    "quantity": {
      "description": "生成数量",
      "format": "int32",
      "type": "integer"
    },
    "resolution": {
      "description": "输出分辨率",
      "type": "string"
    },
    "workspace_id": {
      "description": "工作空间 ID",
      "type": "string"
    }
  },
  "description": "AI 图片消除请求"
}
⚪image_poster(aspect_ratio, callback_id, event_info, idempotency_key, language, ...)

活动海报图

입력 스키마

{
  "type": "object",
  "properties": {
    "aspect_ratio": {
      "description": "宽高比",
      "type": "string"
    },
    "callback_id": {
      "description": "回调标识",
      "type": "string"
    },
    "event_info": {
      "description": "活动信息",
      "type": "string"
    },
    "idempotency_key": {
      "description": "幂等键",
      "type": "string"
    },
    "language": {
      "description": "语言",
      "type": "string"
    },
    "method": {
      "description": "海报生成方法",
      "type": "string"
    },
    "reference_image_urls": {
      "description": "参考图片 URL 列表",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "resolution": {
      "description": "输出分辨率",
      "type": "string"
    },
    "workspace_id": {
      "description": "工作空间 ID",
      "type": "string"
    }
  },
  "description": "活动海报图请求"
}
🟡persona_create(callback_id, name, photo_url, voice_audio_url)

创建自定义 Persona

입력 스키마

{
  "type": "object",
  "properties": {
    "callback_id": {
      "description": "自定义追踪 ID,webhook URL 后台配置",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "photo_url": {
      "type": "string"
    },
    "voice_audio_url": {
      "description": "可选,用于语音克隆",
      "type": "string"
    }
  },
  "description": "创建自定义 Persona 请求。"
}
🔴persona_delete(actor_id)

删除自定义 Persona

입력 스키마

{
  "type": "object",
  "properties": {
    "actor_id": {
      "type": "string"
    }
  },
  "description": "删除 Persona 请求。"
}
🟢persona_list(limit, offset)

个人创建演员列表 分页查询当前用户创建的个人演员(Persona)列表。

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "format": "int32",
      "type": "integer"
    },
    "offset": {
      "format": "int32",
      "type": "integer"
    }
  },
  "description": "个人创建演员列表分页查询;`offset`、`limit` 为分页参数。"
}
🟢video_analyze(callback_id, video_url, workspace_id)

视频拉片

입력 스키마

{
  "type": "object",
  "properties": {
    "callback_id": {
      "description": "自定义追踪 ID,webhook URL 后台配置",
      "type": "string"
    },
    "video_url": {
      "description": "源视频 URL",
      "type": "string"
    },
    "workspace_id": {
      "description": "关联工作区 ID,无则传 0",
      "format": "int64",
      "type": "integer"
    }
  },
  "description": "视频拉片任务。"
}
⚪video_character_swap(callback_id, image_url, video_url, workspace_id)

视频换脸

입력 스키마

{
  "type": "object",
  "properties": {
    "callback_id": {
      "description": "自定义追踪 ID,webhook URL 后台配置",
      "type": "string"
    },
    "image_url": {
      "description": "目标人脸参考图 URL",
      "type": "string"
    },
    "video_url": {
      "type": "string"
    },
    "workspace_id": {
      "format": "int64",
      "type": "integer"
    }
  },
  "description": "视频换脸任务。"
}
🟡video_edit(callback_id, idempotency_key, mask_url, model, prompt, ...)

视频编辑 **仅支持 `seedance-2.0` 模型基座**。 源视频二选一:`workspace_id` 或 `video_url`;同时传 / 同时空均报错。 `mask_url` 可选;非空时为局部编辑掩码。

입력 스키마

{
  "type": "object",
  "properties": {
    "callback_id": {
      "description": "自定义追踪 ID,webhook URL 后台配置",
      "type": "string"
    },
    "idempotency_key": {
      "type": "string"
    },
    "mask_url": {
      "type": "string"
    },
    "model": {
      "default": "seedance-2.0",
      "description": "仅支持 `seedance-2.0`。",
      "enum": [
        "seedance-2.0"
      ],
      "type": "string"
    },
    "prompt": {
      "type": "string"
    },
    "ratio": {
      "type": "string"
    },
    "reference_images": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "resolution": {
      "enum": [
        "720p",
        "1080p"
      ],
      "type": "string"
    },
    "video_url": {
      "type": "string"
    },
    "workspace_id": {
      "type": "string"
    }
  },
  "description": "视频编辑。源视频二选一:`workspace_id` 或 `video_url`;同时传 / 同时空均报错。\n`mask_url` 可选;非空时为局部编辑掩码(模型支持度以服务端为准)。\n\n**仅支持 `seedance-2.0` 模型基座**,不开放其他模型。`resolution` 取 `720p` / `1080p`。\n"
}
⚪video_enhance_v2(callback_id, duration, idempotency_key, method, resolution, ...)

视频增强

입력 스키마

{
  "type": "object",
  "properties": {
    "callback_id": {
      "description": "回调标识",
      "type": "string"
    },
    "duration": {
      "description": "时长(秒)",
      "format": "int32",
      "type": "integer"
    },
    "idempotency_key": {
      "description": "幂等键",
      "type": "string"
    },
    "method": {
      "description": "增强方法",
      "type": "string"
    },
    "resolution": {
      "description": "输出分辨率",
      "type": "string"
    },
    "video_url": {
      "description": "视频 URL",
      "type": "string"
    },
    "workspace_id": {
      "description": "工作空间 ID",
      "type": "string"
    }
  },
  "description": "视频增强请求"
}
⚪video_extend(callback_id, duration, idempotency_key, model, prompt, ...)

视频延长(在源视频末尾追加 N 秒) **仅支持 `seedance-2.0` 模型基座**。 源视频二选一:`workspace_id`(内部)或 `video_url`(外部);同时传 / 同时空均报错。 `duration` 为增量秒数:原 8s + duration=4 → 输出 12s。

입력 스키마

{
  "type": "object",
  "properties": {
    "callback_id": {
      "description": "自定义追踪 ID,webhook URL 后台配置",
      "type": "string"
    },
    "duration": {
      "description": "在源视频末尾追加的秒数;范围 4~15,默认 15。",
      "format": "int32",
      "maximum": 15,
      "minimum": 4,
      "type": "integer"
    },
    "idempotency_key": {
      "type": "string"
    },
    "model": {
      "default": "seedance-2.0",
      "description": "仅支持 `seedance-2.0`。",
      "enum": [
        "seedance-2.0"
      ],
      "type": "string"
    },
    "prompt": {
      "type": "string"
    },
    "ratio": {
      "type": "string"
    },
    "resolution": {
      "enum": [
        "720p",
        "1080p"
      ],
      "type": "string"
    },
    "video_url": {
      "type": "string"
    },
    "workspace_id": {
      "type": "string"
    }
  },
  "description": "视频延长。源视频二选一:`workspace_id`(内部)或 `video_url`(外部);同时传 / 同时空均报错。\n`duration` 为增量秒数。\n\n**仅支持 `seedance-2.0` 模型基座**,不开放其他模型。`duration` 取值范围 4~15(默认 15),`resolution` 取 `720p` / `1080p`。\n"
}
⚪video_generate(callback_id, duration, end_frame, idempotency_key, model, ...)

视频生成(文生 / 图生 / 首尾帧 / 多参考媒体) 异步任务;状态走 `/openapi/v1/work/status`,结果走 webhook。 `model` 各能力差异以服务端注册表为准(duration / ratio / resolution / reference_* 上限按模型而定)。

입력 스키마

{
  "type": "object",
  "properties": {
    "callback_id": {
      "description": "自定义追踪 ID,webhook URL 后台配置",
      "type": "string"
    },
    "duration": {
      "description": "视频时长(秒)。取值集 / 范围因 model 而异,详见请求体表格。",
      "format": "int32",
      "type": "integer"
    },
    "end_frame": {
      "description": "尾帧图片 URL",
      "type": "string"
    },
    "idempotency_key": {
      "description": "幂等键,相同 key 重复请求复用同一任务",
      "type": "string"
    },
    "model": {
      "description": "模型短名称,省略时走服务端默认。",
      "enum": [
        "veo-3.1",
        "kling-3.0",
        "grok",
        "seedance-2.0",
        "happyhorse-1.0"
      ],
      "example": "veo-3.1",
      "type": "string"
    },
    "prompt": {
      "type": "string"
    },
    "ratio": {
      "description": "取值集因 model 而异,详见请求体表格。",
      "enum": [
        "16:9",
        "9:16",
        "1:1",
        "4:3",
        "3:4"
      ],
      "example": "16:9",
      "type": "string"
    },
    "reference_audios": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "reference_images": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "reference_videos": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "resolution": {
      "description": "仅部分模型支持;取值集因 model 而异,详见请求体表格。",
      "enum": [
        "720p",
        "1080p",
        "4k"
      ],
      "example": "1080p",
      "type": "string"
    },
    "start_frame": {
      "description": "首帧图片 URL",
      "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"
}
⚪video_inpaint(callback_id, video_url, workspace_id)

视频水印消除

입력 스키마

{
  "type": "object",
  "properties": {
    "callback_id": {
      "description": "自定义追踪 ID,webhook URL 后台配置",
      "type": "string"
    },
    "video_url": {
      "type": "string"
    },
    "workspace_id": {
      "format": "int64",
      "type": "integer"
    }
  },
  "description": "视频水印消除任务。"
}
⚪video_lip_sync(audio_url, avatar_url, callback_id, prompt)

视频对口型

입력 스키마

{
  "type": "object",
  "properties": {
    "audio_url": {
      "type": "string"
    },
    "avatar_url": {
      "type": "string"
    },
    "callback_id": {
      "description": "自定义追踪 ID,webhook URL 后台配置",
      "type": "string"
    },
    "prompt": {
      "type": "string"
    }
  },
  "description": "视频对口型任务。"
}
⚪video_magic_eraser(callback_id, duration, idempotency_key, method, video_url, ...)

AI 视频消除

입력 스키마

{
  "type": "object",
  "properties": {
    "callback_id": {
      "description": "回调标识",
      "type": "string"
    },
    "duration": {
      "description": "时长(秒)",
      "format": "int32",
      "type": "integer"
    },
    "idempotency_key": {
      "description": "幂等键",
      "type": "string"
    },
    "method": {
      "description": "消除方法",
      "type": "string"
    },
    "video_url": {
      "description": "视频 URL",
      "type": "string"
    },
    "workspace_id": {
      "description": "工作空间 ID",
      "type": "string"
    }
  },
  "description": "AI 视频消除请求"
}
⚪video_motion_control(callback_id, character_orientation, image_url, keep_original_sound, mode, ...)

视频动作控制

입력 스키마

{
  "type": "object",
  "properties": {
    "callback_id": {
      "description": "自定义追踪 ID,webhook URL 后台配置",
      "type": "string"
    },
    "character_orientation": {
      "description": "角色朝向,默认与视频一致时可传 video",
      "type": "string"
    },
    "image_url": {
      "type": "string"
    },
    "keep_original_sound": {
      "type": "boolean"
    },
    "mode": {
      "type": "string"
    },
    "negative_prompt": {
      "type": "string"
    },
    "prompt": {
      "type": "string"
    },
    "video_url": {
      "type": "string"
    },
    "workspace_id": {
      "format": "int64",
      "type": "integer"
    }
  },
  "description": "视频动作控制任务。"
}
⚪video_subtitle(callback_id, source_language, style_type, subtitle_format, translate_language, ...)

视频字幕

입력 스키마

{
  "type": "object",
  "properties": {
    "callback_id": {
      "description": "自定义追踪 ID,webhook URL 后台配置",
      "type": "string"
    },
    "source_language": {
      "type": "string"
    },
    "style_type": {
      "type": "string"
    },
    "subtitle_format": {
      "type": "string"
    },
    "translate_language": {
      "type": "string"
    },
    "video_url": {
      "type": "string"
    },
    "workspace_id": {
      "format": "int64",
      "type": "integer"
    }
  },
  "description": "视频字幕任务。"
}
⚪video_translate(callback_id, target_lang, video_url, workspace_id)

视频翻译

입력 스키마

{
  "type": "object",
  "properties": {
    "callback_id": {
      "description": "自定义追踪 ID,webhook URL 后台配置",
      "type": "string"
    },
    "target_lang": {
      "description": "目标语言",
      "type": "string"
    },
    "video_url": {
      "type": "string"
    },
    "workspace_id": {
      "format": "int64",
      "type": "integer"
    }
  },
  "description": "视频翻译任务。"
}
⚪video_upscale(callback_id, video_url, workspace_id)

视频超分

입력 스키마

{
  "type": "object",
  "properties": {
    "callback_id": {
      "description": "自定义追踪 ID,webhook URL 后台配置",
      "type": "string"
    },
    "video_url": {
      "type": "string"
    },
    "workspace_id": {
      "format": "int64",
      "type": "integer"
    }
  },
  "description": "视频超分任务。"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 30개