/v1/audio/speechCreate speech
Text to speech. The response body is the audio file itself, in response_format (default mp3). No streaming, no usage.cost in the response; the call settles in your usage history.
認証: AuthorizationヘッダーにBearer形式のAPIキー
リクエストボディ
modelstring必須A text-to-speech model slug.
inputstring必須The text to speak.
voicestring | object必須A voice name, or
{"id": "..."}. ElevenLabs models take their own voice id or one of alloy, echo, fable, onyx, nova, shimmer.いずれか
object
idstring
instructionsstringDelivery instructions, where the model supports them.
response_formatenumspeednumberPlayback speed. ElevenLabs models accept 0.7 to 1.2.
レスポンス
200The audio bytes. Content-Type follows the format, for example audio/mpeg for mp3.
400Invalid request. param names the field; code says why (invalid_parameter, unsupported_parameter, unsupported_capability, refusal, previous_response_not_found). Not charged.
レスポンス
errorobjecterror
messagestringWhat went wrong and how to fix it.
typestringFor example
invalid_request_error,authentication_error,permission_error,rate_limit_error,insufficient_quota,api_error.codestringThe stable error code.
paramstring | nullThe request field at fault, when there is one.
refusal_reasonenumPresent only on
code: refusal.
401The key is missing, malformed, expired or revoked.
レスポンス
errorobjecterror
messagestringWhat went wrong and how to fix it.
typestringFor example
invalid_request_error,authentication_error,permission_error,rate_limit_error,insufficient_quota,api_error.codestringThe stable error code.
paramstring | nullThe request field at fault, when there is one.
refusal_reasonenumPresent only on
code: refusal.
402The organization must act first: card_required, email_unverified, org_under_review, free_tier_requires_payment or promotion_ended. The message names the step; retrying does not help.
レスポンス
errorobjecterror
messagestringWhat went wrong and how to fix it.
typestringFor example
invalid_request_error,authentication_error,permission_error,rate_limit_error,insufficient_quota,api_error.codestringThe stable error code.
paramstring | nullThe request field at fault, when there is one.
refusal_reasonenumPresent only on
code: refusal.
429insufficient_quota (out of credits, over a spend limit, or the model needs a purchase) and promo_credits_now (a free promotion is used up): add credits, the message names the step. rate_limit_exceeded, free_limit_reached, admission_capacity_exceeded: wait Retry-After seconds and retry.
レスポンス
errorobjecterror
messagestringWhat went wrong and how to fix it.
typestringFor example
invalid_request_error,authentication_error,permission_error,rate_limit_error,insufficient_quota,api_error.codestringThe stable error code.
paramstring | nullThe request field at fault, when there is one.
refusal_reasonenumPresent only on
code: refusal.
リクエスト
curl https://api.experientiallabs.ai/v1/audio/speech \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-4o-mini-tts", "input": "Your build passed.", "voice": "alloy"}' \
--output speech.mp3
レスポンス
stringhttps://api.experientiallabs.ai/v1/audio/speech