메인 콘텐츠로 건너뛰기
POST
/api/v1/audio/queue
/audio/quote를 호출하여 비용을 추정한 다음, 생성이 완료될 때까지 반환된 queue_id/audio/retrieve를 폴링하세요. 검색 후 생성된 미디어를 보관하는 경우, 다운로드를 마친 뒤 /audio/complete를 호출하세요.

Postman 컬렉션

추가 예제는 이 Postman 컬렉션을 참조하세요.

인증

Authorization
string
header
필수

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

본문

application/json
model
string
필수

The model to use for audio generation.

예시:

"elevenlabs-music"

prompt
string
필수

The prompt describing the audio to generate. Minimum and maximum prompt lengths vary by model; inspect /models for min_prompt_length and prompt_character_limit.

Minimum string length: 1
예시:

"A warm spoken narration introducing a product launch."

lyrics_prompt
string

Optional lyrics/text for lyric-capable models. Required when /models reports lyrics_required=true; unsupported when /models reports supports_lyrics=false.

예시:

"Verse 1: Walking through the city lights..."

duration_seconds

Optional duration hint in seconds. Only supported for models that expose duration metadata via /models. Accepts either an integer or a numeric string. If omitted, the model default duration is used when available.

필수 범위: x > 0
예시:

60

force_instrumental
boolean

Optional instrumental toggle. Only supported when /models reports supports_force_instrumental=true.

예시:

false

lyrics_optimizer
boolean

When enabled, auto-generates lyrics from the prompt. Only supported when /models reports supports_lyrics_optimizer=true. lyrics_prompt must be empty when this is true.

예시:

false

voice
string

Optional voice selection for voice-enabled models. See /models?type=music for the model's supported voices and default_voice.

예시:

"Aria"

language_code
string

Optional ISO 639-1 language code. Only supported when /models reports supports_language_code=true.

예시:

"en"

speed
number

Optional audio speed multiplier. Only supported when /models reports supports_speed=true; use the model-specific min_speed and max_speed values.

필수 범위: 0.25 <= x <= 4
예시:

1

응답

Audio generation request queued successfully

model
string
필수

The ID of the model used for audio generation.

예시:

"elevenlabs-music"

queue_id
string
필수

The ID of the audio generation request. Use this to poll for status and retrieve the result.

예시:

"123e4567-e89b-12d3-a456-426614174000"

status
enum<string>
필수

The status of the audio generation request.

사용 가능한 옵션:
QUEUED
예시:

"QUEUED"