{
"code": 404,
"error": {
"message": "Task or audio not found",
"type": "not_found_error"
}
}
After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
Regardless of whether callback_url is provided, you can retrieve the response result through the unified Query Music Detail endpoint.
Business status code. 200 means success; any other value means the request failed. Always check this field: some validation errors return HTTP 200 with code: 400 in the body.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"PoYo AI","colors":{"primary":"#4F46E5","light":"#A5B4FC","dark":"#4338CA"},"logo":{"light":"https://mintcdn.com/goseallc/29Q_kJZSXJtvfdJH/logo/light.svg?fit=max\u0026auto=format\u0026n=29Q_kJZSXJtvfdJH\u0026q=85\u0026s=8af87ad322e9698952f9066b10b97f41","dark":"https://mintcdn.com/goseallc/29Q_kJZSXJtvfdJH/logo/dark.svg?fit=max\u0026auto=format\u0026n=29Q_kJZSXJtvfdJH\u0026q=85\u0026s=f3b51af4915305ef51d0bc2b9c809b89"},"favicon":"https://mintcdn.com/goseallc/N1-_FzFDsG6WGTTd/favicon.ico?fit=max\u0026auto=format\u0026n=N1-_FzFDsG6WGTTd\u0026q=85\u0026s=eb4e11a6efd2d4782785543f2e22f387","api":{"openapi":["openapi.json","api-manual/moderation-series/omni-moderation.json","integrations/capability-catalog.json","api-manual/image-series/ideogram-v4-5.json","api-manual/image-series/ideogram-vector-1-0.json","api-manual/music-series/elevenlabs-v4-tts.json","api-manual/music-series/elevenlabs-v4-turbo-tts.json","api-manual/music-series/gemini-3-8-flash-lite-tts.json","api-manual/music-series/gemini-3-8-flash-tts.json","api-manual/3d-series/meshy-7-1-3d.json","api-manual/image-series/gpt-4o-image.json","api-manual/image-series/gpt-image-1.5.json","api-manual/image-series/gpt-image-2.json","api-manual/image-series/gpt-image-2-5-flare.json","api-manual/image-series/gpt-image-2-5-sunburst.json","api-manual/image-series/qwen-image-3.json","api-manual/image-series/qwen-image-2-1.json","api-manual/image-series/nano-banana.json","api-manual/image-series/nano-banana-2.json","api-manual/image-series/nano-banana-2-new.json","api-manual/image-series/nano-banana-2-lite.json","api-manual/image-series/nano-banana-2-1.json","api-manual/image-series/flux-2.json","api-manual/image-series/flux-dev.json","api-manual/image-series/flux-schnell.json","api-manual/image-series/flux-kontext.json","api-manual/image-series/flux-3-klein.json","api-manual/image-series/seedream-4.json","api-manual/image-series/seedream-4-5.json","api-manual/image-series/seedream-5-0-lite.json","api-manual/image-series/seedream-5-0-pro.json","api-manual/image-series/seedream-5-0-flash.json","api-manual/image-series/wan-2-7-image-pro.json","api-manual/image-series/wan-2-7-image.json","api-manual/image-series/z-image.json","api-manual/image-series/grok-imagine-image.json","api-manual/image-series/grok-imagine-image-2-0.json","api-manual/image-series/grok-imagine-image-quality.json","api-manual/image-series/kling-o1.json","api-manual/image-series/kling-o3.json","api-manual/video-series/sora-2.json","api-manual/video-series/sora-2-pro.json","api-manual/video-series/sora-2-official.json","api-manual/video-series/sora-2-pro-official.json","api-manual/video-series/veo-3-1.json","api-manual/video-series/veo-3-1-official.json","api-manual/video-series/flux-3.json","api-manual/video-series/flux-3-max.json","api-manual/video-series/wan-animate.json","api-manual/video-series/wan2.2-text-to-video-fast.json","api-manual/video-series/wan2.2-image-to-video-fast.json","api-manual/video-series/wan2.5-image-to-video.json","api-manual/video-series/wan2.5-text-to-video.json","api-manual/video-series/wan-2-6.json","api-manual/video-series/wan-2-7-video.json","api-manual/video-series/wan-3-0-video.json","api-manual/video-series/wan-3-0-video-prime.json","api-manual/video-series/kling-1-6.json","api-manual/video-series/kling-2-1.json","api-manual/video-series/kling-2-6.json","api-manual/video-series/kling-2.6-motion-control.json","api-manual/video-series/kling-3-0-motion-control.json","api-manual/video-series/kling-2-5-turbo-pro.json","api-manual/video-series/kling-3-0.json","api-manual/video-series/kling-3-0-turbo.json","api-manual/video-series/kling-3-0-4k.json","api-manual/video-series/kling-4-0.json","api-manual/video-series/kling-avatar-2-0.json","api-manual/video-series/kling-o3.json","api-manual/video-series/kling-o3-4k.json","api-manual/video-series/grok-imagine.json","api-manual/video-series/grok-imagine-video-1-5.json","api-manual/video-series/omni-flash.json","api-manual/video-series/gemini-omni-1.1-flash.json","api-manual/video-series/hailuo-02.json","api-manual/video-series/hailuo-2-3.json","api-manual/video-series/hailuo-03.json","api-manual/video-series/h3-max.json","api-manual/video-series/h3-max-turbo.json","api-manual/video-series/seedance-1.0-pro.json","api-manual/video-series/seedance-1-5-pro.json","api-manual/video-series/seedance-2.json","api-manual/video-series/seedance-2.5.json","api-manual/video-series/seedance-2-mini.json","api-manual/video-series/happy-horse.json","api-manual/video-series/happy-horse-1-1.json","api-manual/video-series/runway-gen-4-5.json","api-manual/video-series/vidu-q4.json","api-manual/video-series/omnihuman-2-0.json","api-manual/video-series/pixverse-v6-max.json","api-manual/task-management/3d-status.json","api-manual/task-management/image-status.json","api-manual/task-management/video-status.json","api-manual/3d-series/meshy-6-3d.json","api-manual/3d-series/hunyuan-3d-3-1.json","api-manual/3d-series/tripo-h31-3d.json","api-manual/3d-series/tripo-p1-3d.json","api-manual/music-series/generate-music.json","api-manual/music-series/generate-mashup.json","api-manual/music-series/generate-sounds.json","api-manual/music-series/minimax-music-2.6.json","api-manual/music-series/elevenlabs-music.json","api-manual/music-series/elevenlabs-v3-tts.json","api-manual/music-series/elevenlabs-tts-turbo-2-5.json","api-manual/music-series/gemini-3-1-flash-tts.json","api-manual/music-series/xai-tts-1.json","api-manual/music-series/extend-music.json","api-manual/music-series/upload-and-cover-audio.json","api-manual/music-series/upload-and-extend-audio.json","api-manual/music-series/add-instrumental.json","api-manual/music-series/add-vocals.json","api-manual/music-series/get-timestamped-lyrics.json","api-manual/music-series/boost-music-style.json","api-manual/music-series/generate-music-cover.json","api-manual/music-series/replace-section.json","api-manual/music-series/generate-persona.json","api-manual/music-series/generate-lyrics.json","api-manual/music-series/convert-to-wav.json","api-manual/music-series/vocal-remover/separate-vocals.json","api-manual/music-series/vocal-remover/stem-split.json","api-manual/music-series/vocal-remover/upload-and-separate-vocals.json","api-manual/music-series/voice/validate.json","api-manual/music-series/voice/generate.json","api-manual/music-series/voice/regenerate.json","api-manual/music-series/voice/check.json","api-manual/music-series/create-music-video.json","api-manual/music-series/query-music-detail.json","api-manual/chat-series/chat-completions.json","api-manual/chat-series/responses.json","api-manual/chat-series/claude-messages.json","api-manual/chat-series/gemini-native-format.json","api-manual/chat-series/openai.json","api-manual/chat-series/anthropic.json","api-manual/chat-series/google.json","api-manual/chat-series/deepseek.json","api-manual/chat-series/xai.json","api-manual/chat-series/moonshot.json","api-manual/tools-series/image-translator.json","api-manual/tools-series/video-translator.json","api-manual/tools-series/video-background-removal.json","api-manual/tools-series/video-upscaler.json","api-manual/image-series/gpt-image-2-5-fixed.json","api-manual/image-series/gpt-image-2-6-fixed.json","api-manual/music-series/generate-midi.json","api-manual/account-management/user-balance.json","api-manual/file-series/upload-url.json","api-manual/file-series/upload-base64.json","api-manual/file-series/upload-stream.json","zh/openapi.json","zh/api-manual/moderation-series/omni-moderation.json","zh/integrations/capability-catalog.json","zh/api-manual/image-series/ideogram-v4-5.json","zh/api-manual/image-series/ideogram-vector-1-0.json","zh/api-manual/music-series/elevenlabs-v4-tts.json","zh/api-manual/music-series/elevenlabs-v4-turbo-tts.json","zh/api-manual/music-series/gemini-3-8-flash-lite-tts.json","zh/api-manual/music-series/gemini-3-8-flash-tts.json","zh/api-manual/3d-series/meshy-7-1-3d.json","zh/api-manual/image-series/gpt-4o-image.json","zh/api-manual/image-series/gpt-image-1.5.json","zh/api-manual/image-series/gpt-image-2.json","zh/api-manual/image-series/gpt-image-2-5-flare.json","zh/api-manual/image-series/gpt-image-2-5-sunburst.json","zh/api-manual/image-series/qwen-image-3.json","zh/api-manual/image-series/qwen-image-2-1.json","zh/api-manual/image-series/nano-banana.json","zh/api-manual/image-series/nano-banana-2.json","zh/api-manual/image-series/nano-banana-2-new.json","zh/api-manual/image-series/nano-banana-2-lite.json","zh/api-manual/image-series/nano-banana-2-1.json","zh/api-manual/image-series/flux-2.json","zh/api-manual/image-series/flux-dev.json","zh/api-manual/image-series/flux-schnell.json","zh/api-manual/image-series/flux-kontext.json","zh/api-manual/image-series/flux-3-klein.json","zh/api-manual/image-series/seedream-4.json","zh/api-manual/image-series/seedream-4-5.json","zh/api-manual/image-series/seedream-5-0-lite.json","zh/api-manual/image-series/seedream-5-0-pro.json","zh/api-manual/image-series/seedream-5-0-flash.json","zh/api-manual/image-series/wan-2-7-image-pro.json","zh/api-manual/image-series/wan-2-7-image.json","zh/api-manual/image-series/z-image.json","zh/api-manual/image-series/grok-imagine-image.json","zh/api-manual/image-series/grok-imagine-image-2-0.json","zh/api-manual/image-series/grok-imagine-image-quality.json","zh/api-manual/image-series/kling-o1.json","zh/api-manual/image-series/kling-o3.json","zh/api-manual/video-series/sora-2.json","zh/api-manual/video-series/sora-2-pro.json","zh/api-manual/video-series/sora-2-official.json","zh/api-manual/video-series/sora-2-pro-official.json","zh/api-manual/video-series/veo-3-1.json","zh/api-manual/video-series/veo-3-1-official.json","zh/api-manual/video-series/flux-3.json","zh/api-manual/video-series/flux-3-max.json","zh/api-manual/video-series/wan-animate.json","zh/api-manual/video-series/wan2.2-text-to-video-fast.json","zh/api-manual/video-series/wan2.2-image-to-video-fast.json","zh/api-manual/video-series/wan2.5-image-to-video.json","zh/api-manual/video-series/wan2.5-text-to-video.json","zh/api-manual/video-series/wan-2-6.json","zh/api-manual/video-series/wan-2-7-video.json","zh/api-manual/video-series/wan-3-0-video.json","zh/api-manual/video-series/wan-3-0-video-prime.json","zh/api-manual/video-series/kling-1-6.json","zh/api-manual/video-series/kling-2-1.json","zh/api-manual/video-series/kling-2-6.json","zh/api-manual/video-series/kling-2.6-motion-control.json","zh/api-manual/video-series/kling-3-0-motion-control.json","zh/api-manual/video-series/kling-2-5-turbo-pro.json","zh/api-manual/video-series/kling-3-0.json","zh/api-manual/video-series/kling-3-0-turbo.json","zh/api-manual/video-series/kling-3-0-4k.json","zh/api-manual/video-series/kling-4-0.json","zh/api-manual/video-series/kling-avatar-2-0.json","zh/api-manual/video-series/kling-o3.json","zh/api-manual/video-series/kling-o3-4k.json","zh/api-manual/video-series/grok-imagine.json","zh/api-manual/video-series/grok-imagine-video-1-5.json","zh/api-manual/video-series/omni-flash.json","zh/api-manual/video-series/gemini-omni-1.1-flash.json","zh/api-manual/video-series/hailuo-02.json","zh/api-manual/video-series/hailuo-2-3.json","zh/api-manual/video-series/hailuo-03.json","zh/api-manual/video-series/h3-max.json","zh/api-manual/video-series/h3-max-turbo.json","zh/api-manual/video-series/seedance-1.0-pro.json","zh/api-manual/video-series/seedance-1-5-pro.json","zh/api-manual/video-series/seedance-2.json","zh/api-manual/video-series/seedance-2.5.json","zh/api-manual/video-series/seedance-2-mini.json","zh/api-manual/video-series/happy-horse.json","zh/api-manual/video-series/happy-horse-1-1.json","zh/api-manual/video-series/runway-gen-4-5.json","zh/api-manual/video-series/vidu-q4.json","zh/api-manual/video-series/omnihuman-2-0.json","zh/api-manual/video-series/pixverse-v6-max.json","zh/api-manual/task-management/3d-status.json","zh/api-manual/task-management/image-status.json","zh/api-manual/task-management/video-status.json","zh/api-manual/3d-series/meshy-6-3d.json","zh/api-manual/3d-series/hunyuan-3d-3-1.json","zh/api-manual/3d-series/tripo-h31-3d.json","zh/api-manual/3d-series/tripo-p1-3d.json","zh/api-manual/music-series/generate-music.json","zh/api-manual/music-series/generate-mashup.json","zh/api-manual/music-series/generate-sounds.json","zh/api-manual/music-series/minimax-music-2.6.json","zh/api-manual/music-series/elevenlabs-music.json","zh/api-manual/music-series/elevenlabs-v3-tts.json","zh/api-manual/music-series/elevenlabs-tts-turbo-2-5.json","zh/api-manual/music-series/gemini-3-1-flash-tts.json","zh/api-manual/music-series/xai-tts-1.json","zh/api-manual/music-series/extend-music.json","zh/api-manual/music-series/upload-and-cover-audio.json","zh/api-manual/music-series/upload-and-extend-audio.json","zh/api-manual/music-series/add-instrumental.json","zh/api-manual/music-series/add-vocals.json","zh/api-manual/music-series/get-timestamped-lyrics.json","zh/api-manual/music-series/boost-music-style.json","zh/api-manual/music-series/generate-music-cover.json","zh/api-manual/music-series/replace-section.json","zh/api-manual/music-series/generate-persona.json","zh/api-manual/music-series/generate-lyrics.json","zh/api-manual/music-series/convert-to-wav.json","zh/api-manual/music-series/vocal-remover/separate-vocals.json","zh/api-manual/music-series/vocal-remover/stem-split.json","zh/api-manual/music-series/vocal-remover/upload-and-separate-vocals.json","zh/api-manual/music-series/voice/validate.json","zh/api-manual/music-series/voice/generate.json","zh/api-manual/music-series/voice/regenerate.json","zh/api-manual/music-series/voice/check.json","zh/api-manual/music-series/create-music-video.json","zh/api-manual/music-series/query-music-detail.json","zh/api-manual/chat-series/chat-completions.json","zh/api-manual/chat-series/responses.json","zh/api-manual/chat-series/claude-messages.json","zh/api-manual/chat-series/gemini-native-format.json","zh/api-manual/chat-series/openai.json","zh/api-manual/chat-series/anthropic.json","zh/api-manual/chat-series/google.json","zh/api-manual/chat-series/deepseek.json","zh/api-manual/chat-series/xai.json","zh/api-manual/chat-series/moonshot.json","zh/api-manual/tools-series/image-translator.json","zh/api-manual/tools-series/video-translator.json","zh/api-manual/tools-series/video-background-removal.json","zh/api-manual/tools-series/video-upscaler.json","zh/api-manual/image-series/gpt-image-2-5-fixed.json","zh/api-manual/image-series/gpt-image-2-6-fixed.json","zh/api-manual/music-series/generate-midi.json","zh/api-manual/account-management/user-balance.json","zh/api-manual/file-series/upload-url.json","zh/api-manual/file-series/upload-base64.json","zh/api-manual/file-series/upload-stream.json"],"playground":{},"mdx":{"auth":{"method":"key","name":"x-api-key"},"server":"https://api.poyo.ai"}},"background":{"color":{"light":"#FFFFFF","dark":"#0B0B0F"}},"navbar":{"links":[{"icon":"discord","href":"https://discord.gg/F8JNuUPB3j","label":"Discord"}],"primary":{"type":"button","label":"Market","href":"https://poyo.ai/models"}},"fonts":{"family":"Geist"},"styling":{"codeblocks":"dark","latex":false},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"navigation":{"global":{},"languages":[{"language":"en","href":""},{"language":"zh","href":"zh"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"goseallc","hasAudioNarration":false,"actualSubdomain":"goseallc","customDomains":["docs.poyo.ai"],"gitSource":{"type":"github","owner":"coolhackboy","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aec58778c2847cc731f0b3e","collectionId":"466d8b0b-04c1-4c69-8704-21171f2d2922","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aec58778c2847cc731f0b3e"},"entitlements":{},"buildId":"6aec58778c2847cc731f0b3e","clientVersion":"0.0.4071","searchFilterCounts":[{"language":"en","tag":"Video Models","count":94},{"language":"zh","tag":"视频模型","count":94},{"language":"en","tag":"Music Models","count":72},{"language":"zh","tag":"音乐模型","count":72},{"language":"en","tag":"Image Models","count":70},{"language":"zh","tag":"图像模型","count":70},{"language":"en","tag":"Suno AI","count":25},{"language":"zh","tag":"Suno AI","count":25},{"language":"en","tag":"LLM Models","count":22},{"language":"zh","tag":"LLM 模型","count":22},{"language":"en","tag":"Platform","count":18},{"language":"zh","tag":"平台","count":18},{"language":"en","tag":"Kling","count":15},{"language":"zh","tag":"Kling","count":15},{"language":"en","tag":"AI Agents","count":13},{"language":"zh","tag":"AI Agent","count":13},{"language":"en","tag":"3D Models","count":12},{"language":"en","tag":"Google","count":12},{"language":"zh","tag":"3D 模型","count":12},{"language":"zh","tag":"Google","count":12}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":""}],"page":{"pagePath":"api-manual/music-series/get-timestamped-lyrics","slug":"/api-manual/music-series/get-timestamped-lyrics","pageMetadata":{"title":"Get Timestamped Lyrics","description":"Retrieve synchronized lyrics with precise timestamps","icon":"music","openapi":"api-manual/music-series/get-timestamped-lyrics.json POST /api/generate/submit","href":"/api-manual/music-series/get-timestamped-lyrics"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Retrieve synchronized lyrics with precise timestamps\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Tip}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Tip,{children:_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`After submission, a `,_jsx(_components.code,{children:`task_id`}),` will be returned. If you provided a `,_jsx(_components.code,{children:`callback_url`}),`, when the task status becomes `,_jsx(_components.code,{children:`finished`}),` or `,_jsx(_components.code,{children:`failed`}),`, a POST request will be sent to the `,_jsx(_components.code,{children:`callback_url`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Regardless of whether `,_jsx(_components.code,{children:`callback_url`}),` is provided, you can retrieve the response result through the unified `,_jsx(_components.a,{href:`/api-manual/music-series/query-music-detail`,children:`Query Music Detail`}),` endpoint.`]}),`\n`]})}),`\n`,_jsx(Heading,{level:`2`,id:`usage-guide`,children:`Usage Guide`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`This endpoint retrieves synchronized lyrics with precise timestamps for generated audio tracks`}),`\n`,_jsx(_components.li,{children:`Use this to create karaoke-style displays, subtitles, or lyric visualizations`}),`\n`,_jsx(_components.li,{children:`Requires a completed music generation task with vocals`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`parameter-details`,children:`Parameter Details`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Required parameters:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`task_id`}),`: The unique identifier from a previous music generation task`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`audio_id`}),`: The specific audio track identifier from the task result`]}),`\n`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Both identifiers are obtained from the response of music generation endpoints or their callbacks`}),`\n`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`developer-notes`,children:`Developer Notes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`This endpoint only works with audio tracks that contain vocals`}),`\n`,_jsxs(_components.li,{children:[`The `,_jsx(_components.code,{children:`hoot_cer`}),` (Character Error Rate) value indicates alignment precision - lower values mean better accuracy`]}),`\n`,_jsxs(_components.li,{children:[`Use `,_jsx(_components.code,{children:`waveform_data`}),` for creating audio visualizations alongside the lyrics`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`response-fields`,children:`Response Fields`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`aligned_words`}),` (array): List of lyric words with timing information`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`word`}),` (string): The lyric text, may include section markers like `,_jsx(_components.code,{children:`[Verse]`}),`, `,_jsx(_components.code,{children:`[Chorus]`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`start_s`}),` (number): Word start time in seconds`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`end_s`}),` (number): Word end time in seconds`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`success`}),` (boolean): Whether the word was successfully aligned`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`palign`}),` (number): Alignment confidence score`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`waveform_data`}),` (array): Numerical data for audio waveform visualization`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`hoot_cer`}),` (number): Alignment precision score (Character Error Rate)`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`is_streamed`}),` (boolean): Indicates if the audio is a streamed track`]}),`\n`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Get Timestamped Lyrics","description":"Retrieve synchronized lyrics with precise timestamps","icon":"music","openapi":"api-manual/music-series/get-timestamped-lyrics.json POST /api/generate/submit","href":"/api-manual/music-series/get-timestamped-lyrics"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Usage Guide","slug":"usage-guide","depth":2,"children":[]},{"title":"Parameter Details","slug":"parameter-details","depth":2,"children":[]},{"title":"Developer Notes","slug":"developer-notes","depth":2,"children":[]},{"title":"Response Fields","slug":"response-fields","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Submit Get Timestamped Lyrics Task","description":"Retrieve synchronized lyrics with precise timestamps","operationId":"submitGetTimestampedLyricsTask","tags":["Music Generation"],"requestBody":"b1397061-bbf8-4a1a-b5ea-9af0c037cc94","responses":{"200":"e5f142f4-20e2-4b19-9c4b-5c16385a1bc6","404":"7423a78e-0440-4b0d-89f6-b82d274802f3"},"method":"post","type":"path","servers":["f67096a0-510f-4498-afe7-24b0e8d2c654"],"security":["c5409908-de0d-4c48-bc04-d88f0cb0e04e"],"path":"/api/generate/submit","baseUrlOptions":["https://api.poyo.ai"],"title":"Submit Get Timestamped Lyrics Task","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","input"],"properties":{"model":{"type":"string","description":"API model identifier.\n\nMust be `get-timestamped-lyrics` for this endpoint.","enum":["get-timestamped-lyrics"],"example":"get-timestamped-lyrics","isRequired":true,"uniqueKey":"model","typeLabel":"enum\u003cstring>"},"input":{"type":"object","required":["task_id","audio_id"],"description":"Input parameters for retrieving timestamped lyrics","properties":{"task_id":{"type":"string","description":"Unique identifier of the music generation task.\n\nObtained from the response of a previous music generation request.","example":"task-unified-1757165031-uyujaw3d","isRequired":true,"uniqueKey":"input.task_id","typeLabel":"string"},"audio_id":{"type":"string","description":"Unique identifier of the specific audio track.\n\nObtained from the task result or callback response.","example":"e231xxxx-xxxx-xxxx-xxxx-xxxx8cadc7dc","isRequired":true,"uniqueKey":"input.audio_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"input","typeLabel":"object"},"callback_url":{"type":"string","format":"uri","description":"Webhook callback URL for result notifications","example":"https://your-domain.com/callback","uniqueKey":"callback_url","typeLabel":"string\u003curi>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"basic":{"title":"basic","value":{"model":"get-timestamped-lyrics","callback_url":"https://your-domain.com/callback","input":{"task_id":"task-unified-1757165031-uyujaw3d","audio_id":"e231xxxx-xxxx-xxxx-xxxx-xxxx8cadc7dc"}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"e5f142f4-20e2-4b19-9c4b-5c16385a1bc6":{"description":"Timestamped lyrics retrieved successfully","content":{"application/json":{"schema":{"type":"object","required":["code","data"],"properties":{"code":{"type":"integer","example":200,"description":"Business status code. `200` means success; any other value means the request failed. Always check this field: some validation errors return HTTP 200 with `code: 400` in the body.\n\n- `200`: Success\n- `400`: Invalid request parameters\n- `401`: Missing or invalid API key\n- `402`: Insufficient credits\n- `403`: Permission denied\n- `404`: Resource not found\n- `408`: Request timeout\n- `429`: Rate limit exceeded\n- `500`: Internal server error\n- `502`: Upstream service error\n- `503`: Service unavailable\n\nSee [Error Codes](/api-manual/error-codes) for details.","enum":[200,400,401,402,403,404,408,429,500,502,503],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cinteger>"},"data":{"type":"object","properties":{"aligned_words":{"type":"array","description":"List of aligned lyric words with timing information","items":{"type":"object","properties":{"word":{"type":"string","description":"The lyric text (may include section markers like [Verse])","example":"[Verse] Waggin'","uniqueKey":"data.aligned_words.items.[INDEX].word","typeLabel":"string"},"success":{"type":"boolean","description":"Whether the word was successfully aligned","example":true,"uniqueKey":"data.aligned_words.items.[INDEX].success","typeLabel":"boolean"},"start_s":{"type":"number","description":"Start time of the word in seconds","example":1.36,"uniqueKey":"data.aligned_words.items.[INDEX].start_s","typeLabel":"number"},"end_s":{"type":"number","description":"End time of the word in seconds","example":1.79,"uniqueKey":"data.aligned_words.items.[INDEX].end_s","typeLabel":"number"},"palign":{"type":"number","description":"Alignment confidence score","example":0,"uniqueKey":"data.aligned_words.items.[INDEX].palign","typeLabel":"number"}},"uniqueKey":"data.aligned_words.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.aligned_words","typeLabel":"object[]"},"waveform_data":{"type":"array","description":"Waveform data for audio visualization","items":{"type":"number","uniqueKey":"data.waveform_data.items.[INDEX]","typeLabel":"number"},"example":[0,1,0.5,0.75],"uniqueKey":"data.waveform_data","typeLabel":"number[]"},"hoot_cer":{"type":"number","description":"Lyrics alignment precision score (Character Error Rate).\n\nLower values indicate better alignment accuracy.","example":0.38,"uniqueKey":"data.hoot_cer","typeLabel":"number"},"is_streamed":{"type":"boolean","description":"Indicates whether this is a streamed audio track","example":false,"uniqueKey":"data.is_streamed","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":200,"data":{"aligned_words":[{"word":"[Verse] Waggin'","success":true,"start_s":1.36,"end_s":1.79,"palign":0}],"waveform_data":[0,1,0.5,0.75],"hoot_cer":0.38,"is_streamed":false}}}},"exampleType":"generated"}},"exampleType":"generated"},"7423a78e-0440-4b0d-89f6-b82d274802f3":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","required":["code","error"],"properties":{"code":{"type":"integer","example":400,"description":"Business status code. `200` means success; any other value means the request failed. Always check this field: some validation errors return HTTP 200 with `code: 400` in the body.\n\n- `200`: Success\n- `400`: Invalid request parameters\n- `401`: Missing or invalid API key\n- `402`: Insufficient credits\n- `403`: Permission denied\n- `404`: Resource not found\n- `408`: Request timeout\n- `429`: Rate limit exceeded\n- `500`: Internal server error\n- `502`: Upstream service error\n- `503`: Service unavailable\n\nSee [Error Codes](/api-manual/error-codes) for details.","enum":[200,400,401,402,403,404,408,429,500,502,503],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cinteger>"},"error":{"type":"object","required":["message","type"],"properties":{"message":{"type":"string","example":"Invalid request parameters","description":"Error message describing what went wrong","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","example":"invalid_request_error","description":"Error type identifier","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":404,"error":{"message":"Task or audio not found","type":"not_found_error"}},"examples":{"Example":{"title":"Example","value":{"code":404,"error":{"message":"Task or audio not found","type":"not_found_error"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"c5409908-de0d-4c48-bc04-d88f0cb0e04e":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"All API endpoints require Bearer Token authentication.\n\nCreate an API key: sign in to PoYo, open **Dashboard → API Key** at [poyo.ai/dashboard/api-key](https://poyo.ai/dashboard/api-key), and click to create a key.\n\nAdd it to the request header:\n\n```\nAuthorization: Bearer YOUR_API_KEY\n```","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"f67096a0-510f-4498-afe7-24b0e8d2c654":{"url":"https://api.poyo.ai","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"All API endpoints require Bearer Token authentication.\n\nCreate an API key: sign in to PoYo, open **Dashboard → API Key** at [poyo.ai/dashboard/api-key](https://poyo.ai/dashboard/api-key), and click to create a key.\n\nAdd it to the request header:\n\n```\nAuthorization: Bearer YOUR_API_KEY\n```","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"All API endpoints require Bearer Token authentication.\n\nCreate an API key: sign in to PoYo, open **Dashboard → API Key** at [poyo.ai/dashboard/api-key](https://poyo.ai/dashboard/api-key), and click to create a key.\n\nAdd it to the request header:\n\n```\nAuthorization: Bearer YOUR_API_KEY\n```","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"api-manual/music-series/get-timestamped-lyrics.json"},"subdomain":"goseallc","siteName":"PoYo AI","title":"Get Timestamped Lyrics - PoYo AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-manual/music-series/get-timestamped-lyrics","matchLevel":0},"zh":{"href":"/zh/api-manual/music-series/get-timestamped-lyrics","matchLevel":1}}},"lastModified":"2026-01-28T12:20:21.269Z","originalFileLocation":"api-manual/music-series/get-timestamped-lyrics.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Retrieve synchronized lyrics with precise timestamps\">\u003cmeta data-mint-head name=\"application-name\" content=\"PoYo AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/goseallc/_txJMi_sP9EUfefV/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/goseallc/_txJMi_sP9EUfefV/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/goseallc/_txJMi_sP9EUfefV/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/goseallc/_txJMi_sP9EUfefV/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/goseallc/_txJMi_sP9EUfefV/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/goseallc/_txJMi_sP9EUfefV/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/goseallc/_txJMi_sP9EUfefV/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/goseallc/_txJMi_sP9EUfefV/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/goseallc/_txJMi_sP9EUfefV/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Timestamped Lyrics - PoYo AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve synchronized lyrics with precise timestamps\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"PoYo AI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://goseallc.mintlify.app/_mintlify/api/og/v2?division=Suno+AI\u0026amp;title=Get+Timestamped+Lyrics\u0026amp;description=Retrieve+synchronized+lyrics+with+precise+timestamps\u0026amp;theme=ecc0b2c14fb9965076e6096c\u0026amp;signature=5b5997e009d9df7cc7c8bceca0608288d1d19355c1144632645389f7fef84afa\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get Timestamped Lyrics - PoYo AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve synchronized lyrics with precise timestamps\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://goseallc.mintlify.app/_mintlify/api/og/v2?division=Suno+AI\u0026amp;title=Get+Timestamped+Lyrics\u0026amp;description=Retrieve+synchronized+lyrics+with+precise+timestamps\u0026amp;theme=ecc0b2c14fb9965076e6096c\u0026amp;signature=5b5997e009d9df7cc7c8bceca0608288d1d19355c1144632645389f7fef84afa\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/goseallc/_txJMi_sP9EUfefV/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"PoYo AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4F46E5\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-manual/music-series/get-timestamped-lyrics.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.poyo.ai/zh/api-manual/music-series/get-timestamped-lyrics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.poyo.ai/#organization\",\"name\":\"PoYo AI\",\"url\":\"https://docs.poyo.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/goseallc/29Q_kJZSXJtvfdJH/logo/light.svg?fit=max\u0026auto=format\u0026n=29Q_kJZSXJtvfdJH\u0026q=85\u0026s=8af87ad322e9698952f9066b10b97f41\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.poyo.ai#website\",\"name\":\"PoYo AI\",\"url\":\"https://docs.poyo.ai\",\"publisher\":{\"@id\":\"https://docs.poyo.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics#webpage\",\"url\":\"https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics\",\"name\":\"Get Timestamped Lyrics\",\"description\":\"Retrieve synchronized lyrics with precise timestamps\",\"dateModified\":\"2026-01-28T12:20:21.269Z\",\"isPartOf\":{\"@id\":\"https://docs.poyo.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Music Models\",\"item\":\"https://docs.poyo.ai/api-manual/music-series/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Suno AI\",\"item\":\"https://docs.poyo.ai/api-manual/music-series/generate-music\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get Timestamped Lyrics\",\"item\":\"https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics#apireference\",\"headline\":\"Get Timestamped Lyrics\",\"name\":\"Get Timestamped Lyrics\",\"description\":\"Retrieve synchronized lyrics with precise timestamps\",\"url\":\"https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics\",\"mainEntityOfPage\":{\"@id\":\"https://docs.poyo.ai/api-manual/music-series/get-timestamped-lyrics#webpage\"},\"dateModified\":\"2026-01-28T12:20:21.269Z\",\"publisher\":{\"@id\":\"https://docs.poyo.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.poyo.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"PoYo AI\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"PoYo AI","nav":{"global":{},"languages":[{"language":"en","tabs":[{"tab":"Platform","pages":[{"title":"Platform","href":""}]},{"tab":"Image Models","pages":[{"title":"Image Models","href":"/api-manual/image-series/overview"}]},{"tab":"Video Models","pages":[{"title":"Video Models","href":"/api-manual/video-series/overview"}]},{"tab":"LLM Models","pages":[{"title":"LLM Models","href":"/api-manual/chat-series/overview"}]},{"tab":"3D Models","pages":[{"title":"3D Models","href":"/api-manual/3d-series/overview"}]},{"tab":"Music Models","groups":[{"group":"Music Models","pages":[{"title":"Music \u0026 Audio Models","icon":"music","href":"/api-manual/music-series/overview"},{"group":"Suno AI","pages":[{"title":"Generate Music","icon":"music","openapi":"api-manual/music-series/generate-music.json POST /api/generate/submit","href":"/api-manual/music-series/generate-music"},{"title":"Generate MIDI","icon":"music","openapi":"api-manual/music-series/generate-midi.json POST /api/generate/submit","href":"/api-manual/music-series/generate-midi"},{"title":"Generate Mashup","icon":"music","openapi":"api-manual/music-series/generate-mashup.json POST /api/generate/submit","href":"/api-manual/music-series/generate-mashup"},{"title":"Generate Sounds","icon":"music","openapi":"api-manual/music-series/generate-sounds.json POST /api/generate/submit","href":"/api-manual/music-series/generate-sounds"},{"title":"Extend Music","icon":"music","openapi":"api-manual/music-series/extend-music.json POST /api/generate/submit","href":"/api-manual/music-series/extend-music"},{"title":"Upload and Cover Audio","icon":"music","openapi":"api-manual/music-series/upload-and-cover-audio.json POST /api/generate/submit","href":"/api-manual/music-series/upload-and-cover-audio"},{"title":"Upload and Extend Audio","icon":"music","openapi":"api-manual/music-series/upload-and-extend-audio.json POST /api/generate/submit","href":"/api-manual/music-series/upload-and-extend-audio"},{"title":"Add Instrumental","icon":"music","openapi":"api-manual/music-series/add-instrumental.json POST /api/generate/submit","href":"/api-manual/music-series/add-instrumental"},{"title":"Add Vocals","description":"Layer AI-generated vocals on top of an existing instrumental","icon":"music","openapi":"api-manual/music-series/add-vocals.json POST /api/generate/submit","href":"/api-manual/music-series/add-vocals"},{"title":"Get Timestamped Lyrics","icon":"music","openapi":"api-manual/music-series/get-timestamped-lyrics.json POST /api/generate/submit","href":"/api-manual/music-series/get-timestamped-lyrics"},{"title":"Boost Music Style","description":"Generate enhanced music style descriptions using AI","icon":"music","openapi":"api-manual/music-series/boost-music-style.json POST /api/generate/submit","href":"/api-manual/music-series/boost-music-style"},{"title":"Generate Music Cover","icon":"music","openapi":"api-manual/music-series/generate-music-cover.json POST /api/generate/submit","href":"/api-manual/music-series/generate-music-cover"},{"title":"Replace Section","icon":"music","openapi":"api-manual/music-series/replace-section.json POST /api/generate/submit","href":"/api-manual/music-series/replace-section"},{"title":"Generate Persona","icon":"music","openapi":"api-manual/music-series/generate-persona.json POST /api/generate/submit","href":"/api-manual/music-series/generate-persona"},{"title":"Generate Lyrics","icon":"music","openapi":"api-manual/music-series/generate-lyrics.json POST /api/generate/submit","href":"/api-manual/music-series/generate-lyrics"},{"title":"Convert to WAV","icon":"music","openapi":"api-manual/music-series/convert-to-wav.json POST /api/generate/submit","href":"/api-manual/music-series/convert-to-wav"},{"group":"Vocal Remover","pages":[{"title":"Separate Vocals","icon":"music","openapi":"api-manual/music-series/vocal-remover/separate-vocals.json POST /api/generate/submit","href":"/api-manual/music-series/vocal-remover/separate-vocals"},{"title":"Stem Split","icon":"music","openapi":"api-manual/music-series/vocal-remover/stem-split.json POST /api/generate/submit","href":"/api-manual/music-series/vocal-remover/stem-split"},{"title":"Upload and Separate Vocals","icon":"music","openapi":"api-manual/music-series/vocal-remover/upload-and-separate-vocals.json POST /api/generate/submit","href":"/api-manual/music-series/vocal-remover/upload-and-separate-vocals"}]},{"group":"Suno Voice","pages":[{"title":"Suno Voice Workflow","icon":"microphone","href":"/api-manual/music-series/voice/overview"},{"title":"Validate Suno Voice","icon":"microphone","openapi":"api-manual/music-series/voice/validate.json POST /api/generate/submit","href":"/api-manual/music-series/voice/validate"},{"title":"Generate Suno Voice","icon":"microphone-lines","openapi":"api-manual/music-series/voice/generate.json POST /api/generate/submit","href":"/api-manual/music-series/voice/generate"},{"title":"Regenerate Voice Phrase","icon":"rotate","openapi":"api-manual/music-series/voice/regenerate.json POST /api/generate/submit","href":"/api-manual/music-series/voice/regenerate"},{"title":"Check Suno Voice","icon":"circle-check","openapi":"api-manual/music-series/voice/check.json POST /api/generate/submit","href":"/api-manual/music-series/voice/check"}]},{"title":"Create Music Video","icon":"music","openapi":"api-manual/music-series/create-music-video.json POST /api/generate/submit","href":"/api-manual/music-series/create-music-video"}]},{"group":"MiniMax","pages":[{"title":"MiniMax Music 2.6","icon":"music","openapi":"api-manual/music-series/minimax-music-2.6.json POST /api/generate/submit","href":"/api-manual/music-series/minimax-music-2.6"}]},{"group":"ElevenLabs","pages":[{"title":"ElevenLabs Music","icon":"music","openapi":"api-manual/music-series/elevenlabs-music.json POST /api/generate/submit","href":"/api-manual/music-series/elevenlabs-music"},{"title":"ElevenLabs V3 TTS","icon":"music","openapi":"api-manual/music-series/elevenlabs-v3-tts.json POST /api/generate/submit","href":"/api-manual/music-series/elevenlabs-v3-tts"},{"title":"ElevenLabs TTS Turbo v2.5","icon":"music","openapi":"api-manual/music-series/elevenlabs-tts-turbo-2-5.json POST /api/generate/submit","href":"/api-manual/music-series/elevenlabs-tts-turbo-2-5"},{"title":"ElevenLabs V4 TTS","icon":"music","openapi":"api-manual/music-series/elevenlabs-v4-tts.json POST /api/generate/submit","href":"/api-manual/music-series/elevenlabs-v4-tts"},{"title":"ElevenLabs V4 Turbo TTS","icon":"music","openapi":"api-manual/music-series/elevenlabs-v4-turbo-tts.json POST /api/generate/submit","href":"/api-manual/music-series/elevenlabs-v4-turbo-tts"}]},{"group":"Google","pages":[{"title":"Gemini 3.1 Flash TTS","icon":"music","openapi":"api-manual/music-series/gemini-3-1-flash-tts.json POST /api/generate/submit","href":"/api-manual/music-series/gemini-3-1-flash-tts"},{"title":"Gemini 3.8 Flash Lite TTS","icon":"music","openapi":"api-manual/music-series/gemini-3-8-flash-lite-tts.json POST /api/generate/submit","href":"/api-manual/music-series/gemini-3-8-flash-lite-tts"},{"title":"Gemini 3.8 Flash TTS","icon":"music","openapi":"api-manual/music-series/gemini-3-8-flash-tts.json POST /api/generate/submit","href":"/api-manual/music-series/gemini-3-8-flash-tts"}]},{"group":"xAI","pages":[{"title":"xAI TTS 1","icon":"music","openapi":"api-manual/music-series/xai-tts-1.json POST /api/generate/submit","href":"/api-manual/music-series/xai-tts-1"}]}]}]},{"tab":"AI Tools","pages":[{"title":"AI Tools","href":"/api-manual/tools-series/overview"}]},{"tab":"AI Agents","pages":[{"title":"AI Agents","href":"/integrations/overview"}]}]},{"language":"zh","pages":[{"title":"zh","href":"/zh/api-manual/music-series/get-timestamped-lyrics"}]}]},"basePath":"","title":"Get Timestamped Lyrics - PoYo AI","buildId":"dpl_GZsjphRpnhWkstV12jxWNcMHFyox","deploymentId":"dpl_GZsjphRpnhWkstV12jxWNcMHFyox","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B5zPa4Vr.js","utils-CVjrr8Yd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DTgURWzl.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DxTHtkdZ.js","snippetPresets-Cx47o5Vx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-4Fr6y9N_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Dq2ElbEk.js","shallow-BfYl9r69.js","getApiPlaygroundDisplay-Ch3xc7i1.js","CodeSnippet-BsBxuJ1v.js","CodeSnippets-CetzeDL8.js","Page-CYZot51e.js","getPastedJson-BxPKFSJx.js","icon-o0J1Ochb.js","MethodPill-Du3usO5m.js","DuplicateIcon-DJypyMzl.js","createIcon-YMA6N8KJ.js","DynamicMarkdown-CWvhfcZc.js","SectionHeading-BdLVaXCd.js","axios-vUo_bRtp.js","Markdown-C4Ez6OeV.js","clsx-DptzKFCt.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Dt1IougW.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CZ6Wt2Vb.js"]}