AdsTurbo

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

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

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "AdsTurbo": {
      "url": "https://adsturbo.ai/klian/novartapi/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (31)

• ad_clone_analyze

  视频复刻 — 分析

  Parameters:

  • clip_end — integer — 圈选结束时间（秒）；须 clip_end > clip_start，且 clip_end - clip_start ≤ 12（片段最长 12 秒）
  • video_url — string — 源视频 URL
  • clip_start — integer — 圈选起始时间（秒，非负）

  Hints: read-only no · destructive no · idempotent no · open-world yes

• ad_clone_generate

  视频复刻 — 生成

  Parameters:

  • 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 后台配置

  Hints: read-only no · destructive no · idempotent no · open-world yes

• ai_actor_list read-only

  系统演员列表

  Parameters:

  • 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

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• ai_actor_perform

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

  Parameters:

  • 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

  Hints: read-only no · destructive no · idempotent no · open-world no

• ai_actor_say

  系统演员语音生成

  Parameters:

  • speed — number
  • script — string
  • actor_id — string
  • stability — number
  • similarity — number
  • auto_emotion — boolean

  Hints: read-only no · destructive no · idempotent no · open-world no

• batch_get_work_status read-only

  批量查询异步任务状态

  Parameters:

  • workspace_ids — array

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_persona_status read-only

  查询 Persona 状态

  Parameters:

  • actor_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_work_status read-only

  查询异步任务状态

  Parameters:

  • workspace_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• image_create

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

  Parameters:

  • 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 — 幂等键（预留字段，当前服务端未对本接口做去重）

  Hints: read-only no · destructive no · idempotent no · open-world yes

• image_cutout

  图片抠图

  Parameters:

  • method — string — 抠图方法
  • image_url — string — 原图 URL
  • resolution — string — 输出分辨率
  • callback_id — string — 回调标识
  • workspace_id — string — 工作空间 ID，用于关联异步任务
  • output_format — string — 输出格式
  • idempotency_key — string — 幂等键，防止重复提交

  Hints: read-only no · destructive no · idempotent no · open-world yes

• image_ecommerce

  电商产品图

  Parameters:

  • 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 列表

  Hints: read-only no · destructive no · idempotent no · open-world yes

• image_enhance

  图片增强

  Parameters:

  • scale — integer — 放大倍数
  • method — string — 增强方法
  • image_url — string — 原图 URL
  • resolution — string — 输出分辨率
  • callback_id — string — 回调标识
  • workspace_id — string — 工作空间 ID
  • idempotency_key — string — 幂等键

  Hints: read-only no · destructive no · idempotent no · open-world yes

• image_magic_eraser

  AI 图片消除

  Parameters:

  • 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 — 幂等键

  Hints: read-only no · destructive no · idempotent no · open-world yes

• image_poster

  活动海报图

  Parameters:

  • 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 列表

  Hints: read-only no · destructive no · idempotent no · open-world yes

• persona_create

  创建自定义 Persona

  Parameters:

  • name — string
  • photo_url — string
  • callback_id — string — 自定义追踪 ID，webhook URL 后台配置
  • voice_audio_url — string — 可选，用于语音克隆

  Hints: read-only no · destructive no · idempotent no · open-world yes

• persona_delete destructive

  删除自定义 Persona

  Parameters:

  • actor_id — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• persona_list read-only

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

  Parameters:

  • limit — integer
  • offset — integer

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• video_analyze

  视频拉片

  Parameters:

  • video_url — string — 源视频 URL
  • callback_id — string — 自定义追踪 ID，webhook URL 后台配置
  • workspace_id — integer — 关联工作区 ID，无则传 0

  Hints: read-only no · destructive no · idempotent no · open-world yes

• video_character_swap

  视频换脸

  Parameters:

  • image_url — string — 目标人脸参考图 URL
  • video_url — string
  • callback_id — string — 自定义追踪 ID，webhook URL 后台配置
  • workspace_id — integer

  Hints: read-only no · destructive no · idempotent no · open-world yes

• video_edit

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

  Parameters:

  • 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

  Hints: read-only no · destructive no · idempotent no · open-world yes

• video_enhance_v2

  视频增强

  Parameters:

  • method — string — 增强方法
  • duration — integer — 时长（秒）
  • video_url — string — 视频 URL
  • resolution — string — 输出分辨率
  • callback_id — string — 回调标识
  • workspace_id — string — 工作空间 ID
  • idempotency_key — string — 幂等键

  Hints: read-only no · destructive no · idempotent no · open-world yes

• video_extend

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

  Parameters:

  • 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

  Hints: read-only no · destructive no · idempotent no · open-world yes

• video_generate

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

  Parameters:

  • 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
  • reference_videos — array

  Hints: read-only no · destructive no · idempotent no · open-world yes

• video_inpaint

  视频水印消除

  Parameters:

  • video_url — string
  • callback_id — string — 自定义追踪 ID，webhook URL 后台配置
  • workspace_id — integer

  Hints: read-only no · destructive no · idempotent no · open-world yes

• video_lip_sync

  视频对口型

  Parameters:

  • prompt — string
  • audio_url — string
  • avatar_url — string
  • callback_id — string — 自定义追踪 ID，webhook URL 后台配置

  Hints: read-only no · destructive no · idempotent no · open-world yes

• video_magic_eraser

  AI 视频消除

  Parameters:

  • method — string — 消除方法
  • duration — integer — 时长（秒）
  • video_url — string — 视频 URL
  • callback_id — string — 回调标识
  • workspace_id — string — 工作空间 ID
  • idempotency_key — string — 幂等键

  Hints: read-only no · destructive no · idempotent no · open-world yes

• video_motion_control

  视频动作控制

  Parameters:

  • 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

  Hints: read-only no · destructive no · idempotent no · open-world yes

• video_subtitle

  视频字幕

  Parameters:

  • video_url — string
  • style_type — string
  • callback_id — string — 自定义追踪 ID，webhook URL 后台配置
  • workspace_id — integer
  • source_language — string
  • subtitle_format — string
  • translate_language — string

  Hints: read-only no · destructive no · idempotent no · open-world yes

• video_translate

  视频翻译

  Parameters:

  • video_url — string
  • callback_id — string — 自定义追踪 ID，webhook URL 后台配置
  • target_lang — string — 目标语言
  • workspace_id — integer

  Hints: read-only no · destructive no · idempotent no · open-world yes

• video_upscale

  视频超分

  Parameters:

  • video_url — string
  • callback_id — string — 自定义追踪 ID，webhook URL 后台配置
  • workspace_id — integer

  Hints: read-only no · destructive no · idempotent no · open-world yes

• fetch_video_from_link

  解析平台视频链接，换取可用的视频素材

  Parameters:

  • urls (required) — array — 视频分享链接，最多 5 个。可以直接传用户复制来的整段分享文案，会自动取出其中的链接。

  Hints: read-only no · destructive no · idempotent yes · open-world yes

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.