By Zengshi AI
API · v1 · Now Available

Accelerate Creative Output
with AdsTurbo API

Integrate AdsTurbo APIs — URL to Video, Image Generation, Persona, AI Actors, Ad Clone, Video Generation, and Work — directly into your platform and scale ad production programmatically.

API Docs
Using ChatGPT, Claude or Cursor? Connect via MCP →
24API Endpoints
AsyncJob Tracking
RESTStandard Protocol
Start Creating with AdsTurbo API Today

Modular building blocks for
programmable ad production.

Seven composable API modules. One creative infrastructure layer.

POST /url2video/createURL to Video

URL to Video

Send a product page URL and get a 15-second video ad back. One call does the whole job: the API reads the product page, plans the ad and renders the video in 9:16, 1:1 or 16:9 at 720p. If the page can't be read, pass the product details (title, description, price, images) instead. Also available as the create_ad_from_product_url tool on the hosted AdsTurbo MCP server.

View docs
POST /img/createImage Generation

Image Generation

Text-to-image and image editing. Supports 11 models (nanobanana-pro / seedream-4.5 / gpt-image-1.5 / gpt-image-2 / grok-2-image and more), with configurable ratio, resolution, and concurrency.

View docs
POST /persona/createPersona

Persona

Turn image and voice assets into reusable custom actors. Full lifecycle: create, list, status, and delete.

View docs
POST /aiactor/list · /aiactor/say · /aiactor/performAI Actors

AI Actors

Search the system actor library, generate voice audio, and drive actors or custom Personas with a script. Supports reusing previously created Personas directly.

View docs
POST /adclone/analyze · /adclone/generateAd Clone

Ad Clone

Two-step clone workflow: analyze a reference clip (max 12s) to extract style and structure, then generate brand-matched ad variations in parallel.

View docs
POST /video/analyze · /lipsync · /inpaint · ...Video Generation

Video Generation

Eight video processing endpoints: shot analysis, lip sync, watermark removal, translation, super-resolution, face swap, motion control, and subtitles.

View docs
POST /work/statusWork

Work

All generation jobs are async. Poll for job status or receive completion events via Webhook.

View docs

Prefer chatting to coding? Use AdsTurbo through MCP.

The same capabilities as the API, right inside ChatGPT, Claude, Cursor and WorkBuddy. Sign in once, no code.

Set up MCP
Top Use Cases of the AdsTurbo API

Unlock powerful ad automation
across industries.

Built for teams that need creative throughput, not just content generation.

Image Generation

Batch Ad Image Production

Generate brand-ready ad images at scale using the Image Generation API. Supports both text-to-image and image editing modes, with a choice of leading models and flexible control over aspect ratio, resolution, and concurrency. Ideal for DTC brands, e-commerce teams, and ad platforms that need high-volume creative output.

Batch Ad Image Production
Ad Clone

Automated Ad Creative Generation

Turn product assets and winning reference clips into brand-ready ad creatives. Build reusable virtual actors with the Persona API, then use the Ad Clone API to analyze a reference video's style and structure and generate multiple ad variations in parallel. Built for Creative SaaS platforms, DTC brands, and growth automation teams.

Automated Ad Creative Generation
AI Actors

AI Actor Video Marketing at Scale

Select from the system actor library or use a custom Persona, then drive them through a script to produce video performances. Voice audio can also be generated independently for dubbing workflows. Supports fine-grained control over emotion, speed, and voice tone — ideal for localized content production, sales videos, and brand storytelling.

AI Actor Video Marketing at Scale
Work

Platform-Grade Creative Orchestration

Connect product feeds, creative inputs, and campaign ops into one programmable ad production layer. All generation jobs run asynchronously, with support for polling job status and receiving webhook callbacks — making it straightforward to integrate into automated workflows. Built for agency workspaces and growth automation platforms.

Platform-Grade Creative Orchestration
Video Generation

Creator Platform Integration

Turn creator likeness, voice, and brand context into reusable ad production assets. The Video Generation module supports translation dubbing, lip sync, motion control, and more — enabling the same source material to be quickly adapted for different languages and styles, meeting cross-market content distribution needs.

Creator Platform Integration
Developer Integration

Simple REST API.
Production-ready from day one.

Bearer auth, async-friendly callbacks, and composable endpoints. Straightforward to integrate.

