curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "elevenlabs-music",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "text": "A polished instrumental cinematic game menu loop for a neon sci-fi strategy game, elegant synth arpeggios, warm analog pads, restrained percussion, gradual heroic lift, no vocals, seamless background score.",
    "duration": 45,
    "is_instrumental": true,
    "output_format": "opus_48000_128"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task_xxxxxxxxxxxxxxxx",
    "status": "not_started",
    "created_time": "2026-06-26T10:30:00"
  }
}

{
  "code": 123,
  "error": {
    "message": "<string>",
    "type": "<string>"
  }
}

{
  "code": 123,
  "error": {
    "message": "<string>",
    "type": "<string>"
  }
}

POST

api

generate

submit

curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "elevenlabs-music",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "text": "A polished instrumental cinematic game menu loop for a neon sci-fi strategy game, elegant synth arpeggios, warm analog pads, restrained percussion, gradual heroic lift, no vocals, seamless background score.",
    "duration": 45,
    "is_instrumental": true,
    "output_format": "opus_48000_128"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task_xxxxxxxxxxxxxxxx",
    "status": "not_started",
    "created_time": "2026-06-26T10:30:00"
  }
}

{
  "code": 123,
  "error": {
    "message": "<string>",
    "type": "<string>"
  }
}

{
  "code": 123,
  "error": {
    "message": "<string>",
    "type": "<string>"
  }
}

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 result through the unified Query Task Status endpoint.

ElevenLabs Music

elevenlabs-music generates music audio from a text or a structured composition plan. Results are returned as task files, matching the standard image, video, 3D, and audio task response structure.

Available Model

elevenlabs-music - ElevenLabs Music generation with text and composition-plan controls

Input Parameters

Provide exactly one creative control path:

Use text for a single text brief.
Use composition_plan for section-level arrangement control.
Do not send both text and composition_plan in the same request.

All supported input fields:

text: Text describing the music to generate. Required when composition_plan is not provided. Length: 1-4100 characters.
composition_plan: Structured composition plan. Required when text is not provided.
- positive_global_styles: String array of global styles to include.
- negative_global_styles: String array of global styles to avoid.
- sections: Non-empty array of music sections.
  - section_name: Section name, 1-100 characters.
  - positive_local_styles: String array of section-specific styles to include.
  - negative_local_styles: String array of section-specific styles to avoid.
  - duration: Section duration in seconds, 3-120. This public PoYo field uses seconds.
  - lines: Lyrics lines. Each line must be 200 characters or fewer.
duration: Optional song length in seconds. Must be 3-600 when provided. Only valid with text.
is_instrumental: When true, requests instrumental-only output. Only valid with text.
respect_sections_durations: Controls how strictly section durations are followed. Only valid with composition_plan.
output_format: Output format. Defaults to mp3_44100_128.

Output Formats

Supported output_format values: mp3_22050_32, mp3_44100_32, mp3_44100_64, mp3_44100_96, mp3_44100_128, mp3_44100_192, pcm_8000, pcm_16000, pcm_22050, pcm_24000, pcm_44100, pcm_48000, ulaw_8000, alaw_8000, opus_48000_32, opus_48000_64, opus_48000_96, opus_48000_128, opus_48000_192.

Credit Billing

Billing is calculated by started minute:

128 credits per started minute
Equivalent to $0.64 per started minute
Less than one minute is billed as one minute
Requests with text and no duration are estimated as one started minute in PoYo v1

Notes

Provide exactly one of text or composition_plan.
duration and is_instrumental can only be used with text.
respect_sections_durations can only be used with composition_plan.
Query status through the standard task status API, not the music detail endpoint.
Successful responses return files, where the generated music uses file_type: audio.

Authorizations

Authorization

string

header

required

All API endpoints require Bearer Token authentication.

Get your API Key from the API Key Management Page.

Add it to the request header:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

required

Model identifier.

Available options:

elevenlabs-music

Example:

"elevenlabs-music"

input

object

required

Input parameters. Provide exactly one of text or composition_plan.

Show child attributes

callback_url

string<uri>

Webhook callback URL for result notifications

Example:

"https://your-domain.com/callback"

Response

Task submitted successfully

code

integer

required

Example:

200

data

object

required

Show child attributes

Overview

Image Model

Video Model

Music Model

Chat Model

3D Model

Task Management

ElevenLabs Music

ElevenLabs Music

Available Model

Input Parameters

Output Formats

Credit Billing

Notes

Authorizations

Body

Response

​ElevenLabs Music

​Available Model

​Input Parameters

​Output Formats

​Credit Billing

​Notes

Authorizations

Body

Response

ElevenLabs Music

Available Model

Input Parameters

Output Formats

Credit Billing

Notes