# Kieai — MCP server on mcp.ai
> Connect your Kieai account and use 35 tools for artificial intelligence straight from your AI agent. Connect with your own API key. AI API platform providing video generation (Veo3, Kling, Runway, Luma), image generation (Flux, Nano Banana), music creation (Suno), and LLM capabilities with pay-as-you-go pricing.

By: mcp.ai · official
Page: https://mcp.ai/kieai

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_kieai?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/kieai/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/kieai/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/kieai/skill.md
Postman collection (v2.1): https://mcp.ai/kieai/postman.json

## Tools
- kieai_add_instrumental(tags: string, model?: string, title: string, upload_url: string, audio_weight?: number, callback_url: string, style_weight?: number, vocal_gender?: string, negative_tags: string, weirdness_constraint?: number) — Add AI-generated instrumental accompaniment to an existing vocal track. Use when you need to generate instrumental music to accompany a vocal recording, allowing customization of style, mood, and crea
- kieai_add_vocals(model?: string, style: string, title: string, prompt: string, upload_url: string, audio_weight?: number, callback_url: string, style_weight?: number, vocal_gender?: string, negative_tags: string, weirdness_constraint?: number) — Add AI-generated vocals to an existing instrumental music track. Use this action when you want to add singing or vocal tracks to accompany an existing instrumental audio file. The action submits a voc
- kieai_create_market_task(input: object, model: string, call_back_url?: string) — Create a task for unified model access through the Market API. Submit tasks to any supported AI model (Kling, Sora2, Hailuo, Wan, Google, Ideogram, ElevenLabs, etc.) through a single unified interface
- kieai_create_music_video(author?: string, task_id: string, audio_id: string, domain_name?: string, call_back_url: string) — Create a music video (MP4) combining generated music with visuals. Use this action when you need to generate an MP4 music video from previously generated music tracks. The action requires a task ID fr
- kieai_execute_gpt_codex(input: string|object[], model: string, tools?: object[], stream?: boolean, reasoning?: object, tool_choice?: string) — Access GPT Codex capabilities through the KIE.AI Market API. Use when you need to leverage advanced code understanding and generation abilities via the Codex model for tasks such as code completion, r
- kieai_extend_music(model: string, style?: string, title?: string, prompt?: string, audioId: string, personaId?: string, continueAt?: number, audioWeight?: number, callBackUrl: string, styleWeight?: number, vocalGender?: string, negativeTags?: string, defaultParamFlag: boolean, weirdnessConstraint?: number) — Extend an existing Suno music track with additional AI-generated content. Use this action when you need to extend or modify existing music by creating a continuation or variation based on the provided
- kieai_extend_veo_video(model?: string, seeds?: integer, prompt: string, taskId: string, watermark?: string, call_back_url?: string) — Extend an existing Veo3.1 video with additional AI-generated content. Continues a previously generated video by adding new frames that seamlessly follow the original video. Use this action when you ne
- kieai_generate_aleph_video(seed?: integer, prompt: string, uploadCn?: boolean, videoUrl?: string, waterMark?: string, aspectRatio?: string, callBackUrl?: string, referenceImage?: string) — Generate AI video using Runway Aleph model from text prompts. Creates high-quality video content based on detailed text descriptions, optionally with reference video or image inputs. Use when you need
- kieai_generate_cover(task_id: string, call_back_url: string) — Generate a personalized cover version of a song using AI. Use when you want to create AI-generated variations or custom covers of existing music tracks. Each music task can only generate one Cover. Co
- kieai_generate_flux_kontext_image(model?: string, prompt: string, watermark?: string, input_image?: string, aspect_ratio?: string, callback_url?: string, output_format?: string, safety_tolerance?: integer, enable_translation?: boolean) — Generate or edit images using the Flux Kontext model. Supports both text-to-image generation and image editing modes. Use when you need to create new images from text descriptions or edit existing ima
- kieai_generate_gpt4o_image(size: string, prompt: string, mask_url?: string, files_url?: string[], is_enhance?: boolean, n_variants?: integer, callback_url?: string, fallback_model?: string, enable_fallback?: boolean) — Generate images using the GPT-4o image generation model. Creates AI-generated images from text prompts. Use when you need to create new images from text descriptions. The API returns a task ID that sh
- kieai_generate_lyrics(prompt: string, call_back_url: string) — Generate creative lyrics using AI. Creates new song lyrics based on the provided prompt, style, and other parameters. Use when you want to create AI-generated song lyrics for a music track or need cre
- kieai_generate_midi(taskId: string, audioId?: string, callBackUrl: string) — Generate MIDI file from audio or music generation. Converts audio tracks to MIDI format for use in digital audio workstations. Use when you need to convert separated audio stems (from vocal/instrument
- kieai_generate_music_style(content: string) — Boost or enhance music style parameters for improved music generation. Use when you need to generate or enhance music style descriptions to influence AI music generation. The content field should cont
- kieai_generate_sounds(model?: string, prompt: string, sound_key?: string, sound_loop?: boolean, grab_lyrics?: boolean, sound_tempo?: integer, call_back_url?: string) — Generate sound effects or audio clips based on a text description. Creates AI-generated audio sounds with configurable parameters like tempo, key, and looping. Use this action when you need to generat
- kieai_generate_timestamped_lyrics(task_id: string, audio_id: string) — Retrieve synchronized lyrics with timestamps for a music track. Gets lyrics with time markers for karaoke-style synchronization. Use this action when you need to display synchronized lyrics for a gene
- kieai_generate_veo_video(model?: string, seeds?: integer, prompt: string, imageUrls?: string[], watermark?: string, aspect_ratio?: string, call_back_url?: string, generation_type?: string, enable_translation?: boolean) — Generate AI video using Google Veo3.1 model from text prompts or images. Creates high-quality video content based on detailed text descriptions or by animating provided images. Use when you need to ge
- kieai_get_account_credits() — Retrieve the current credit balance for your KIE.AI account. Use when you need to check available credits before making API requests or monitor account usage. This action is read-only and does not mod
- kieai_get_aleph_video_details(taskId: string) — Retrieves details and status of an Aleph video generation task. Returns task information including current status (generating, success, or failed) and video URLs when complete. Use this action when ch
- kieai_get_cover_details(task_id: string) — Get the status and details of a cover song generation task. Use when you need to check the progress of a cover generation task or retrieve the generated cover image URLs after completion. The response
- kieai_get_flux_kontext_image_details(task_id: string) — Retrieve the status and details of a Flux Kontext image generation task. Use this action when you need to check the progress of an image generation task, get the generated image URL upon completion, o
- kieai_get_gpt4o_image_details(taskId: string) — Retrieves details and status of a GPT-4o image generation task. Returns task information including current status (generating, success, or failed) and image URLs when complete. Use when checking the p
- kieai_get_lyrics_details(taskId: string) — Retrieves the status and details of a lyrics generation task. Returns the generated lyrics text when the task is complete. Use this action to poll for lyrics generation results after submitting a lyri
- kieai_get_market_task_details(taskId: string) — Retrieves the status and details of a Market API task by its task ID. Use when you need to check the progress or outcome of a previously submitted task, such as after creating a task with a Market API
- kieai_get_midi_details(taskId: string) — Retrieves details and status of a MIDI generation task. Returns MIDI data including detected instruments, notes, timing, and velocity when the task is complete. Use when checking the progress of a MID
- kieai_get_music_details(taskId: string) — Get the status and details of a Suno music generation task including generated audio URLs and metadata. Use this action when you need to check the completion status of a music generation task, retriev
- kieai_get_music_video_details(task_id: string) — Retrieves details and status of a music video generation task. Returns task information including current status (PENDING, SUCCESS, or failed) and video URL when complete. Use when checking the progre
- kieai_get_runway_video_details(taskId: string) — Retrieves details and status of a Runway video generation task. Returns comprehensive task information including the current state (wait, queueing, generating, success, or fail) and video URLs when th
- kieai_get_timestamped_lyrics_status(task_id: string, audio_id: string) — Retrieve the status and results of a timestamped lyrics generation task. Use this action when you need to check the completion status of a previously initiated timestamped lyrics generation request, o
- kieai_get_veo_video_details(taskId: string) — Retrieves details and status of a Veo3.1 video generation task. Returns task information including current status (generating, success, or failed) and video URLs when complete. Use when checking the p
- kieai_get_veo1080p_video(index?: integer, taskId: string) — Retrieve the 1080p high-definition version of a completed Veo3.1 video generation. Use when you need to download the HD version of a video after the initial generation is complete. The 1080p conversio
- kieai_get_veo4k_video(index?: integer, taskId: string) — Retrieve the 4K ultra-high-definition version of a completed Veo3.1 video generation. Use when you need to download the 4K version of a video after the original generation is complete. The 4K conversi
- kieai_get_wav_details(task_id: string) — Retrieves the status and download URL for a WAV conversion task. Returns task information including current status (PENDING, SUCCESS, or failed) and the WAV audio URL when complete. Use when checking 
- kieai_replace_music_section(tags: string, title: string, prompt: string, taskId: string, audioId: string, fullLyrics?: string, infillEndS: number, callBackUrl?: string, infillStartS: number, negativeTags?: string) — Replace a specific section of a Suno music track with new AI-generated content. Use this action when you need to modify a portion of an existing music track by replacing it with newly generated conten
- kieai_separate_vocals(type?: string, task_id: string, audio_id: string, call_back_url: string) — Separates vocals and instruments from an audio track using AI-powered audio source separation. Use this action when you need to extract vocals from an instrumental track, create karaoke versions of so

## Example prompts
- "What can I do in Kieai?"
- "Show me a summary of my Kieai account"

## Links
Docs: https://mcp.ai/docs/mcps/kieai
Website: https://mcp.ai/mcps/kieai