For the complete documentation index, see llms.txt. This page is also available as Markdown.

KreadoAI MCP & Skills Documentation

1. Quick Start

Welcome to the KreadoAI MCP & Skills Documentation! 🙌

This guide will help you quickly integrate KreadoAI's MCP services and Skills capabilities. It covers authentication, MCP architecture, API tools, usage examples, and best practices for building AI-powered workflows.

Whether you're generating marketing assets, creating digital human videos, or building AI agents, this documentation provides everything you need to get started.

👉 Submit your integration requirements here, and our team will contact you within 24 business hours: https://tally.so/r/mJOoeK

1.1 Create an Account

Create a KreadoAI account and upgrade to a Professional Plan.

With KreadoAI's powerful AI capabilities, you can create:

  • Digital human videos

  • AI-generated marketing assets

  • AI voiceovers

  • AI image and video content

  • Automated content production workflows

1.2 Obtain Your API Key

After logging into your KreadoAI account, navigate to:

Account Overview → API Settings

to generate and manage your API credentials.

1.3 Important Notes

  • Temporary request failures may occur during service upgrades or maintenance periods. We recommend implementing a retry mechanism.

  • Please control request concurrency appropriately. If rate limits are triggered, avoid continuous retries, as this may prolong the cooldown period.

2. MCP Endpoint

To access KreadoAI MCP services, all requests must be authenticated using HTTP headers.

MCP Configuration Example

Supported MCP Clients

KreadoAI MCP can be integrated with:

  • Cursor

  • Claude

  • Custom AI Agens

  • Any MCP-compatible client

3. AI Image Generation

Use Cases

Generate:

  • Advertising creatives

  • Marketing posters

  • Product images

  • Brand visuals

  • E-commerce product listings

  • Social media assets

Supports:

  • Text-to-Image (T2I)

  • Image-to-Image (I2I)

Reference images can be provided using:

  • Image URL

  • Base64-encoded image

Supported models:

  • GPT Image

  • Gemini

  • Doubao Seedream

MCP Tools

3.1 get_my_user_detail

Retrieves detailed information for the currently authenticated user.

Returns:

  • Account information

  • Email address

  • Phone number

  • Membership level

  • Remaining K Coins

  • Available quotas

  • Registration source

Notes:

  • Authentication is based on the current session context.

  • userId cannot be provided manually.

  • Accessing other users' information is not supported.

3.2 submit_ai_image_task

Creates an AI image generation task and returns a task ID.

Supported features:

  • Text-to-Image generation

  • Image-to-Image generation

  • URL reference images

  • Base64 reference images

3.3 get_ai_image_task_detail

Retrieves task execution results.

Returns:

Status
Description

1

Pending

2

Processing

3

Completed

4

Failed

Additional fields:

  • Generated image URL

  • Prompt

  • Model provider

3.4 resubmit_ai_image_task

Recreates an image generation task using the original task parameters.

Returns a new task ID.

Only tasks owned by the current user may be regenerated.

4. Multi-Size Ad Creative Generation

Use Cases

Upload a product image and generate multiple advertising creative sizes in a single task.

Supported platforms:

  • Facebook

  • Google

  • TikTok

  • Douyin

  • Xiaohongshu

  • Kuaishou

Layout modes:

  • Original Layout

  • AI Smart Layout

  • Custom Layout

MCP Tools

4.1 submit_ai_ad_creative_batch_image

Creates multiple advertising creatives from a single product image.

Returns:

  • Task ID

4.2 get_ai_ad_creative_batch_image_detail

Retrieves generation results.

Returns:

Status
Description

1

Pending

2

Processing

3

Completed

4

Failed

Includes:

  • Generated file URLs

  • Thumbnail URLs

  • Dimensions

  • Model provider

  • Child task list

5. Website Data Crawling (For AI Ad Generation)

Use Cases

Crawl and analyze:

  • Brand websites

  • Landing pages

  • E-commerce product pages

AI extracts structured product and brand information for downstream AI content generation.

Processing time:

Typically 1–5 minutes

Important Notes

  • Recommended polling interval: 10–15 seconds

  • Maximum waiting time: 15 minutes

  • Result TTL: 24 hours

  • During polling, set:

After task completion:

Business source:

Value
Description

1

AI Marketing Video (Default)

2

AI Advertising Image

MCP Tools

5.1 submit_crawl_task

