docs.emix.ai
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
Market
File Upload API
Market
File Upload API
  1. Lyrics Generation
  • Getting Started with Emix API (Important)
  • Market
  • Image Models
    • Topaz
      • Topaz - Image Upscale
    • Seedream
      • Seedream3.0 - Text to Image
      • Seedream4.0 - Text to Image
      • Seedream4.0 - Edit
      • Seedream4.5 - Text to Image
      • Seedream4.5 - Edit
      • Seedream5.0 Lite - Text to Image
      • Seedream5.0 Lite - Image to Image
      • Seedream5.0 Pro - Text to Image
      • Seedream5.0 Pro - Image to Image
      • Seedream 5.0 Pro - Layer Decomposition
    • Z-image
      • Z-Image
    • Google
      • Google - imagen4-fast
      • Google - imagen4-ultra
      • Google - imagen4
      • Google - Nano Banana
      • Google - Nano Banana Pro
      • Google - Nano Banana 2
      • Google - Nano Banana 2 Lite
    • Flux-2
      • Flux-2 - Pro Image to Image
      • Flux-2 - Pro Text to Image
      • Flux-2 - Image to Image
      • Flux-2 - Text to Image
    • Grok Imagine
      • Grok Imagine - Text to Image
      • Grok Imagine - image to image
      • Grok Imagine Image 2.0 Text To Image
      • Grok Imagine Image 2.0 Segment Map
      • Grok Imagine Image 2.0 Image Edit
    • GPT Image
      • GPT Image 2.5 Sunburst Text to Image
      • GPT Image 2.5 Sunburst Image to Image
      • GPT Image 2.5 Flare Text to Image
      • GPT Image 2.5 Flare Image to Image
      • GPT Image-1.5 - Text to Image
      • GPT Image-1.5 - Image to Image
      • GPT Image-2 - Text to Image
      • GPT Image 2 - Image To Image
    • Recraft
      • Recraft - Remove Background
      • Recraft - Crisp Upscale
    • Ideogram
      • Ideogram - V3 Reframe
      • Ideogram - Character Edit
      • Ideogram - Character Remix
      • Ideogram - Character
      • Ideogram V3 Text to Image
      • Ideogram V3 Edit
      • Ideogram V3 Remix
    • 4o Image API
      • 4o Image API Quickstart
      • 4o Image Generation Callbacks
      • Generate 4o Image
      • Get 4o Image Details
      • Get Direct Download URL
    • Flux Kontext API
      • Flux Kontext API Quickstart
      • Image Generation or Editing Callbacks
      • Generate or Edit Image
      • Get Image Details
    • Qwen
      • Qwen - Text to Image
      • Qwen - Image to Image
      • Qwen - Image Edit
      • Qwen2 - Image Edit
      • Qwen2 - Text To Image
      • Qwen3 Pro Text to Image
      • Qwen3 Text to Image
      • Qwen3 Pro Image to Image
      • Qwen3 Image to Image
      • Qwen 2.1 - Text to Image
      • Qwen 2.1 - Image to Image
    • Wan
      • Wan 2.7 Image
      • Wan 2.7 Image Pro
  • Video Models
    • OmniHuman
      • Omnihuman 1.5
      • Omnihuman 1.5 Human Identification
      • OmniHuman 1.5 Subject Detection
    • Hailuo
      • Hailuo 2.3 Pro Image to Video
      • Hailuo 2.3 Standard Image to Video
      • Hailuo Pro Text to Video
      • Hailuo Pro Image to Video
      • Hailuo Standard Text to Video
      • Hailuo Standard Image to Video
    • Topaz
      • Topaz - Video Upscale
    • Runway API
      • Runway Image To Video
      • Runway Text To Video
      • Runway Video Extension
    • HappyHorse
      • HappyHorse - text-to-video
      • HappyHorse - image-to-video
      • HappyHorse - reference-to-video
      • HappyHorse - video-edit
      • HappyHorse-1-1 image-to-video
      • HappyHorse-1-1 text-to-video
      • HappyHorse-1-1 reference-to-video
    • Wan
      • Wan - 2.2 A14B Image to Video Turbo
      • Wan - 2.2 A14B Speech to Video Turbo
      • Wan - 2.2 A14B Text to Video Turbo
      • Wan - Animate Move
      • Wan - Animate Replace
      • Wan 2.6 - Image to Video
      • Wan 2.6 - Text to Video
      • Wan 2.6 - Video to Video
      • Wan 2.5 - Image to Video
      • Wan 2.5 - Text to Video
      • Wan 2.7 - Text to Video
      • Wan 2.7 - Image to Video
      • Wan 2.7 - Video Edit
      • Wan 2.7 - Reference to Video
      • Wan 3.0 - Video
      • Wan 3.0 - Video Prime
    • Grok Imagine
      • Grok Imagine Text to Video
      • Grok Imagine Image to Video
      • Grok Imagine - Video Upscale
      • Grok Imagine - Video Extend
      • Grok Imagine Video 1.5 Preview
    • Kling
      • Kling 2.6 Text to Video
      • Kling 2.6 Image to Video
      • Kling - V2.5 Turbo Image to Video Pro
      • Kling - V2.5 Turbo Text to Video Pro
      • Kling AI Avatar Standard
      • Kling AI Avatar Pro
      • Kling V2.1 Master Image to Video
      • Kling V2.1 Master Text to Video
      • Kling V2.1 Pro
      • Kling V2.1 Standard
      • Kling 2.6 motion-control
      • Kling-3.0 motion-control
      • Kling 3.0
      • Kling - V3 Turbo Text to Video
      • Kling - V3 Turbo Image to Video
      • Kling 3.0 Omni Reference To Video
      • Kling 3.0 Omni Transformation
      • Kling 3.0 Omni Image To Video
      • Kling 3.0 Omni Text to Video
    • Bytedance
      • Bytedance Seedance 2.0
      • Bytedance Seedance 2.0 Fast
      • Bytedance Seedance 2.0 Mini
      • Bytedance Seedance 1.5 Pro
      • Bytedance V1 Pro Fast Image to Video
      • Bytedance V1 Pro Image to Video
      • Bytedance - V1 Pro Text to Video
      • Bytedance - V1 Lite Image to Video
      • Bytedance - V1 Lite Text to Video
      • Bytedance Seedance 2.5
    • Veo3.1 API
      • Get 4K Video Callbacks
      • Veo3.1 API Quickstart
      • Veo3.1 Video Generation Callbacks
      • Generate Veo3.1 Video
      • Get Veo3.1 Video Details
      • Get 1080P Video
      • Get 4K Video
      • VEO 3.1 Extend Video
      • VEO 3.1 Text to video
      • VEO 3.1 Image to video
      • VEO 3.1 Reference to vidoe
    • Gemini Omni
      • Gemini Omni 1.1 Flash
      • Gemini Omni Video
      • Gemini Omni Audio
      • Gemini Omni Character
    • Volcengine
      • Volcengine video to video lip sync
    • PixVerse
      • PixVerse V6 Text-to-Video
      • PixVerse V6 Image-to-Video
      • PixVerse V6 First & Last Frame Transition
      • PixVerse V6 Video Extension
      • PixVerse V6 Fusion / Reference-to-Video
    • MiniMax H3
      • MiniMax H3 Text-to-Video
      • MiniMax H3 Image-to-Video
      • MiniMax H3 Reference-to-Video
  • Music Models
    • ElevenLabs
      • elevenlabs/audio-isolation
      • elevenlabs/sound-effect-v2
      • elevenlabs/speech-to-text
      • elevenlabs/text-to-dialogue-v3
      • elevenlabs/text-to-speech-multilingual-v2
      • elevenlabs/text-to-speech-turbo-2-5
    • Suno API
      • Music Generation
        • Music Generation Callbacks
        • Music Extension Callbacks
        • Add Instrumental Callbacks
        • Add Vocals Callbacks
        • Music Cover Generation Callbacks
        • Replace Music Section Callbacks
        • Audio Upload and Extension Callbacks
        • Audio Upload and Cover Callbacks
        • Generate Music
        • Extend Music
        • Upload And Cover Audio
        • Upload And Extend Audio
        • Add Instrumental to Music
        • Add Vocals to Music
        • Get Timestamped Lyrics
        • Boost Music Style
        • Generate Music Cover
        • Replace Music Section
        • Generate Persona
        • Generate Mashup Music
      • Lyrics Generation
        • Lyrics Generation Callbacks
        • Generate Lyrics
          POST
      • WAV Conversion
        • Convert to WAV Format
      • Vocal Removal
        • Audio Separation Callbacks
        • Vocal & Instrument Stem Separation
        • Generate MIDI from Audio
      • Music Video Generation
        • Music Video Generation Callbacks
        • Create Music Video
      • Sounds Generation
        • Generate sounds
      • voice
        • Suno Voice Generation Callback
        • Suno Voice Validation Phrase Callback
        • Suno Voice Generate Verification Phrase API
        • Suno Voice Create Custom Voice API
        • Suno Voice Regenerate Verification Phrase
        • Suno Voice Check Availability API
    • Gemini
      • Gemini 3.1 Flash Text to speech
      • Gemini 2.5 Pro Text to Speech
  • Chat Models
    • Grok
      • Grok 4.5
      • Grok 4.3
      • Grok 4.6
    • Codex
      • GPT Codex
    • GPT
      • GPT 5.2
      • GPT 5.4 (response)
      • GPT 5.6 Luna
      • GPT 5.6 Terra
      • GPT 5.6 Sol
      • GPT 5.5 (response)
    • Claude
      • Claude Code + emix.ai Integration Guide
      • Claude Sonnet 5
      • Claude Sonnet 4.5
      • Claude Opus 4.7
      • Claude Opus 4.8
      • Claude Opus 5
      • Claude Fable 5
      • Claude Haiku 4.5
      • Claude Opus 4.5
      • Claude Opus 4.6
      • Claude Sonnet 4.5
      • Claude Sonnet 4.6
    • Gemini
      • Gemini 3.6 Flash
      • Gemini 3.6 Flash (openai)
      • Gemini 3.7 Flash (openai)
      • Gemini 2.5 Pro (openai)
      • Gemini 3 Pro (openai)
      • Gemini 3.1 Pro (openai)
      • Gemini 2.5 Flash (openai)
      • Gemini 3 Flash (openai)
      • Gemini 3.5 Flash
      • Gemini 3.5 Flash (openai)
      • Gemini 3 Flash
      • Gemini 3.7 Flash
      • Gemini 3.8 Flash
      • Gemini 3.8 Flash (openai)
  • Get Task Details
    GET
  1. Lyrics Generation

