- Category: artificial intelligence
- Auth: API_KEY
- Composio-managed OAuth available? N/A
- Tools: 38
- Triggers: 0
- Slug:
KIEAI - Version: 20261101_00
Tools
Add Instrumental to Vocal Track
Add Instrumental to Vocal Track
KIEAI_ADD_INSTRUMENTALAdd 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 creative parameters. The task completion will be notified via the callback URL.Input Parameters
Output
Add vocals to instrumental
Add vocals to instrumental
KIEAI_ADD_VOCALSAdd 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 vocal generation task and returns a task ID that can be used to track the generation status. This action is asynchronous - use the returned taskId to poll for completion via the callback URL or check task status separately.Input Parameters
Output
Create Chat Completion
Create Chat Completion
KIEAI_CREATE_CHAT_COMPLETIONGenerate a synchronous GPT 5.2 response from text or image messages. Use this chat-only action for multimodal conversations, optional web search grounding, and configurable reasoning effort. It consumes Kie.ai credits.Input Parameters
Output
Create Market Task
Create Market Task
KIEAI_CREATE_MARKET_TASKSubmit a Market API task with a model identifier and speech-oriented input requiring text and voice, plus optional voice settings and callback. The action returns task identification fields for tracking.Input Parameters
Output
Create music video from generated audio
Create music video from generated audio
KIEAI_CREATE_MUSIC_VIDEOCreate 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 from the music generation process and an audio ID for the specific track. The video generation is async - results are delivered to the specified callback URL. Once the video is ready, the callback URL receives a POST request with: - code: 0 for success, 500 for error - data.task_id: The unique task identifier - data.video_url: The video URL (valid for 14 days)Input Parameters
Output
Execute GPT Codex
Execute GPT Codex
KIEAI_EXECUTE_GPT_CODEXSubmit a GPT Codex query through the KIE.AI Market API for programming assistance, such as code completion, refactoring, or explaining bugs. Use a single prompt or a multi-turn conversation, with optional reasoning settings and web search or function tool declarations. Web search and function tools cannot be used together in the same request.Input Parameters
Output
Extend Suno Music
Extend Suno Music
KIEAI_EXTEND_MUSICExtend 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 audio ID and parameters. The action submits a generation request and returns a task ID that can be used to track the progress via callback. Note: When defaultParamFlag is false, provide custom parameters (prompt, styleWeight, etc.) to control the extension behavior. When defaultParamFlag is true, provide continueAt, style, and title instead.Input Parameters
Output
Extend Veo Video
Extend Veo Video
KIEAI_EXTEND_VEO_VIDEOExtend 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 need to extend a video generated through the Veo3.1 API with additional content. After submission, poll ‘Get Veo Video Details’ using the returned taskId to check extension status until completion. Note: Video extension is asynchronous. You will receive a taskId in the response that must be used to poll for completion status. Only videos generated through the Veo3.1 API can be extended, and videos generated after 1080P cannot be extended.Input Parameters
Output
Generate Aleph Video
Generate Aleph Video
KIEAI_GENERATE_ALEPH_VIDEOSubmit a Runway Aleph video-to-video transformation using a text prompt and reference video URL, optionally with a reference image. The asynchronous task returns an ID for status polling; generated videos are available for 14 days.Input Parameters
Output
Generate Music Cover
Generate Music Cover
KIEAI_GENERATE_COVERGenerate 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. Cover images are typically valid for 14 days. The action returns a task ID that can be used to track the generation progress. The callback URL will receive a POST request when cover generation completes, containing the task ID and generated image URLs.Input Parameters
Output
Generate Flux Kontext Image
Generate Flux Kontext Image
KIEAI_GENERATE_FLUX_KONTEXT_IMAGEGenerate 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 images with AI-powered transformations. The API returns a task ID that can be used to poll for completion status. Generated images expire after 14 days.Input Parameters
Output
Generate GPT-4o Image
Generate GPT-4o Image
KIEAI_GENERATE_GPT4O_IMAGEGenerate 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 should be polled using the ‘Get GPT-4o Image Details’ action to check completion status and retrieve the generated image URLs. Generated images are stored for 14 days and download URLs are valid for 20 minutes.Input Parameters
Output
Generate AI Lyrics
Generate AI Lyrics
KIEAI_GENERATE_LYRICSSubmit an AI song lyrics generation task from a prompt. A callback URL is required for completion notifications, and the response can contain a task ID for tracking progress.Input Parameters
Output
Generate MIDI
Generate MIDI
KIEAI_GENERATE_MIDIGenerate 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 separation) into MIDI files for further music production workflows. This action requires a valid taskId from a prior vocal separation operation and a callback URL to receive completion notifications. Prerequisites: Must first use the Vocal & Instrument Stem Separation API to separate audio before generating MIDI.Input Parameters
Output
Generate Music
Generate Music
KIEAI_GENERATE_MUSICSubmit a legacy Suno music-generation task, send status and results to the required callback URL, and return a task ID for polling. This action consumes Kie.ai credits.Input Parameters
Output
Generate Music Style
Generate Music Style
KIEAI_GENERATE_MUSIC_STYLEBoost 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 contain a concise description of the desired music style. Returns a task ID that can be used to track the generation progress and credits information for the request.Input Parameters
Output
Generate Sounds
Generate Sounds
KIEAI_GENERATE_SOUNDSGenerate 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 generate sound effects, short audio clips, or ambient sounds for projects. The action submits a generation request and returns a task ID that can be used to track progress via polling or callback. Supports BPM control (1-300), musical key selection (e.g., Cm, D#m, Any), looping option, and optional lyrics capture. The generated sounds are typically valid for 14 days.Input Parameters
Output
Get Timestamped Lyrics
Get Timestamped Lyrics
KIEAI_GENERATE_TIMESTAMPED_LYRICSRetrieve 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 generated music track or implement karaoke-style highlighting.Input Parameters
Output
Generate Veo Video
Generate Veo Video
KIEAI_GENERATE_VEO_VIDEOGenerate 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 generate a video from a text description (text-to-video) or animate one or more reference images (image-to-video). After submission, poll ‘Get Veo Video Details’ using the returned taskId to check generation status until completion. Note: Video generation is asynchronous. You will receive a taskId in the response that must be used to poll for completion status.Input Parameters
Output
Get Account Credits
Get Account Credits
Get Aleph Video Details
Get Aleph Video Details
KIEAI_GET_ALEPH_VIDEO_DETAILSRetrieves 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 checking the progress of a video generation task or retrieving the final video output after completion. This is a polling endpoint—call periodically until task completion. Note: Generated videos are only available for 14 days. The resultVideoUrl and resultImageUrl are only present when successFlag is 1 (success).Input Parameters
Output
Get Cover Details
Get Cover Details
KIEAI_GET_COVER_DETAILSGet 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 includes the task status (pending, generating, success, or failed), creation and completion timestamps, and the generated cover image URLs when the task is complete. Poll this endpoint to track task progress until successFlag indicates completion (1) or failure (3).Input Parameters
Output
Get Flux Kontext Image Details
Get Flux Kontext Image Details
KIEAI_GET_FLUX_KONTEXT_IMAGE_DETAILSRetrieve 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, or diagnose why a task failed. The task status (successFlag) indicates: - 0 (GENERATING): Task is still processing - 1 (SUCCESS): Task completed with image URL in response field - 2 (CREATE_TASK_FAILED): Task creation failed - 3 (GENERATE_FAILED): Task created but image generation failedInput Parameters
Output
Get GPT-4o Image Details
Get GPT-4o Image Details
KIEAI_GET_GPT4O_IMAGE_DETAILSRetrieves 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 progress of an image generation task or retrieving the final image output after completion. This is a polling endpoint—call periodically until task completion. Note: Image generation tasks return URLs that are available only for a limited time. Download images promptly after task completion.Input Parameters
Output
Get Lyrics Details
Get Lyrics Details
KIEAI_GET_LYRICS_DETAILSRetrieves 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 lyrics generation request. The task status can be: PENDING (waiting), SUCCESS (complete), or various error states. If the status is SUCCESS, check the response.data.response.data field for the generated lyrics.Input Parameters
Output
Get Market Task Details
Get Market Task Details
KIEAI_GET_MARKET_TASK_DETAILSRetrieves 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 action or when polling for completion. This action queries the unified Market API job status endpoint.Input Parameters
Output
Get MIDI Details
Get MIDI Details
KIEAI_GET_MIDI_DETAILSRetrieves 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 MIDI generation task or retrieving the final MIDI output after completion. This is a polling endpoint—call periodically until task completion. Note: MIDI records are retained for 14 days. When using vocal separation with type ‘split_stem’, the midiData field may be empty. Check errorCode and errorMessage fields when successFlag indicates failure.Input Parameters
Output
Get Music Details
Get Music Details
KIEAI_GET_MUSIC_DETAILSGet 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, retrieve audio URLs for download or playback, or monitor the progress of a previously submitted generation request. Poll this endpoint until status reaches SUCCESS or an error state. Note that instrumental tracks will not include lyrics data.Input Parameters
Output
Get Music Video Details
Get Music Video Details
KIEAI_GET_MUSIC_VIDEO_DETAILSRetrieves 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 progress of a music video generation task or retrieving the final video output after completion. This is a polling endpoint—call periodically until task completion. Note: Video records are only available within 14 days after generation.Input Parameters
Output
Get Runway Video Details
Get Runway Video Details
KIEAI_GET_RUNWAY_VIDEO_DETAILSRetrieves 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 the task is complete. Use this action when checking the progress of a Runway video generation task or retrieving the final video output after completion. This is a polling endpoint—call periodically until the task reaches a terminal state. Note: Video URLs returned in the response are valid for 14 days. For extension tasks, the parentTaskId field indicates the original generation task.Input Parameters
Output
Get Timestamped Lyrics Status
Get Timestamped Lyrics Status
KIEAI_GET_TIMESTAMPED_LYRICS_STATUSRetrieve timestamped lyrics for a specific audio track from a music generation task, including word-level timing for synchronization.Input Parameters
Output
Get Veo 1080p Video
Get Veo 1080p Video
KIEAI_GET_VEO1080P_VIDEORetrieve 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 conversion typically takes 1-3 minutes after the original generation completes. Note: Poll this endpoint every 20-30 seconds until the video is ready. If the task is still processing, the API will return an appropriate error. The original generation task must be successful before requesting the 1080p version.Input Parameters
Output
Get Veo 4K Video
Get Veo 4K Video
KIEAI_GET_VEO4K_VIDEORetrieve 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 conversion typically takes longer than the 1080p conversion (approximately 2-5 minutes) after the original generation completes. Use this action when you have a completed video generation task and want to access the premium 4K quality output. Poll this endpoint every 30-45 seconds until the video is ready. The original generation task must be successful before requesting the 4K version.Input Parameters
Output
Get Veo Video Details
Get Veo Video Details
KIEAI_GET_VEO_VIDEO_DETAILSRetrieves 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 progress of a video generation task or retrieving the final video output after completion. This is a polling endpoint—call periodically until task completion. Note: Videos generated with fallback model cannot be upgraded to 1080P. Records are only available within 14 days.Input Parameters
Output
Get WAV Details
Get WAV Details
KIEAI_GET_WAV_DETAILSRetrieves 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 the progress of a WAV conversion task or retrieving the final audio output after completion. This is a polling endpoint—call periodically until task completion. Note: WAV files are retained for 14 days. The audioWavUrl is only available when successFlag is SUCCESS.Input Parameters
Output
Register Omni Voice Preset
Register Omni Voice Preset
KIEAI_REGISTER_OMNI_VOICE_PRESETRegister a Gemini Omni preset voice and return its reusable audio ID.Input Parameters
Output
Replace Music Section
Replace Music Section
KIEAI_REPLACE_MUSIC_SECTIONReplace 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 content while preserving the rest of the track. The action submits a replacement request and returns a task ID that can be used to track progress via callback. Constraints: - The replacement duration (infillEndS - infillStartS) must be between 6 and 60 seconds. - The replacement cannot exceed 50% of the original music’s total duration. - This action is irreversible once submitted.Input Parameters
Output
Separate Vocals from Audio
Separate Vocals from Audio
KIEAI_SEPARATE_VOCALSSeparates 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 songs, isolate vocals for remixing, or generate instrumentals for sampling. The action supports two separation modes: ‘separate_vocal’ (2 stems - vocal and instrumental) and ‘split_stem’ (up to 12 stems). Results are delivered via callback URL, and audio URLs remain accessible for 14 days. Note: Re-submitting the same track deducts credits again with no caching.