Submits a webpage crawling task.

Parameters

Parameter
Required
Description

query

Yes

Target webpage URL

source

No

Business source

sessionId

No

Session identifier

Returns:

5.2 get_crawl_task_status

Retrieves task status and crawling results.

Parameters

Parameter
Required

threadId

Yes

includeContent

No

Status

Value
Description

RUNNING

Processing

SUCCESS

Completed

FAILED

Failed

NOT_FOUND

Not Found / Expired

Response Fields

  • threadId

  • sessionId

  • status

  • currentNode

  • crawlId

  • url

  • source

  • errorMsg

  • content

Content Fields

  • title

  • productName

  • brandName

  • price

  • currency

  • productDescription

  • productFeatures

  • targetAudience

  • useScenario

  • imageUrls

  • videoUrls

  • logoUrl

  • language

  • location

  • productLllmResult

  • metaDescription

  • content

6. AI Advertising Image Generation

Use Cases

Generate marketing images directly from:

  • Product URLs

  • Product content

Supported modes:

Mode
Description

generationMode=1

AI Creative Generation

generationMode=2

Template-Based Generation

Customizable:

  • Prompt

  • Aspect ratio

  • Resolution

  • Logo

  • Brand color

MCP Tools

6.1 submit_url2image_task

Creates AI advertising image generation tasks.

Returns:

6.2 get_ai_ad_creative_batch_image_detail

Retrieves task execution results and generated image URLs.

7. Text-to-Speech (TTS)

Use Cases

Convert text into MP3 audio for:

  • Digital human videos

  • Advertising assets

  • Marketing campaigns

Recommended workflow:

Important Notes

  • Maximum 1 request per second

  • Valid apiToken required

  • voiceSource is required when voiceClone=0

MCP Tools

7.1 get_voice_language_list

Returns supported languages.

Response:

7.2 get_voice_list

Returns voice models matching specified filters.

Supported providers:

Value
Provider

1

Microsoft

3

Alibaba

4

ByteDance

5

MiniMax

6

Google

21

ElevenLabs

Response:

7.3 text_to_speech

Converts text into MP3 audio.

Returns:

  • taskId

  • audioUrl

  • fileId

  • duration

  • paymentMoney

Response:


8. Digital Human Video

Use Cases

Generate lip-synced marketing videos using:

  • Real-person avatars

  • Photo avatars

  • Cloned digital humans

Recommended workflow:

MCP Tools

8.1 get_digital_human_avatar_list

Returns available digital human avatars.

Response:

8.2 submit_system_lip_task

Creates a lip-sync generation task.

Returns:

Contains:

8.3 get_lip_video_result

Retrieves lip-sync generation results.

Status:

Value
Description

1

Pending

2

Processing

3

Completed

4

Failed

5

Timeout

Response:

9. AI Video Generation (Image-to-Video / Text-to-Video)

Use Cases

Generate marketing videos using:

  • Text prompts

  • Images

  • Multi-image references

  • Multimodal references

  • Video continuation

Supported model families:

  • Doubao

  • Veo

  • Sora

  • Vidu

  • Kling

  • Happy Horse

  • Wan

  • MiniMax

Workflow

MCP Tools

9.1 submit_image_to_video_task

Creates image-to-video or text-to-video generation tasks.

Returns:

Includes:

  • taskId

  • taskIds

Supported Reference Modes

  • none

  • first-last

  • reference

  • multimodal-reference

  • video-continuation

Supported Media Types

  • image

  • video

  • audio

9.2 batch_get_image_to_video_detail

Retrieves generation results.

Status:

Value
Description

1

Pending / Processing

2

Success

3

Failed

4

Failed

Response:

10. Subtitle & Watermark Removal

Use Cases

Remove:

  • Video subtitles

  • Watermarks

Required inputs:

  • Source video URL

  • Subtitle coordinates

  • Watermark coordinates

MCP Tools

10.1 submit_subtitle_removal_task

Creates a subtitle or watermark removal task.

Returns:

10.2 get_subtitle_removal_result

Retrieves task results.

Status:

Value
Description

1

Pending

2

Processing

3

Completed

4

Failed

5

Timeout

Returns:

Contact Us

Need technical support or want to learn more about KreadoAI MCP?

📧 Email: support@kreadoai.com

🌐 Website: www.kreadoai.com

Our team is always available to assist with your integration and deployment needs.

Last updated