curl --request POST \
  --url https://adsturbo.ai/klian/novartapi/openapi/v1/img/create \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'authorization: Bearer YOUR_API_KEY' \
  --data '{
    "prompt": "Asian woman, home setting, natural light, commercial ad style",
    "image_urls": [],
    "model": "nanobanana-pro",
    "ratio": "9:16",
    "resolution": "2k",
    "concurrency": 1,
    "sync_mod": false
  }'

Bearer Authentication

Standard REST auth with API key. Pass your key in the Authorization header as Bearer YOUR_API_KEY.

Async Job Tracking

All generation jobs are async. Poll for job status or receive completion events via webhook.

Webhook Callbacks

Receive job completion events when generation finishes. Configure your webhook URL in the dashboard and include a custom identifier in requests to correlate events to specific jobs.

Frequently asked questions

01What is AdsTurbo API?

AdsTurbo API is a programmable creative infrastructure layer that lets you embed ad generation, Persona creation, and async production workflows directly into your product or platform.

02Can I turn a product page URL into a video ad with the API?

Yes. Call POST /openapi/v1/url2video/create with {"product_url": "<your product page>"}. The API returns a work_id; poll POST /openapi/v1/work/status until the job is completed, then download the video from result_url. Videos are 15 seconds long, in 9:16, 1:1 or 16:9 at 720p, and each one costs 270 credits. If the product page needs a login or can't be read, send a product object (title, description, price, images, brand) together with an ad_type instead. In Claude Code, Cursor or any MCP client, add the hosted AdsTurbo MCP server and call the create_ad_from_product_url tool.

03Who is AdsTurbo API for?

It's built for Creative SaaS platforms, agency workspaces, growth automation teams, and creator platforms that need to produce branded ad creatives at scale.

04How does the Persona API work?

Upload a photo and an optional voice sample to create a reusable virtual actor (Persona). Once created, the Persona can be used repeatedly across AI Actor performances, Ad Clone, and other generation workflows. Full lifecycle management is supported: create, query status, list, and delete.

05What models does the Image Generation API (/img/create) support?

11 models are supported: nanobanana-pro (default), nano-banana-2, nano-banana-2-fast, seedream-4.5, seedream-4.5-seq, seedream-5.0-lite, seedream-5.0-lite-seq, gpt-image-1.5, gpt-image-2, grok-2-image, grok-imagine-image. Both text-to-image and image editing modes are available.

06Is there async job tracking?

Yes. All generation jobs run asynchronously. You can poll for job status or configure a webhook to automatically receive a callback notification when a job completes, making it easy to integrate into automated workflows.

07Does Ad Clone have a video clip length limit?

Yes. Ad Clone is a two-step workflow: first analyze a reference video clip (max 12 seconds) to extract its style and structure, then generate ad variations based on the analysis result. Parallel generation of multiple versions is supported, making it easy to produce diverse creative content quickly.

08How do I set up webhook callbacks?

Configure your webhook endpoint in the AdsTurbo dashboard. When making API requests, include a custom identifier so that when a generation job completes, the system automatically pushes the result to your webhook URL along with that identifier, allowing you to correlate it with the specific job.

09What does the Video Generation API support?

The Video Generation module provides 8 capabilities: shot analysis, lip sync, watermark removal, video translation with dubbing, video super-resolution, face swap, motion control, and subtitle generation. Suitable for content localization, creative adaptation, and video post-production workflows.

10How does pricing work?

Pricing is based on API usage. Contact the AdsTurbo team or visit the main site to get an API key and discuss scale tiers.

11How do I get started?

Get an API key from adsturbo.ai, read the API documentation at doc.adsturbo.ai, and make your first call to POST /img/create — just pass a prompt and you'll get a generated image back. It's the simplest endpoint to start with (no required setup beyond the API key).

12Is there an MCP server for AI assistants?

Yes. The AdsTurbo MCP server gives ChatGPT, Claude, Cursor, WorkBuddy and other MCP clients the same capabilities as this API. Sign in with OAuth or use your API key. Setup guide: adsturbo.ai/mcp

Email us at support@adsturbo.ai with any questions.

Start Building Today

Connect your ad production pipeline
to AdsTurbo API

Get your API key and scale when you're ready.

API Docs
✓REST + async-ready✓Bearer auth · JSON request/response✓Webhook callback support