platform-api

Generate speech with a frozen price and one provider submission; Idempotency-Key required

post/v1/speech

Request

  • Base URL: https://api.cuddler.ai
  • URL: https://api.cuddler.ai/v1/speech
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Required. One key per logical request (e.g. ep03-shot042-take1), never reusable: the same key and body answer with the original object and Idempotent-Replayed: true; the same key with a different body is 409 (and so is any reuse once the job's request trace was removed, 180 days after it finished).

Request body

model'elevenlabs-v4' | 'elevenlabs-v4-turbo' | 'elevenlabs-flash-v2.5' | 'fish-s2.1-pro' | 'gemini-3.8-flash-tts' | 'gemini-3.8-flash-lite-tts' | 'minimax-speech-2.8-hd' | 'minimax-speech-2.8-turbo' required
textstring
voice_idstring
output_format'mp3'
max_usdstring

Maximum USD this job may charge; creation refuses a larger hold and settlement never exceeds this ceiling

webhook_urlstring uri
metadataobject

Response

Idempotent replay

object'speech' required
idstring required
model'elevenlabs-v4' | 'elevenlabs-v4-turbo' | 'elevenlabs-flash-v2.5' | 'fish-s2.1-pro' | 'gemini-3.8-flash-tts' | 'gemini-3.8-flash-lite-tts' | 'minimax-speech-2.8-hd' | 'minimax-speech-2.8-turbo' required
status'queued' | 'running' | 'succeeded' | 'failed' | 'canceled' required
created_atstring required
started_atstring nullable required
completed_atstring nullable required
queue_positioninteger nullable required
price_versionstring required
api_key_idstring required
metadataobject required

Changes

No recorded changes to this operation across all 1 revision of this API.