Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
KIE_API_KEYYesYour kie.ai API key
KIE_MCP_PORTNoPort for HTTP mode (default: 3100)
KIE_CALLBACK_URLNoCallback URL sent with Suno generation requests (kie.ai requires the field; results are fetched by polling regardless). Defaults to an inert placeholder — set this only if you want to receive the callbacks yourself
KIE_PROJECT_ROOTNoServer-wide default for where generated files are saved (default: server cwd; files go to $KIE_PROJECT_ROOT/kie/assets/raw/). Per-call download_dir (absolute path) on any file-writing tool overrides this
KIE_MAX_CONCURRENTNoMax simultaneous task-creation calls (default 4). Excess parallel generations queue inside the server instead of hitting kie.ai's rate limits — parallel tool calls are safe
KIE_POLL_BUDGET_AUDIONoBlocking-mode polling budget for audio tools, in seconds (default: 300)
KIE_POLL_BUDGET_IMAGENoBlocking-mode polling budget for image tools, in seconds (default: 600)
KIE_POLL_BUDGET_VIDEONoBlocking-mode polling budget for video tools, in seconds (default: 900)
KIE_POLL_BUDGET_SPEECHNoBlocking-mode polling budget for speech tools, in seconds (default: 300)

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
generate_imageA

Generate an image using kie.ai (47+ models). Downloads to kie/assets/raw/. MODEL GUIDE: Architecture/blueprints→gpt4o or nano-banana-2 (reasoning). Game art/3D→seedream/4.5 or 5-lite. Character sheets→ideogram/character. Text/logos→ideogram/v3 (best text). Photo editing→flux-kontext-pro. Anime→qwen (3cr cheapest). Fast drafts→nano-banana-2-lite (4cr, ~4s, NEW). Upscale→recraft/crisp-upscale (2cr). BG removal→recraft/remove-background. Cheapest→z-image,qwen (3cr). Best quality→nano-banana-pro (24cr), flux-kontext-max (100cr). Use list_models filter="use-case" to explore.

list_modelsA

List all available kie.ai models with their aspect ratios and model-specific options

check_taskA

Check the status of a kie.ai generation task by taskId

list_tasksB

List recent image generation tasks from this session

check_creditsB

Check remaining kie.ai account credits

download_resultC

Download a completed task result to kie/assets/raw/

list_raw_assetsA

List all files in kie/assets/raw/ waiting to be processed

generate_videoA

Generate a video using kie.ai (86+ models). Downloads to kie/assets/raw/. MODEL GUIDE: Best cinematic→veo-3/text-to-video (50cr/s, audio). Fast+cheap→grok-imagine-video-1-5-preview (1.6-3cr/s, audio, NEW), wan/flash-image-to-video (2cr/s). Budget cinematic→hailuo-standard (4cr/s). Budget multimodal refs→bytedance/seedance-2-mini (9.5cr/s @480p). 30s single takes→bytedance/seedance-2-5 (NEW). Budget all-rounder w/ audio+templates+extend→pixverse-v6 family (4-9.6cr/s, NEW; I2V is its strength; transition=first/last-frame morph). Multilingual lip-synced dialogue→happyhorse-1-1 T2V/I2V/R2V (NEW). Fast Kling→kling/v3-turbo (18cr/s, audio, NEW). Image-to-video→veo-3/image-to-video, kling/image-to-video. Avatar/talking head→omnihuman-1-5 (premium, NEW), kling/ai-avatar-pro, infinitalk/from-audio. Re-dub existing footage→volcengine/video-to-video-lip-sync (8cr/s, NEW). Motion control→kling/motion-control, wan/animate-move. Extend video→use veo_extend or runway_extend tools. NOTE: Sora 2 family is paused upstream by kie.ai (June 2026) — not usable. Use list_models filter="use-case" to explore.

generate_musicA

Generate music using Suno via kie.ai. Supports V5.5 (custom style), V5 (best quality), V4.5+, V4.5, V4. Up to 8 minutes. Great for game music stems, ambient tracks, and jingles. Polls until done and downloads to kie/assets/raw/.

generate_sfxA

Generate a sound effect from text via Suno V5 (kie.ai removed the ElevenLabs sound-effect model). Great for game sounds: UI clicks, magic spells, item pickups, explosions. For loop/BPM/key control use generate_sounds instead. Downloads to kie/assets/raw/.

generate_gemini_ttsA