Generate Lyrics

POST
/api/v1/lyrics
Generate creative lyrics content based on a text prompt.

Usage Guide#

Use this endpoint to create lyrics for music composition
Multiple variations of lyrics will be generated for each request
Each generated lyric set includes title and structured verse/chorus sections

Parameter Details#

prompt should describe the theme, style, or subject of the desired lyrics
A detailed prompt yields more targeted and relevant lyrics

Developer Notes#

Generated lyrics are retained for 14 days
Callback occurs once with all generated variations when complete
Typically returns 2-3 different lyric variations per request
Each lyric set is formatted with standard section markers ([Verse], [Chorus], etc.)

Callbacks

audioLyricsGenerated

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
Request successful
Bodyapplication/json

🔴500Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.emix.ai/api/v1/lyrics' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "model": "suno/generate-lyrics",
  "callBackUrl": "https://api.example.com/callback",
  "input": {
    "prompt": "A nostalgic song about childhood memories and growing up in a small town"
  }
}'
Response Response Example
200 - Example 1
{
    "msg": "Playground task completed successfully.",
    "code": 200,
    "data": {
        "resultJson": "{\"result_object\":{\"lyricsData\":[{\"error_message\":\"\",\"text\":\"[Verse]\\nSunrise paints the window pane\\nShadows dance and then they fade\\nA brand new day a brand new game\\nNo more hiding in the shade\\n\\n[Prechorus]\\nMy heart beats loud a steady drum\\nNo fear inside where did it come\\n\\n[Chorus]\\nI'm a mountain to climb\\nA river that runs wild\\nI'm finding my own way\\nEvery single day\\n\\n[Verse 2]\\nWind whispers secrets through the trees\\nA gentle hum a sweet relief\\nI’m stronger now I feel the breeze\\nWashing away my old belief\\n\\n[Prechorus]\\nMy spirit bright a burning flame\\nWhispering my brand new name\\n\\n[Chorus]\\nI'm a mountain to climb\\nA river that runs wild\\nI'm finding my own way\\nEvery single day\",\"title\":\"Mountain to Climb\",\"status\":\"complete\",\"tags\":[\"pop\",\"pop anthem, driving beat, female vocals, layered synths and powerful drums, soaring melodic lines\",\"contemporary\",\"uplifting\",\"theme\",\"empowering\",\"emotional\"]},{\"error_message\":\"\",\"text\":\"[Verse 1]\\nI found my breath in the dark\\nLike dawn on a broken hill\\n\\n[Chorus]\\nI rise, I rise\\nLike a mountain\\nI rise, I rise\\nLike a river\\n\\n[Bridge]\\nAnd every scar\\nLed me home\",\"title\":\"Dawn Inside\",\"status\":\"complete\",\"tags\":[\"Contemporary pop with emotional depth, mid-tempo lift, pulsing kick and bright piano; verses start intimate with sparse keys, pre-chorus opens into rising strings, chorus blooms with stacked harmonies and clap-driven lift. Breathy lead, doubled chorus, delay throws on key words, dawn shimmer and reverse swells. Warm, polished, uplifting mix.\",\"theme\",\"pop\",\"empowering\",\"emotional\",\"contemporary\",\"uplifting\"]}],\"taskId\":\"275cfa3c79823a5fb463296dc3645804\",\"code\":200,\"message\":\"success\"}}",
        "param": "{\"model\":\"suno/generate-lyrics\",\"input\":\"{\\\"prompt\\\":\\\"Write song lyrics about finding inner strength during difficult times. Theme: resilience and self-discovery. Mood: uplifting and empowering. Style: contemporary pop with emotional depth. Include a verse-chorus-bridge structure. Use vivid imagery of nature (dawn, mountains, rivers) as metaphors for personal growth. The chorus should be anthemic and repeatable. Maximum 200 characters.\\\"}\",\"callBackUrl\":\"http://localhost:8305/test\"}",
        "costTime": 6,
        "createTime": 1786350234000,
        "completeTime": 1786350255000,
        "model": "suno/generate-lyrics",
        "updateTime": 1786350255000,
        "state": "success",
        "creditsConsumed": 0.4,
        "taskId": "275cfa3c79823a5fb463296dc3645804"
    }
}
Previous
Lyrics Generation Callbacks
Next
Convert to WAV Format
Built with