NEW — Google Gemini native TTS via kie.ai: style-directed speech from natural-language direction, 30 named voices, up to 2 speakers, inline tone tags like [whispers]/[laughs] (flash model). ~4.2 credits per MINUTE of audio — cheaper than all ElevenLabs tiers. Simple mode: pass text (+ optional voice_name). Dialogue mode: pass speakers + dialogue_turns. model=flash is most expressive (keep expected audio <60s — quality degrades on long takes); model=pro is more stable for multi-minute narration. Downloads to kie/assets/raw/.

generate_ttsA

Generate speech from text using ElevenLabs via kie.ai. Supports Turbo 2.5 (fast) and Multilingual V2 (high quality). Downloads to kie/assets/raw/.

generate_dialogueA

Generate multi-speaker dialogue using ElevenLabs Text-to-Dialogue V3 via kie.ai. Great for conversations between characters. Downloads to kie/assets/raw/.

audio_isolationB

Isolate vocals or audio from background noise using ElevenLabs via kie.ai. Input an audio URL, get clean isolated audio back.

extend_musicA

Extend/continue an existing Suno track from a specific point. Requires audioId from a previous generate_music task.

cover_audioB

Create an AI cover from uploaded audio — custom vocals, style, and instrumentation via Suno.

add_instrumentalB

Add instrumental backing to uploaded vocal audio via Suno.

add_vocalsC

Add AI vocals to uploaded instrumental audio via Suno.

replace_sectionC

Replace a time range in a Suno track with new AI-generated content.

generate_lyricsB

Generate song lyrics from a prompt using Suno AI (max 200 characters). Returns text, no file download.

convert_to_wavC

Convert a Suno track to lossless WAV format. Downloads to kie/assets/raw/.

separate_vocalsB

Separate vocals from instrumentals, or split into individual stems. Downloads to kie/assets/raw/.

generate_midiA

Export a Suno track to MIDI notation. Downloads .mid file to kie/assets/raw/.

create_music_videoB

Generate an MP4 music video visualization from a Suno track. Downloads to kie/assets/raw/.

generate_soundsC

Generate loopable sound effects with BPM, key, and loop control via Suno. Downloads to kie/assets/raw/.

generate_personaA

NEW — Create a Suno Persona (reusable music character) from an existing Suno track. Requires taskId from V3.6+ generation.

generate_mashupB

NEW — Mashup up to 2 Suno tracks into one new track. Provide audioIds from previous generations.

boost_styleA

NEW — Convert concise style input (e.g. "Pop, Mysterious") into enhanced style description for music generation.

prepare_voice_cloneA

EXPERIMENTAL (#20) — STEP 1 of Suno custom-voice cloning (FREE). Submit a clean vocal sample; polls to wait_validating, after which kie sends a verification phrase to your KIE_CALLBACK_URL for the voice owner to read aloud (then use create_voice_clone). ⚠️ Only clone a voice you OWN or have explicit permission to use. The completion step is not verified end-to-end and needs a real callback URL.

create_voice_cloneA

EXPERIMENTAL (#20) — STEP 2 — after the voice owner records the verification phrase from prepare_voice_clone, submit that recording to finish the voice. On success returns a voiceId usable in generate_music. Unverified end-to-end.

regenerate_voice_cloneB

EXPERIMENTAL (#20) — retry a failed/incomplete custom-voice task by its task_id.

get_timestamped_lyricsA

NEW — Get word-level timestamped lyrics from a Suno track. Useful for karaoke, captioning, or sync.

generate_cover_artA

NEW — Generate album cover art image for an existing Suno music track. One call per taskId only.

create_omni_voiceB

NEW — Create a reusable voice character for Gemini Omni video generation. Returns kieAudioId for use in generate_video audio_ids.

create_omni_characterB

NEW — Create a reusable visual character for Gemini Omni video generation. Combines image + optional voice. Returns characterId.

upload_extend_audioA

NEW — Extend uploaded audio (NOT a Suno track) with new AI-generated content. For Suno tracks, use extend_music instead.

speech_to_textA

Transcribe audio to text using ElevenLabs Scribe v1. Supports diarization and audio event tagging. Returns transcription text.

upload_fileA

Upload a file to kie.ai and get a public URL back. Use this to upload local images/audio/video before passing them to generation tools. Supports URL upload, base64 upload. Files expire after 3 days.

veo_extendC

Extend an existing Veo 3.1 video with additional content. Requires taskId from a previous Veo generation.

veo_upscale_1080pA

Upscale a Veo 3.1 video to 1080p resolution. Requires taskId from a completed Veo generation.

veo_upscale_4kA

Upscale a Veo 3.1 video to 4K resolution. Takes 5-10 minutes. Requires taskId from completed Veo generation.

runway_extendB

Extend an existing Runway Aleph video with continuation content.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/elibarnett/kie-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server