Sats4AI - Bitcoin-Powered AI Tools

{'type': 'object', 'required': ['paymentId', 'phoneNumber', 'task'], 'properties': {'task': {'type': 'string', 'description': 'Instructions for the AI agent (what to say, ask, or accomplish)'}, 'language': {'enum': ['en-US', 'en-GB', 'es-ES', 'fr-FR', 'de-DE', 'ja-JP', 'zh-CN', 'multi'], 'type': 'string', 'description': "Language the agent should speak to the called party. Pass this when you know the destination's preferred language (e.g. calling a French pizzeria → fr-FR, a Japanese restaurant → ja-JP). If omitted, we guess from the destination country: +33 → fr-FR, +49 → de-DE, +34 → es-ES, etc. Bilingual regions (Canada, Belgium, Switzerland, Singapore) and unknown countries default to en-US — override explicitly when you need a non-English language in those regions. Voice is auto-selected per language."}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'phoneNumber': {'type': 'string', 'description': 'Phone number in E.164 format (e.g., +14155550100)'}, 'beginMessage': {'type': 'string', 'description': 'Optional opening line for the agent'}, 'durationMinutes': {'type': 'number', 'description': 'Max call duration 1-10 minutes (default: 3)'}}}

{'type': 'object', 'required': ['paymentId', 'prompt', 'imageBase64'], 'properties': {'prompt': {'type': 'string', 'description': 'Question or analysis prompt for the image'}, 'modelId': {'type': 'number', 'description': 'Optional. Omit for default model.'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'imageBase64': {'type': 'string', 'description': 'Base64 encoded image to analyze. Single images only — for PDFs or multi-page document text use extract_document (a PDF sent here is treated as an image and may return a wrong/hallucinated result with no error).'}}}

{'type': 'object', 'required': ['paymentId', 'prompt', 'imageBase64', 'duration'], 'properties': {'prompt': {'type': 'string', 'description': 'Text prompt describing the animation'}, 'modelId': {'type': 'number', 'description': 'Optional. Omit for default model.'}, 'duration': {'type': 'number', 'maximum': 15, 'minimum': 5, 'description': 'Duration in seconds (5-15)'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'resolution': {'enum': ['768p', '2K', '480p', '720p', '1080p'], 'type': 'string', 'default': '768p', 'description': 'Output resolution: 768p or 2K (2K is upscaled from a 768p render). Omitting it yields 768p — if you quoted 2K at create_payment, send it here too or you will be billed 2K and rendered 768p. Retired rungs still accepted: 480p/720p→768p, 1080p→2K.'}, 'imageBase64': {'type': 'string', 'description': 'Base64 encoded image to animate'}}}

{'type': 'object', 'required': ['requestId', 'jobType'], 'properties': {'jobType': {'enum': ['video', 'video-image', 'video-fal-standard', 'video-fal-pro', 'image-3d', 'transcription', 'transcribe-translate', 'translate-epub', 'epub-audiobook', 'ai-call'], 'type': 'string', 'description': 'Must match the async tool that returned requestId.'}, 'requestId': {'type': 'string', 'description': 'The requestId returned by the async tool.'}}}

{'type': 'object', 'required': ['paymentId'], 'properties': {'documents': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Base64 boarding passes, one per file (up to 8), for a family/booking. Provide this OR documentBase64 (at least one required).'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid). Price = 100 × number of passes.'}, 'documentBase64': {'type': 'string', 'description': 'Base64 boarding pass PDF or screenshot (max 8MB). Single-file convenience form. Must contain a readable BCBP barcode — a blurry photo or non-boarding-pass is refunded, not converted.'}}}

{'type': 'object', 'required': ['requestId', 'jobType'], 'properties': {'jobType': {'enum': ['video', 'video-image', 'video-fal-standard', 'video-fal-pro', 'image-3d', 'transcription', 'transcribe-translate', 'translate-epub', 'epub-audiobook', 'ai-call'], 'type': 'string', 'description': 'Must match the async tool: video=generate_video, video-image=animate_image, image-3d=generate_3d_model, transcription=transcribe_audio, epub-audiobook=epub_to_audiobook, ai-call=ai_call. video-fal-standard/video-fal-pro = the FAL fallback jobType generate_video returns when Replicate is at capacity.'}, 'requestId': {'type': 'string', 'description': 'The requestId returned by the async tool (e.g., from generate_video, animate_image, generate_3d_model, transcribe_audio, epub_to_audiobook, ai_call)'}}}

{'type': 'object', 'required': ['paymentId'], 'properties': {'paymentId': {'type': 'string', 'description': 'The paymentId returned by create_payment'}}}

{'type': 'object', 'required': ['paymentId', 'voiceFileUrl', 'consent'], 'properties': {'model': {'enum': ['speech-02-turbo', 'speech-02-hd'], 'type': 'string', 'default': 'speech-02-turbo', 'description': 'Voice model: turbo (faster) or hd (higher quality)'}, 'consent': {'type': 'boolean', 'description': "Required. Set true to attest that you own this voice or have the speaker's permission to clone it. Cloning a voice to impersonate someone is prohibited (sats4ai.com/terms)."}, 'accuracy': {'type': 'number', 'default': 0.7, 'description': 'Text validation accuracy 0-1 (default 0.7)'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'voiceFileUrl': {'type': 'string', 'description': 'Public URL to audio file of the voice to clone. MP3, M4A or WAV, 10 seconds to 5 minutes, 20 MB max. One speaker, no background music.'}}}

{'type': 'object', 'required': ['paymentId', 'imageBase64'], 'properties': {'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'model_size': {'enum': ['tiny', 'large'], 'type': 'string', 'description': "Model variant: 'large' (best quality) or 'tiny' (faster). Default: large"}, 'imageBase64': {'type': 'string', 'description': 'Base64-encoded grayscale or B&W image (PNG, JPEG) or data URI'}}}

{'type': 'object', 'required': ['sessionId'], 'properties': {'answers': {'type': 'object', 'description': 'Key-value answers to the push-back questions (keys are the question strings, values are your answers). Omit to confirm the task as-is.', 'additionalProperties': {'type': 'string'}}, 'sessionId': {'type': 'string', 'description': 'Session ID from the ai_call response'}}}

{'type': 'object', 'required': ['paymentId', 'extensionFrom', 'extensionTo'], 'properties': {'fileUrl': {'type': 'string', 'description': 'Public URL to the file (provide this OR fileBase64)'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'fileBase64': {'type': 'string', 'description': 'Base64-encoded file (provide this OR fileUrl)'}, 'extensionTo': {'type': 'string', 'description': "Target format without dot (e.g., 'pdf', 'docx')"}, 'extensionFrom': {'type': 'string', 'description': "Source format without dot (e.g., 'pdf', 'docx')"}}}

{'type': 'object', 'required': ['paymentId', 'html'], 'properties': {'html': {'type': 'string', 'description': 'HTML or Markdown content to convert'}, 'format': {'enum': ['html', 'markdown'], 'type': 'string', 'default': 'html', 'description': 'Input format (default: html)'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}}}

{'type': 'object', 'required': ['toolName'], 'properties': {'ocr': {'type': 'boolean', 'description': 'For receive_fax: include the OCR text-extraction add-on (+200 sats). Must be set HERE at payment time — receive_fax refuses ocr=true at execution unless the charge covered it.'}, 'mode': {'enum': ['standard', 'pro'], 'type': 'string', 'description': "Legacy alias for generate_video: 'standard'→768p, 'pro'→2K. Prefer 'resolution'."}, 'text': {'type': 'string', 'description': 'Required for text_to_speech: the exact text to synthesize (price is per-character by tier, locked to payment)'}, 'prompt': {'type': 'string', 'description': 'Required for generate_text: the exact prompt (price calculated from char count, locked to payment)'}, 'message': {'type': 'string', 'description': 'Required for send_sms: message text (max 1544 chars; billed per SMS segment, so longer or accented messages cost more)'}, 'modelId': {'type': 'number', 'description': 'Optional. AI model ID from list_models. Omit for default (best) model.'}, 'duration': {'type': 'number', 'description': 'Required for generate_video / animate_image: duration in seconds (5-15)'}, 'quantity': {'type': 'number', 'description': 'Units to pay for when the price scales: passes for boardingpass_wallet, pages for extract_document / extract_receipt / send_fax. Default 1 — under-counting is rejected at execution with the exact price to re-pay.'}, 'toolName': {'type': 'string', 'description': "Tool name to pay for (e.g., 'generate_text', 'generate_image', 'generate_video', 'send_sms', 'place_call')"}, 'resolution': {'enum': ['768p', '2K', '480p', '720p', '1080p', '1K', '4K'], 'type': 'string', 'description': '768p (default) or 2K for generate_video / animate_image — priced by resolution × duration, native audio free; 2K is upscaled from a 768p render. 480p/720p/1080p are retired Seedance rungs, still accepted (480p/720p→768p, 1080p→2K). For edit_image: a flat 200 sats per edit, so resolution does not change the price.'}, 'fileContext': {'type': 'string', 'description': 'For generate_text: include extracted file text if attaching a file (affects price)'}, 'phoneNumber': {'type': 'string', 'description': 'Required for send_sms and place_call: phone in E.164 format (e.g., +14155550100)'}, 'systemPrompt': {'type': 'string', 'description': 'For generate_text: include if using a custom system prompt (affects price)'}, 'characterCount': {'type': 'number', 'description': 'Required for epub_to_audiobook: total text characters in the book (price is per-character by voice tier, minimum 500 sats). Send the count, not the book — the file goes to epub_to_audiobook itself. Execution re-derives the price from the real file and rejects a short-pay with the exact amount to re-pay.'}, 'generate_audio': {'type': 'boolean', 'description': 'Accepted and IGNORED — H3 audio is native and always on, at no extra cost. There is no way to request a silent render.'}, 'durationMinutes': {'type': 'number', 'description': 'Minutes of audio/call. Required for place_call with audioUrl (1-30); for transcribe_audio / transcribe_translate it sets the per-minute price (10 sats/min) — declare your audio length (default 1). Audio longer than paid is rejected + refunded at execution.'}}}

{'type': 'object', 'required': ['paymentId', 'imageBase64'], 'properties': {'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'task_type': {'enum': ['Image Debluring (GoPro)', 'Image Debluring (REDS)', 'Image Denoising'], 'type': 'string', 'description': "'Image Debluring (GoPro)' for camera shake (default), 'Image Debluring (REDS)' for video frame blur, 'Image Denoising' for grain/noise"}, 'imageBase64': {'type': 'string', 'description': 'Base64-encoded blurry image (PNG, JPEG, WEBP) or data URI'}}}

{'type': 'object', 'required': ['paymentId', 'imageBase64'], 'properties': {'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'imageBase64': {'type': 'string', 'description': 'Base64-encoded image (PNG, JPEG, WEBP) or data URI'}}}

{'type': 'object', 'required': ['paymentId', 'imageBase64', 'query'], 'properties': {'query': {'type': 'string', 'description': "Comma-separated object names to detect (e.g. 'cat, dog, person')"}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'imageBase64': {'type': 'string', 'description': 'Base64-encoded image (PNG, JPEG, WEBP) or data URI'}, 'box_threshold': {'type': 'number', 'description': 'Confidence threshold for detection boxes (0-1, default 0.25)'}, 'text_threshold': {'type': 'number', 'description': 'Confidence threshold for text matching (0-1, default 0.25)'}}}

{'type': 'object', 'required': ['paymentId', 'prompt', 'imageBase64'], 'properties': {'prompt': {'type': 'string', 'description': 'Editing instructions describing what to change'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'resolution': {'enum': ['1K', '2K', '4K'], 'type': 'string', 'default': '1K', 'description': 'Ignored: MAI-Image-2.6 has no resolution setting. Accepted for compatibility; every edit is 200 sats.'}, 'aspectRatio': {'enum': ['match_input_image', 'auto', '1:1', '4:3', '3:4', '16:9', '9:16', '3:2', '2:3'], 'type': 'string', 'default': 'match_input_image', 'description': "Output aspect ratio (default: match_input_image, which keeps the input's shape)"}, 'imageBase64': {'type': 'string', 'description': 'Base64 encoded image to edit'}, 'outputFormat': {'enum': ['jpg', 'png', 'webp'], 'type': 'string', 'default': 'jpg', 'description': 'Output format'}, 'returnBase64': {'type': 'boolean', 'default': False, 'description': 'Also return the edited image as a base64 data URL (base64Image). Default false: imageUrl is the deliverable and the base64 copy is megabytes of context.'}}}

{'type': 'object', 'required': ['sessionId'], 'properties': {'sessionId': {'type': 'string', 'description': 'Session ID from open_voice_bridge'}}}

{'type': 'object', 'required': ['paymentId', 'epubBase64', 'fileName'], 'properties': {'speed': {'type': 'number', 'default': 1, 'description': 'Speech speed 0.5-2.0'}, 'voice': {'type': 'string', 'description': "Voice ID. Must belong to the resolved tier's own voice set — Minimax: English_expressive_narrator, Wise_Woman, Deep_Voice_Man; Inworld: Ashley, Abby. OMIT to get a valid default for whichever tier is used. Ashley is Inworld-ONLY and is rejected on the Minimax tier. On the OmniVoice tier, voice is a voice design instead: words, one per group, separated by commas: male|female; child|teenager|young adult|middle-aged|elderly; very low|low|moderate|high|very high pitch; whisper; american|british|australian|canadian|indian|chinese|korean|japanese|portuguese|russian accent. Omit it for OmniVoice's default voice. Any other word is refused, and the payment stays unused."}, 'modelId': {'type': 'number', 'description': 'Optional. 3 voice tiers: OmniVoice Global (602+ langs), Inworld Premium (#1 ranked), Minimax Studio (voice clone). Omit for default.'}, 'fileName': {'type': 'string', 'description': "Original filename with extension (e.g., 'mybook.epub', 'document.pdf', 'story.txt'). Required to detect format."}, 'language': {'type': 'string', 'default': 'English', 'description': "Narration language (e.g., English, Spanish, French). NOTE: on the default tier this only affects chapter titles / number expansion — the spoken language comes from the chosen voice. For non-English narration pick a voice whose language matches else it narrates in the voice's own (usually English) accent with no error. translateToLanguage is different: it is checked against the voice tier BEFORE payment, and a tier that cannot speak the target is refused with the tier that can."}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'epubBase64': {'type': 'string', 'description': 'Base64-encoded book file (EPUB, PDF, or TXT)'}, 'translateToLanguage': {'type': 'string', 'description': "Translate book to this language before narration. Accepts English names ('Spanish', 'Chinese (Simplified)') or ISO-639 codes / locale tags ('es', 'en-US', 'pt-BR'). Cost added to price."}, 'selectedChapterIndices': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Chapter indices to include (0-based). Omit to auto-select content chapters. NOTE: auto-select drops front/back matter heuristically and can silently exclude a short (<200 char) wanted chapter near the start/end — pass explicit indices if you need a specific set.'}}}

{'type': 'object', 'required': ['paymentId', 'documentBase64', 'signers', 'customerEmail'], 'properties': {'note': {'type': 'string', 'description': 'Optional note shown to the signers.'}, 'signers': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'email'], 'properties': {'name': {'type': 'string'}, 'email': {'type': 'string'}}}, 'description': '1-3 signers, each with a name and email.'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid). Price = 1000 sats flat.'}, 'customerEmail': {'type': 'string', 'description': 'Your email — the signed copy is sent here once everyone has signed.'}, 'documentBase64': {'type': 'string', 'description': 'Base64-encoded PDF to be signed (a data: URI is accepted). Max 8MB. Must be a PDF.'}}}

{'type': 'object', 'required': ['paymentId', 'imageBase64'], 'properties': {'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'model_size': {'enum': ['Small', 'Base', 'Large'], 'type': 'string', 'description': 'Model size — larger is more accurate, price is the same (default Large)'}, 'imageBase64': {'type': 'string', 'description': 'Base64-encoded image (PNG, JPEG, WEBP) or data URI'}}}

{'type': 'object', 'required': ['paymentId', 'documentBase64'], 'properties': {'modelId': {'type': 'number', 'description': 'Optional. Omit for default model.'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'documentBase64': {'type': 'string', 'description': 'Base64 encoded PDF or image'}}}

{'type': 'object', 'required': ['paymentId', 'documentBase64'], 'properties': {'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'documentBase64': {'type': 'string', 'description': 'Base64 encoded receipt/invoice image or PDF. NOTE: any text-bearing document is accepted — a non-receipt returns best-guess (possibly fabricated) merchant/total/line-item JSON with no error. Confirm the input really is a receipt before trusting the fields.'}}}

{'type': 'object', 'required': ['paymentId'], 'properties': {'prompt': {'type': 'string', 'description': 'Text description for text-to-3D (max 1024 chars). Provide EITHER this OR imageBase64, not both.'}, 'modelId': {'type': 'number', 'description': 'Optional. Omit for default model.'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'imageBase64': {'type': 'string', 'description': 'Base64 encoded image (PNG, JPEG, or WEBP) for image-to-3D. Provide EITHER this OR prompt, not both.'}}}

{'type': 'object', 'required': ['paymentId', 'prompt'], 'properties': {'prompt': {'type': 'string', 'description': 'Text prompt describing the image'}, 'modelId': {'type': 'number', 'description': 'Optional. Omit for default (best) model.'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'aspectRatio': {'enum': ['1:1', '16:9', '9:16', '4:3', '3:4', '3:2', '2:3'], 'type': 'string', 'description': 'Optional output shape, default 1:1. Same price for every shape.'}, 'imageBase64': {'type': 'string', 'description': 'Optional base64 image for img2img generation'}}}

{'type': 'object', 'required': ['paymentId', 'prompt'], 'properties': {'lyrics': {'type': 'string', 'description': 'Song lyrics with section tags (up to 3,500 chars). Each tag on its OWN line, words on the lines after it — words sharing a line with a tag are dropped. Tags: [intro], [verse], [pre-chorus], [chorus], [post-chorus], [bridge], [instrumental], [solo], [outro]. Send only tags and no words for an instrumental.'}, 'prompt': {'type': 'string', 'description': "Music style with BPM, key, genre, mood, instruments (up to 2,000 chars). Example: 'E minor, 90 BPM, acoustic guitar ballad, male vocal'"}, 'modelId': {'type': 'number', 'description': 'Optional. Omit for default model.'}, 'duration': {'type': 'integer', 'description': 'Song length in seconds, 15-300. THE PRICE (5 sats/second) — must match the duration sent to create_payment. Default: 15'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'lyricsAbout': {'type': 'string', 'description': 'Optional, with lyricsAddon: what the lyrics should be about. Omit and the subject is inferred from your music prompt.'}, 'lyricsAddon': {'type': 'boolean', 'description': "Set true to have the lyrics written for you (+25 sats, billed on the song's own invoice). Must also be sent to create_payment."}}}

{'type': 'object', 'required': ['paymentId', 'prompt'], 'properties': {'prompt': {'type': 'string', 'description': 'The text prompt or question'}, 'modelId': {'type': 'number', 'description': 'Optional. Omit for default (best) model.'}, 'fileName': {'type': 'string', 'description': 'Name of the attached file'}, 'maxTokens': {'type': 'number', 'default': 16384, 'description': 'Max tokens in response'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'fileContext': {'type': 'string', 'description': 'Extracted file text to include as context'}, 'imageBase64': {'type': 'string', 'description': 'Base64 data URI for vision analysis (best model only)'}, 'systemPrompt': {'type': 'string', 'description': 'Optional system prompt'}}}

{'type': 'object', 'required': ['paymentId', 'prompt', 'duration'], 'properties': {'prompt': {'type': 'string', 'description': 'Text prompt describing the video'}, 'modelId': {'type': 'number', 'description': 'Optional. Omit for default model.'}, 'duration': {'type': 'number', 'maximum': 15, 'minimum': 5, 'description': 'Duration in seconds (5-15)'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'resolution': {'enum': ['768p', '2K', '480p', '720p', '1080p'], 'type': 'string', 'default': '768p', 'description': 'Output resolution: 768p or 2K (2K is upscaled from a 768p render). Omitting it yields 768p — ask for 2K explicitly, and quote it at create_payment too. Retired rungs still accepted: 480p/720p→768p, 1080p→2K.'}, 'generate_audio': {'type': 'boolean', 'description': 'Accepted and IGNORED — H3 audio is native and always on, at no extra cost. There is no way to request a silent render.'}, 'reference_audio': {'type': 'string', 'description': 'Optional https URL(s) of reference audio CLIPS, 2-15 seconds each (max 3, combined <=15s). Cite them in your prompt as "Audio 1", "Audio 2" or the model has no instruction to use them. ⚠ Audio cannot be sent alone — at least one reference_image must accompany it. For a music video, slice your track and pass one slice per shot. Free: does not change the price.'}, 'reference_image': {'type': 'string', 'description': 'Optional https URL of a reference still for character/style consistency across shots (accepts an array, max 3). Pass the URL from generate_image. Free: does not change the price.'}}}

{'type': 'object', 'required': [], 'properties': {'chars': {'type': 'number', 'description': 'Character count — required for TTS and translate'}, 'model': {'type': 'string', 'description': 'Optional model id for services with multiple tiers'}, 'pages': {'type': 'number', 'description': 'Page count — for OCR (default 1)'}, 'minutes': {'type': 'number', 'description': 'Audio length — required for transcribe-audio'}, 'seconds': {'type': 'number', 'description': 'Video duration — required for video / video-from-image'}, 'service': {'type': 'string', 'description': "Service id (e.g. 'text-to-speech', 'translate', 'image', 'video', 'transcribe-audio', 'ocr'). Omit to list all services."}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'required': ['requestId', 'jobType'], 'properties': {'jobType': {'enum': ['video', 'video-image', 'video-fal-standard', 'video-fal-pro', 'image-3d', 'transcription', 'transcribe-translate', 'translate-epub', 'epub-audiobook', 'ai-call'], 'type': 'string', 'description': 'Must match the async tool: video=generate_video, video-image=animate_image, image-3d=generate_3d_model, transcription=transcribe_audio, epub-audiobook=epub_to_audiobook, ai-call=ai_call. video-fal-standard/video-fal-pro = the FAL fallback jobType generate_video returns when Replicate is at capacity.'}, 'paymentId': {'type': 'string', 'description': 'The paymentId that bought this job. On a failed job the refund is opened either way; the claim link (lnurl_withdraw / refund_secret) is returned only when this matches — or call check_payment_status(paymentId).'}, 'requestId': {'type': 'string', 'description': 'The requestId returned by the original async tool — same ID used with check_job_status'}}}

{'type': 'object', 'required': ['modelId'], 'properties': {'modelId': {'type': ['number', 'string'], 'description': 'The AI model database ID from list_models. A numeric string ("16") is accepted and coerced.'}}}

{'type': 'object', 'required': [], 'properties': {'category': {'enum': ['generate_text', 'generate_image', 'generate_video', 'animate_image', 'generate_music', 'text_to_speech', 'transcribe_audio', 'analyze_image', 'generate_3d_model', 'extract_document', 'convert_file', 'send_sms', 'place_call', 'ai_call', 'send_email', 'clone_voice', 'edit_image', 'merge_pdfs', 'convert_html_to_pdf', 'render_card', 'translate_text', 'extract_receipt', 'epub_to_audiobook', 'remove_background', 'upscale_image', 'restore_face', 'detect_nsfw', 'detect_objects', 'remove_object', 'colorize_image', 'deblur_image', 'estimate_depth'], 'type': 'string', 'description': 'Filter by service category (matches tool names)'}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'required': ['paymentId', 'files'], 'properties': {'files': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Array of base64-encoded PDF files (minimum 2)'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}}}

{'type': 'object', 'required': ['paymentId', 'question', 'language'], 'properties': {'model': {'type': 'string', 'description': 'Standard | Better | Best. Best is Kimi K3 and costs materially more. Must match the create_payment quote.'}, 'language': {'type': 'string', 'description': "Language to answer in. English name ('Igbo'), ISO-639 code ('ig'), or a rare-language code ('wal'). Rejected before payment if unsupported."}, 'question': {'type': 'string', 'description': 'Your question, in your own language. Max 4000 characters.'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid), quoted for THIS language and tier.'}}}

{'type': 'object', 'required': ['paymentId', 'phoneNumber'], 'properties': {'codec': {'enum': ['PCMU', 'L16_16000'], 'type': 'string', 'description': 'PCMU 8kHz (default, universal) or L16_16000 for HD voice when both endpoints support it'}, 'greeting': {'type': 'string', 'description': 'Spoken the instant the callee answers (max 500 chars). Synthesized while the phone rings, so there is no pause before the first word — without it the callee hears silence until your first voice_bridge_say lands. Strongly recommended for any call a human answers.'}, 'language': {'type': 'string', 'description': 'BCP-47 language tag (default en-US). See /api/l402/voice-bridge/coverage for the matrix.'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID from create_payment (toolName=voice_bridge_open)'}, 'sttEnabled': {'type': 'boolean', 'description': 'Default true. Set false for TTS-only broadcast calls.'}, 'ttsEnabled': {'type': 'boolean', 'description': 'Default true. Set false to bring-your-own-audio via voice_bridge_say.'}, 'phoneNumber': {'type': 'string', 'description': 'Destination phone number in E.164 format (e.g., +14155550100)'}, 'refundAddress': {'type': 'string', 'description': 'Lightning address (e.g. you@wallet.com). Strongly recommended: the unused deposit is sent here automatically when the call ends, so nobody has to claim anything. Without it the refund waits as an LNURL-withdraw link.'}, 'durationMinutes': {'type': 'number', 'description': 'Deposit for N minutes, 2-30 (default 3). Unused time refunded.'}}}

{'type': 'object', 'required': ['paymentId', 'phoneNumber'], 'properties': {'message': {'type': 'string', 'description': 'Text to speak via TTS; must fit prepaid minutes including the closing spoken notice (about 12 s). Provide this OR audioUrl.'}, 'audioUrl': {'type': 'string', 'description': 'Public URL to audio file. Provide this OR message.'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'phoneNumber': {'type': 'string', 'description': 'Phone number in E.164 format (e.g., +14155550100)'}, 'durationMinutes': {'type': 'number', 'description': 'Duration in minutes (1-30). Required for audioUrl.'}}}

{'type': 'object', 'required': ['sessionId'], 'properties': {'cursor': {'type': 'number', 'description': 'Last seq number seen (default 0 = start from beginning)'}, 'sessionId': {'type': 'string', 'description': 'Session ID from open_voice_bridge'}}}

{'type': 'object', 'required': ['paymentId', 'email', 'fromNumber'], 'properties': {'ocr': {'type': 'boolean', 'description': 'Add OCR text extraction (+200 sats). Default: false.'}, 'email': {'type': 'string', 'description': 'Email address to deliver the fax PDF to'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'fromNumber': {'type': 'string', 'description': 'Expected sender fax number in E.164 format (matched by last 10 digits of caller ID)'}, 'callback_id': {'type': 'string', 'description': 'Optional opaque correlation string (max 128 chars). Echoed in the webhook body.'}, 'callback_url': {'type': 'string', 'description': 'Optional HTTPS webhook URL. POSTed (HMAC-signed) when fax is delivered. Public HTTPS only — no loopback/RFC1918.'}}}

{'type': 'object', 'required': ['paymentId', 'imageBase64'], 'properties': {'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'imageBase64': {'type': 'string', 'description': 'Base64-encoded image (PNG, JPEG, WEBP) or data URI'}}}

{'type': 'object', 'required': ['paymentId', 'imageBase64', 'query'], 'properties': {'query': {'type': 'string', 'description': "What to remove (e.g. 'person', 'car', 'watermark', 'text')"}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'imageBase64': {'type': 'string', 'description': 'Base64-encoded image (PNG, JPEG, WEBP) or data URI'}, 'box_threshold': {'type': 'number', 'description': 'Detection confidence threshold (0-1, default 0.25)'}, 'text_threshold': {'type': 'number', 'description': 'Text matching threshold (0-1, default 0.25)'}}}

{'type': 'object', 'required': ['paymentId', 'variant'], 'properties': {'sub': {'type': 'string', 'description': 'stat: small line above the number, e.g. a year'}, 'left': {'type': 'string', 'description': 'versus: left value (up to 22 chars)'}, 'size': {'enum': ['1920x1080', '2560x1440'], 'type': 'string', 'default': '1920x1080', 'description': 'Output size (default 1920x1080)'}, 'text': {'type': 'string', 'description': 'quote: the quoted words (up to 30 chars)'}, 'items': {'type': 'array', 'items': {'type': 'string'}, 'description': 'list: 1-6 items, each up to 40 chars; the last revealed item is drawn in the accent colour'}, 'label': {'type': 'string', 'description': 'stat: caption under the number (up to 60 chars)'}, 'lines': {'type': 'array', 'items': {'type': 'string'}, 'description': 'headline: 1-3 lines, each up to 40 characters'}, 'right': {'type': 'string', 'description': 'versus: right value, drawn in the accent colour'}, 'theme': {'type': 'object', 'properties': {'muted': {'type': 'string'}, 'accent': {'type': 'string'}, 'background': {'type': 'string'}, 'foreground': {'type': 'string'}}, 'description': 'Optional hex colours: background, foreground, accent, muted (default: near-black ground, Bitcoin-orange accent)'}, 'title': {'type': 'string', 'description': 'list: small caps title (up to 40 chars)'}, 'value': {'type': 'string', 'description': "stat: the big number (up to 12 chars), e.g. '34 Md $'"}, 'format': {'enum': ['png', 'jpg'], 'type': 'string', 'default': 'png', 'description': 'Output format (default png)'}, 'source': {'type': 'string', 'description': 'quote: attribution line (up to 60 chars)'}, 'variant': {'enum': ['headline', 'versus', 'list', 'stat', 'quote'], 'type': 'string', 'description': 'Card layout'}, 'revealed': {'type': 'integer', 'description': 'list: how many items are shown (default all) — render 1..N for a beat-by-beat reveal'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'left_label': {'type': 'string', 'description': 'versus: small label over the left value (up to 28 chars)'}, 'show_right': {'type': 'boolean', 'description': 'versus: false renders the left column only (first beat of a two-state reveal)'}, 'accent_line': {'type': 'integer', 'description': 'headline: index of the line drawn in the accent colour'}, 'right_label': {'type': 'string', 'description': 'versus: small label over the right value'}}}

{'type': 'object', 'required': ['paymentId', 'invoice'], 'properties': {'email': {'type': 'string', 'description': 'Optional email address for follow-up'}, 'invoice': {'type': 'string', 'description': 'Lightning address (e.g., user@wallet.com) or bolt11 invoice for the refund'}, 'feedback': {'type': 'string', 'description': 'Optional description of what went wrong (max 2000 chars)'}, 'paymentId': {'type': 'string', 'description': 'The payment ID from a failed service call'}}}

{'type': 'object', 'required': ['paymentId', 'imageBase64'], 'properties': {'upscale': {'type': 'number', 'description': 'Output upscale factor 1-4 (default 2)'}, 'fidelity': {'type': 'number', 'description': 'Fidelity to input: 0.0 = max quality enhancement, 1.0 = max identity preservation (default 0.5)'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'imageBase64': {'type': 'string', 'description': 'Base64-encoded image containing faces (PNG, JPEG, WEBP) or data URI'}, 'face_upsample': {'type': 'boolean', 'description': 'Upsample restored faces (default true)'}, 'background_enhance': {'type': 'boolean', 'description': 'Also enhance the background (default true)'}}}

{'type': 'object', 'required': ['paymentId', 'to', 'subject', 'body'], 'properties': {'to': {'type': 'string', 'description': 'Recipient email address'}, 'body': {'type': 'string', 'description': 'Email body text (plain text, max 10,000 characters)'}, 'replyTo': {'type': 'string', 'description': 'Optional reply-to email address'}, 'subject': {'type': 'string', 'description': 'Email subject (max 200 characters)'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid) No impersonation, scams, threats, harassment, credential theft, unsolicited bulk messages, or contact after an opt-out. Answering a call does not establish consent. We screen requests after payment. Held messages and calls are not sent or placed; payment is retained during review, not refunded immediately. Confirmed violations are not refunded. Unresolved communication holds become eligible for a refund after 24 hours; refund eligibility is processed by scheduled maintenance. Human review costs 1 sat at https://sats4ai.com/appeal. Recent message text and extracts of recording transcripts support recipient-scoped abuse checks for 24 hours. These context records are deleted hourly, so storage can last up to 25 hours. Original uploaded-call transcripts and raw held-request or appeal evidence enter cleanup after 30 days. We also keep a de-identified record of screened communications to measure and improve fraud detection. Identifiers in it — contact addresses, numbers and names that follow a greeting — are replaced with one-way tokens, and it holds no destination number and no account, because the service has none. De-identification is not anonymization: text a sender wrote can still identify someone. Do not submit personal information the service does not need. Providers keep records under their own policies.'}}}

{'type': 'object', 'required': ['paymentId', 'phoneNumber', 'mode'], 'properties': {'mode': {'enum': ['pdf', 'text'], 'type': 'string', 'description': "'pdf' = send PDF from pdfUrl. 'text' = generate PDF from typed text."}, 'text': {'type': 'string', 'description': 'Required for mode=text: message text to format as PDF'}, 'pages': {'type': 'number', 'description': "Expected page count (1-350). Used for pricing. Pass same value to create_payment as 'quantity'."}, 'pdfUrl': {'type': 'string', 'description': 'Required for mode=pdf: public HTTPS URL returning application/pdf'}, 'coverText': {'type': 'string', 'description': 'Optional cover page text (mode=pdf only, adds 1 page)'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'phoneNumber': {'type': 'string', 'description': 'Destination fax number in E.164 format (e.g. +14155550100)'}}}

{'type': 'object', 'required': ['paymentId', 'phoneNumber', 'message'], 'properties': {'message': {'type': 'string', 'description': 'Message text (max 1544 chars — a short signature line is appended; billed per SMS segment)'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'phoneNumber': {'type': 'string', 'description': 'Phone number in E.164 format (e.g., +14155550100). NOTE: non-+1 (international) numbers are delivered from an alphanumeric sender ID, so the recipient CANNOT reply — one-way only; for some countries (e.g. FR/CZ/CN) it is the only delivery path. No error is returned.'}}}

{'type': 'object', 'required': ['paymentId', 'text'], 'properties': {'text': {'type': 'string', 'description': 'Text to convert to speech'}, 'speed': {'type': 'number', 'default': 1, 'description': 'Speech speed multiplier (0.5-2.0)'}, 'voice': {'enum': ['English_expressive_narrator', 'English_radiant_girl', 'English_magnetic_voiced_man', 'English_compelling_lady1', 'English_Aussie_Bloke', 'English_captivating_female1', 'English_Upbeat_Woman', 'English_Trustworth_Man', 'English_CalmWoman', 'English_UpsetGirl', 'English_Gentle-voiced_man', 'English_Whispering_girl', 'English_Diligent_Man', 'English_Graceful_Lady', 'English_ReservedYoungMan', 'English_PlayfulGirl', 'English_ManWithDeepVoice', 'English_MaturePartner', 'English_FriendlyPerson', 'English_MatureBoss', 'English_Debator', 'English_LovelyGirl', 'English_Steadymentor', 'English_Deep-VoicedGentleman', 'English_Wiselady', 'English_CaptivatingStoryteller', 'English_DecentYoungMan', 'English_SentimentalLady', 'English_ImposingManner', 'English_SadTeen', 'English_PassionateWarrior', 'English_WiseScholar', 'English_Soft-spokenGirl', 'English_SereneWoman', 'English_ConfidentWoman', 'English_PatientMan', 'English_Comedian', 'English_BossyLeader', 'English_Strong-WilledBoy', 'English_StressedLady', 'English_AssertiveQueen', 'English_AnimeCharacter', 'English_Jovialman', 'English_WhimsicalGirl', 'English_Kind-heartedGirl', 'Chinese (Mandarin)_Reliable_Executive', 'Chinese (Mandarin)_News_Anchor', 'Chinese (Mandarin)_Unrestrained_Young_Man', 'Chinese (Mandarin)_Mature_Woman', 'Arrogant_Miss', 'Robot_Armor', 'Chinese (Mandarin)_Kind-hearted_Antie', 'Chinese (Mandarin)_HK_Flight_Attendant', 'Chinese (Mandarin)_Humorous_Elder', 'Chinese (Mandarin)_Gentleman', 'Chinese (Mandarin)_Warm_Bestie', 'Chinese (Mandarin)_Stubborn_Friend', 'Chinese (Mandarin)_Sweet_Lady', 'Chinese (Mandarin)_Southern_Young_Man', 'Chinese (Mandarin)_Wise_Women', 'Chinese (Mandarin)_Gentle_Youth', 'Chinese (Mandarin)_Warm_Girl', 'Chinese (Mandarin)_Male_Announcer', 'Chinese (Mandarin)_Kind-hearted_Elder', 'Chinese (Mandarin)_Cute_Spirit', 'Chinese (Mandarin)_Radio_Host', 'Chinese (Mandarin)_Lyrical_Voice', 'Chinese (Mandarin)_Straightforward_Boy', 'Chinese (Mandarin)_Sincere_Adult', 'Chinese (Mandarin)_Gentle_Senior', 'Chinese (Mandarin)_Crisp_Girl', 'Chinese (Mandarin)_Pure-hearted_Boy', 'Chinese (Mandarin)_Soft_Girl', 'Chinese (Mandarin)_IntellectualGirl', 'Chinese (Mandarin)_Warm_HeartedGirl', 'Chinese (Mandarin)_Laid_BackGirl', 'Chinese (Mandarin)_ExplorativeGirl', 'Chinese (Mandarin)_Warm-HeartedAunt', 'Chinese (Mandarin)_BashfulGirl', 'Japanese_IntellectualSenior', 'Japanese_DecisivePrincess', 'Japanese_LoyalKnight', 'Japanese_DominantMan', 'Japanese_SeriousCommander', 'Japanese_ColdQueen', 'Japanese_DependableWoman', 'Japanese_GentleButler', 'Japanese_KindLady', 'Japanese_CalmLady', 'Japanese_OptimisticYouth', 'Japanese_GenerousIzakayaOwner', 'Japanese_SportyStudent', 'Japanese_InnocentBoy', 'Japanese_GracefulMaiden', 'Cantonese_ProfessionalHost (F)', 'Cantonese_GentleLady', 'Cantonese_ProfessionalHost (M)', 'Cantonese_PlayfulMan', 'Cantonese_CuteGirl', 'Cantonese_KindWoman', 'Korean_AirheadedGirl', 'Korean_AthleticGirl', 'Korean_AthleticStudent', 'Korean_BraveAdventurer', 'Korean_BraveFemaleWarrior', 'Korean_BraveYouth', 'Korean_CalmGentleman', 'Korean_CalmLady', 'Korean_CaringWoman', 'Korean_CharmingElderSister', 'Korean_CharmingSister', 'Korean_CheerfulBoyfriend', 'Korean_CheerfulCoolJunior', 'Korean_CheerfulLittleSister', 'Korean_ChildhoodFriendGirl', 'Korean_CockyGuy', 'Korean_ColdGirl', 'Korean_ColdYoungMan', 'Korean_ConfidentBoss', 'Korean_ConsiderateSenior', 'Korean_DecisiveQueen', 'Korean_DominantMan', 'Korean_ElegantPrincess', 'Korean_EnchantingSister', 'Korean_EnthusiasticTeen', 'Korean_FriendlyBigSister', 'Korean_GentleBoss', 'Korean_GentleWoman', 'Korean_HaughtyLady', 'Korean_InnocentBoy', 'Korean_IntellectualMan', 'Korean_IntellectualSenior', 'Korean_LonelyWarrior', 'Korean_MatureLady', 'Korean_MysteriousGirl', 'Korean_OptimisticYouth', 'Korean_PlayboyCharmer', 'Korean_PossessiveMan', 'Korean_QuirkyGirl', 'Korean_ReliableSister', 'Korean_ReliableYouth', 'Korean_SassyGirl', 'Korean_ShyGirl', 'Korean_SoothingLady', 'Korean_StrictBoss', 'Korean_SweetGirl', 'Korean_ThoughtfulWoman', 'Korean_WiseElf', 'Korean_WiseTeacher', 'Spanish_SereneWoman', 'Spanish_MaturePartner', 'Spanish_CaptivatingStoryteller', 'Spanish_Narrator', 'Spanish_WiseScholar', 'Spanish_Kind-heartedGirl', 'Spanish_DeterminedManager', 'Spanish_BossyLeader', 'Spanish_ReservedYoungMan', 'Spanish_ConfidentWoman', 'Spanish_ThoughtfulMan', 'Spanish_Strong-WilledBoy', 'Spanish_SophisticatedLady', 'Spanish_RationalMan', 'Spanish_AnimeCharacter', 'Spanish_Deep-tonedMan', 'Spanish_Fussyhostess', 'Spanish_SincereTeen', 'Spanish_FrankLady', 'Spanish_Comedian', 'Spanish_Debator', 'Spanish_ToughBoss', 'Spanish_Wiselady', 'Spanish_Steadymentor', 'Spanish_Jovialman', 'Spanish_SantaClaus', 'Spanish_Rudolph', 'Spanish_Intonategirl', 'Spanish_Arnold', 'Spanish_Ghost', 'Spanish_HumorousElder', 'Spanish_EnergeticBoy', 'Spanish_WhimsicalGirl', 'Spanish_StrictBoss', 'Spanish_ReliableMan', 'Spanish_SereneElder', 'Spanish_AngryMan', 'Spanish_AssertiveQueen', 'Spanish_CaringGirlfriend', 'Spanish_PowerfulSoldier', 'Spanish_PassionateWarrior', 'Spanish_ChattyGirl', 'Spanish_RomanticHusband', 'Spanish_CompellingGirl', 'Spanish_PowerfulVeteran', 'Spanish_SensibleManager', 'Spanish_ThoughtfulLady', 'Portuguese_SentimentalLady', 'Portuguese_BossyLeader', 'Portuguese_Wiselady', 'Portuguese_Strong-WilledBoy', 'Portuguese_Deep-VoicedGentleman', 'Portuguese_UpsetGirl', 'Portuguese_PassionateWarrior', 'Portuguese_AnimeCharacter', 'Portuguese_ConfidentWoman', 'Portuguese_AngryMan', 'Portuguese_CaptivatingStoryteller', 'Portuguese_Godfather', 'Portuguese_ReservedYoungMan', 'Portuguese_SmartYoungGirl', 'Portuguese_Kind-heartedGirl', 'Portuguese_Pompouslady', 'Portuguese_Grinch', 'Portuguese_Debator', 'Portuguese_SweetGirl', 'Portuguese_AttractiveGirl', 'Portuguese_ThoughtfulMan', 'Portuguese_PlayfulGirl', 'Portuguese_GorgeousLady', 'Portuguese_LovelyLady', 'Portuguese_SereneWoman', 'Portuguese_SadTeen', 'Portuguese_MaturePartner', 'Portuguese_Comedian', 'Portuguese_NaughtySchoolgirl', 'Portuguese_Narrator', 'Portuguese_ToughBoss', 'Portuguese_Fussyhostess', 'Portuguese_Dramatist', 'Portuguese_Steadymentor', 'Portuguese_Jovialman', 'Portuguese_CharmingQueen', 'Portuguese_SantaClaus', 'Portuguese_Rudolph', 'Portuguese_Arnold', 'Portuguese_CharmingSanta', 'Portuguese_CharmingLady', 'Portuguese_Ghost', 'Portuguese_HumorousElder', 'Portuguese_CalmLeader', 'Portuguese_GentleTeacher', 'Portuguese_EnergeticBoy', 'Portuguese_ReliableMan', 'Portuguese_SereneElder', 'Portuguese_GrimReaper', 'Portuguese_AssertiveQueen', 'Portuguese_WhimsicalGirl', 'Portuguese_StressedLady', 'Portuguese_FriendlyNeighbor', 'Portuguese_CaringGirlfriend', 'Portuguese_PowerfulSoldier', 'Portuguese_FascinatingBoy', 'Portuguese_RomanticHusband', 'Portuguese_StrictBoss', 'Portuguese_InspiringLady', 'Portuguese_PlayfulSpirit', 'Portuguese_ElegantGirl', 'Portuguese_CompellingGirl', 'Portuguese_PowerfulVeteran', 'Portuguese_SensibleManager', 'Portuguese_ThoughtfulLady', 'Portuguese_TheatricalActor', 'Portuguese_FragileBoy', 'Portuguese_ChattyGirl', 'Portuguese_Conscientiousinstructor', 'Portuguese_RationalMan', 'Portuguese_WiseScholar', 'Portuguese_FrankLady', 'Portuguese_DeterminedManager', 'French_Male_Speech_New', 'French_Female_News Anchor', 'French_CasualMan', 'French_MovieLeadFemale', 'French_FemaleAnchor', 'French_MaleNarrator', 'Indonesian_SweetGirl', 'Indonesian_ReservedYoungMan', 'Indonesian_CharmingGirl', 'Indonesian_CalmWoman', 'Indonesian_ConfidentWoman', 'Indonesian_CaringMan', 'Indonesian_BossyLeader', 'Indonesian_DeterminedBoy', 'Indonesian_GentleGirl', 'German_FriendlyMan', 'German_SweetLady', 'German_PlayfulMan', 'Russian_HandsomeChildhoodFriend', 'Russian_BrightHeroine', 'Russian_AmbitiousWoman', 'Russian_ReliableMan', 'Russian_CrazyQueen', 'Russian_PessimisticGirl', 'Russian_AttractiveGuy', 'Russian_Bad-temperedBoy', 'Italian_BraveHeroine', 'Italian_Narrator', 'Italian_WanderingSorcerer', 'Italian_DiligentLeader', 'Dutch_kindhearted_girl', 'Dutch_bossy_leader', 'Vietnamese_kindhearted_girl', 'Arabic_CalmWoman', 'Arabic_FriendlyGuy', 'Turkish_CalmWoman', 'Turkish_Trustworthyman', 'Ukrainian_CalmWoman', 'Ukrainian_WiseScholar', 'Thai_male_1_sample8', 'Thai_male_2_sample2', 'Thai_female_1_sample1', 'Thai_female_2_sample2', 'Polish_male_1_sample4', 'Polish_male_2_sample3', 'Polish_female_1_sample1', 'Polish_female_2_sample3', 'Romanian_male_1_sample2', 'Romanian_male_2_sample1', 'Romanian_female_1_sample4', 'Romanian_female_2_sample1', 'greek_male_1a_v1', 'Greek_female_1_sample1', 'Greek_female_2_sample3', 'czech_male_1_v1', 'czech_female_5_v7', 'czech_female_2_v2', 'finnish_male_3_v1', 'finnish_male_1_v2', 'finnish_female_4_v1', 'hindi_male_1_v2', 'hindi_female_2_v1', 'hindi_female_1_v2', 'Abby', 'Alain', 'Alex', 'Amina', 'Anjali', 'Arjun', 'Ashley', 'Asuka', 'Avery', 'Bianca', 'Blake', 'Brandon', 'Brian', 'Callum', 'Carter', 'Cedric', 'Celeste', 'Chloe', 'Claire', 'Clive', 'Conrad', 'Craig', 'Damon', 'Darlene', 'Deborah', 'Dennis', 'Derek', 'Diego', 'Dmitry', 'Dominus', 'Duncan', 'Edward', 'Eleanor', 'Elena', 'Elizabeth', 'Elliot', 'Erik', 'Ethan', 'Étienne', 'Evan', 'Evelyn', 'Felix', 'Gareth', 'Gianni', 'Graham', 'Grant', 'Hades', 'Hamish', 'Hana', 'Hank', 'Heitor', 'Hélène', 'Hyunwoo', 'Jake', 'James', 'Jason', 'Jessica', 'Jing', 'Johanna', 'Jonah', 'Josef', 'Julia', 'Katrien', 'Kayla', 'Kelsey', 'Lauren', 'Lennart', 'Levi', 'Liam', 'Lore', 'Loretta', 'Lucian', 'Luna', 'Lupita', 'Maitê', 'Malcolm', 'Manoj', 'Marcus', 'Mark', 'Marlene', 'Mathieu', 'Mia', 'Miguel', 'Minji', 'Miranda', 'Mortimer', 'Nadia', 'Naomi', 'Nate', 'Nikolai', 'Nour', 'Oliver', 'Olivia', 'Omar', 'Oren', 'Orietta', 'Pippa', 'Pixie', 'Priya', 'Rafael', 'Reed', 'Riley', 'Riya', 'Ronald', 'Rupert', 'Saanvi', 'Sarah', 'Satoshi', 'Sebastian', 'Selene', 'Seojun', 'Serena', 'Shaun', 'Simon', 'Snik', 'Sophie', 'Svetlana', 'Szymon', 'Tessa', 'Theodore', 'Timothy', 'Trevor', 'Tristan', 'Tyler', 'Veronica', 'Victor', 'Victoria', 'Vinny', 'Wendy', 'Wojciech', 'Xiaoyin', 'Xinyi', 'Yael', 'Yichen', 'Yoona'], 'type': 'string', 'description': 'Voice ID. 467 total voices. Use list_models to see available TTS models. Or paste a custom cloned voice ID.\n\n## Minimax Studio — voice cloning from reference clip, ~5 chars/sat (332 voices)\n### Arabic (2)\nArabic_CalmWoman (Female, Middle Aged, Serene, calm female); Arabic_FriendlyGuy (Male, Middle Aged, Warm, friendly male)\n### Cantonese (6)\nCantonese_ProfessionalHost (F) (Female, Middle Aged, Polished, professional female host); Cantonese_GentleLady (Female, Middle Aged, Gentle, refined female); Cantonese_ProfessionalHost (M) (Male, Middle Aged, Polished, professional male host); Cantonese_PlayfulMan (Male, Middle Aged, Fun, playful male); Cantonese_CuteGirl (Female, Young, Cute, endearing young female); Cantonese_KindWoman (Female, Middle Aged, Kind, warm female)\n### Chinese (34)\nChinese (Mandarin)_Reliable_Executive (Male, Middle Aged, Professional, dependable male); Chinese (Mandarin)_News_Anchor (Male, Middle Aged, Clear, authoritative news voice); Chinese (Mandarin)_Unrestrained_Young_Man (Male, Young, Free-spirited young male); Chinese (Mandarin)_Mature_Woman (Female, Middle Aged, Poised, mature female); Arrogant_Miss (Female, Young, Haughty, proud young female); Robot_Armor (Male, Middle Aged, Robotic, mechanical voice); Chinese (Mandarin)_Kind-hearted_Antie (Female, Old, Warm, caring older female); Chinese (Mandarin)_HK_Flight_Attendant (Female, Young, Professional, polished female); Chinese (Mandarin)_Humorous_Elder (Male, Old, Witty, humorous older male); Chinese (Mandarin)_Gentleman (Male, Middle Aged, Refined, courteous male); Chinese (Mandarin)_Warm_Bestie (Female, Young, Friendly, warm young female); Chinese (Mandarin)_Stubborn_Friend (Male, Young, Persistent, headstrong male); Chinese (Mandarin)_Sweet_Lady (Female, Middle Aged, Gentle, sweet female); Chinese (Mandarin)_Southern_Young_Man (Male, Young, Southern-accented young male); Chinese (Mandarin)_Wise_Women (Female, Middle Aged, Thoughtful, wise female); Chinese (Mandarin)_Gentle_Youth (Male, Young, Soft, gentle young male); Chinese (Mandarin)_Warm_Girl (Female, Young, Warm, inviting young female); Chinese (Mandarin)_Male_Announcer (Male, Middle Aged, Clear, authoritative announcer); Chinese (Mandarin)_Kind-hearted_Elder (Male, Old, Gentle, wise older male); Chinese (Mandarin)_Cute_Spirit (Female, Young, Cute, spirited young female); Chinese (Mandarin)_Radio_Host (Male, Middle Aged, Smooth, professional radio voice); Chinese (Mandarin)_Lyrical_Voice (Female, Middle Aged, Melodic, lyrical female); Chinese (Mandarin)_Straightforward_Boy (Male, Young, Direct, honest young male); Chinese (Mandarin)_Sincere_Adult (Male, Middle Aged, Genuine, sincere male); Chinese (Mandarin)_Gentle_Senior (Male, Old, Gentle, patient older male); Chinese (Mandarin)_Crisp_Girl (Female, Young, Clear, crisp young female); Chinese (Mandarin)_Pure-hearted_Boy (Male, Young, Innocent, pure-hearted young male); Chinese (Mandarin)_Soft_Girl (Female, Young, Soft, delicate young female); Chinese (Mandarin)_IntellectualGirl (Female, Young, Smart, intellectual young female); Chinese (Mandarin)_Warm_HeartedGirl (Female, Young, Warm, caring young female); Chinese (Mandarin)_Laid_BackGirl (Female, Young, Relaxed, laid-back young female); Chinese (Mandarin)_ExplorativeGirl (Female, Young, Curious, adventurous young female); Chinese (Mandarin)_Warm-HeartedAunt (Female, Middle Aged, Caring, nurturing aunt figure); Chinese (Mandarin)_BashfulGirl (Female, Young, Shy, bashful young female)\n### Czech (3)\nczech_male_1_v1 (Male, Middle Aged, Confident, assured presenter); czech_female_5_v7 (Female, Middle Aged, Steady, reliable narrator); czech_female_2_v2 (Female, Middle Aged, Refined, elegant female)\n### Dutch (2)\nDutch_kindhearted_girl (Female, Young, Compassionate, kind young female); Dutch_bossy_leader (Male, Middle Aged, Commanding, bossy male)\n### English (45)\nEnglish_expressive_narrator (Male, Middle Aged, Expressive, dynamic narrator); English_radiant_girl (Female, Young, Bright, cheerful young female); English_magnetic_voiced_man (Male, Middle Aged, Rich, magnetic male voice); English_compelling_lady1 (Female, Middle Aged, Persuasive, engaging female); English_Aussie_Bloke (Male, Middle Aged, Casual Australian male); English_captivating_female1 (Female, Middle Aged, Alluring, captivating female); English_Upbeat_Woman (Female, Middle Aged, Upbeat, energetic female); English_Trustworth_Man (Male, Middle Aged, Reliable, trustworthy male); English_CalmWoman (Female, Middle Aged, Serene, relaxing female); English_UpsetGirl (Female, Young, Emotional, distressed young female); English_Gentle-voiced_man (Male, Middle Aged, Soft, gentle male voice); English_Whispering_girl (Female, Young, Soft, whispery young female); English_Diligent_Man (Male, Middle Aged, Focused, hardworking male); English_Graceful_Lady (Female, Middle Aged, Elegant, poised female); English_ReservedYoungMan (Male, Young, Quiet, reserved young male); English_PlayfulGirl (Female, Young, Fun, playful young female); English_ManWithDeepVoice (Male, Middle Aged, Deep, resonant male bass); English_MaturePartner (Male, Middle Aged, Mature, dependable male); English_FriendlyPerson (Male, Middle Aged, Warm, approachable male); English_MatureBoss (Female, Middle Aged, Commanding, authoritative female); English_Debator (Male, Middle Aged, Articulate, persuasive male); English_LovelyGirl (Female, Young, Sweet, charming young female); English_Steadymentor (Male, Middle Aged, Steady, mentoring male); English_Deep-VoicedGentleman (Male, Middle Aged, Distinguished, deep-voiced male); English_Wiselady (Female, Middle Aged, Thoughtful, wise female); English_CaptivatingStoryteller (Male, Middle Aged, Engaging, narrative male voice); English_DecentYoungMan (Male, Young, Polite, well-spoken young male); English_SentimentalLady (Female, Middle Aged, Emotional, heartfelt female); English_ImposingManner (Female, Middle Aged, Commanding, regal female); English_SadTeen (Male, Young, Youthful, melancholic teen male); English_PassionateWarrior (Male, Middle Aged, Fierce, passionate male); English_WiseScholar (Male, Old, Learned, scholarly male); English_Soft-spokenGirl (Female, Young, Quiet, gentle young female); English_SereneWoman (Female, Middle Aged, Peaceful, calm female); English_ConfidentWoman (Female, Middle Aged, Self-assured, bold female); English_PatientMan (Male, Middle Aged, Steady, reassuring male); English_Comedian (Male, Middle Aged, Humorous, comedic male); English_BossyLeader (Male, Middle Aged, Commanding, bossy male); English_Strong-WilledBoy (Male, Young, Determined, strong-willed young male); English_StressedLady (Female, Middle Aged, Tense, stressed female); English_AssertiveQueen (Female, Middle Aged, Bold, assertive female); English_AnimeCharacter (Female, Young, Animated, expressive narrator); English_Jovialman (Male, Middle Aged, Cheerful, jolly male); English_WhimsicalGirl (Female, Young, Dreamy, whimsical young female); English_Kind-heartedGirl (Female, Young, Compassionate, kind young female)\n### Finnish (3)\nfinnish_male_3_v1 (Male, Middle Aged, Cheerful, upbeat male); finnish_male_1_v2 (Male, Young, Friendly, approachable young male); finnish_female_4_v1 (Female, Middle Aged, Bold, assertive female)\n### French (6)\nFrench_Male_Speech_New (Male, Middle Aged, Composed, level-headed male); French_Female_News Anchor (Female, Middle Aged, Patient, professional presenter); French_CasualMan (Male, Middle Aged, Laid-back, casual male); French_MovieLeadFemale (Female, Middle Aged, Dramatic, cinematic female); French_FemaleAnchor (Female, Middle Aged, Professional, clear anchor); French_MaleNarrator (Male, Middle Aged, Clear, engaging narrator)\n### German (3)\nGerman_FriendlyMan (Male, Middle Aged, Warm, friendly male); German_SweetLady (Female, Middle Aged, Sweet, gentle female); German_PlayfulMan (Male, Middle Aged, Fun, playful male)\n### Greek (3)\ngreek_male_1a_v1 (Male, Middle Aged, Reflective, mentoring male); Greek_female_1_sample1 (Female, Middle Aged, Soft, gentle female); Greek_female_2_sample3 (Female, Young, Friendly, relatable female)\n### Hindi (3)\nhindi_male_1_v2 (Male, Middle Aged, Reliable, trustworthy male); hindi_female_2_v1 (Female, Middle Aged, Peaceful, tranquil female); hindi_female_1_v2 (Female, Middle Aged, Clear, authoritative anchor)\n### Indonesian (9)\nIndonesian_SweetGirl (Female, Young, Sweet, gentle young female); Indonesian_ReservedYoungMan (Male, Young, Quiet, reserved young male); Indonesian_CharmingGirl (Female, Young, Charming, attractive female); Indonesian_CalmWoman (Female, Middle Aged, Serene, calm female); Indonesian_ConfidentWoman (Female, Middle Aged, Self-assured female); Indonesian_CaringMan (Male, Middle Aged, Nurturing, caring male); Indonesian_BossyLeader (Male, Middle Aged, Commanding, bossy male); Indonesian_DeterminedBoy (Male, Young, Focused, determined young male); Indonesian_GentleGirl (Female, Young, Soft, gentle young female)\n### Italian (4)\nItalian_BraveHeroine (Female, Middle Aged, Courageous, brave female); Italian_Narrator (Male, Middle Aged, Clear, professional narrator); Italian_WanderingSorcerer (Male, Old, Mystical, wandering character); Italian_DiligentLeader (Male, Middle Aged, Focused, diligent male)\n### Japanese (15)\nJapanese_IntellectualSenior (Male, Old, Learned, intellectual senior); Japanese_DecisivePrincess (Female, Young, Bold, decisive young female); Japanese_LoyalKnight (Male, Middle Aged, Loyal, noble male); Japanese_DominantMan (Male, Middle Aged, Strong, commanding male); Japanese_SeriousCommander (Male, Middle Aged, Stern, authoritative commander); Japanese_ColdQueen (Female, Middle Aged, Icy, regal female); Japanese_DependableWoman (Female, Middle Aged, Reliable, steady female); Japanese_GentleButler (Male, Middle Aged, Polite, refined butler voice); Japanese_KindLady (Female, Middle Aged, Kind, warm female); Japanese_CalmLady (Female, Middle Aged, Serene, calm female); Japanese_OptimisticYouth (Male, Young, Cheerful, optimistic young male); Japanese_GenerousIzakayaOwner (Male, Middle Aged, Warm, generous male); Japanese_SportyStudent (Male, Young, Energetic, athletic young male); Japanese_InnocentBoy (Male, Young, Innocent, naive young male); Japanese_GracefulMaiden (Female, Young, Elegant, graceful young female)\n### Korean (49)\nKorean_AirheadedGirl (Female, Young, Carefree, bubbly young female); Korean_AthleticGirl (Female, Young, Energetic, sporty young female); Korean_AthleticStudent (Male, Young, Active, sporty young male); Korean_BraveAdventurer (Male, Middle Aged, Bold, adventurous male); Korean_BraveFemaleWarrior (Female, Middle Aged, Fierce, brave female); Korean_BraveYouth (Male, Young, Courageous young male); Korean_CalmGentleman (Male, Middle Aged, Composed, calm male); Korean_CalmLady (Female, Middle Aged, Serene, calm female); Korean_CaringWoman (Female, Middle Aged, Nurturing, caring female); Korean_CharmingElderSister (Female, Middle Aged, Charming, elegant sister); Korean_CharmingSister (Female, Young, Attractive, charming female); Korean_CheerfulBoyfriend (Male, Young, Upbeat, cheerful young male); Korean_CheerfulCoolJunior (Male, Young, Cool, laid-back junior); Korean_CheerfulLittleSister (Female, Young, Happy, energetic young female); Korean_ChildhoodFriendGirl (Female, Young, Familiar, friendly female); Korean_CockyGuy (Male, Young, Confident, cocky young male); Korean_ColdGirl (Female, Young, Aloof, cool young female); Korean_ColdYoungMan (Male, Young, Reserved, cold young male); Korean_ConfidentBoss (Male, Middle Aged, Self-assured, commanding boss); Korean_ConsiderateSenior (Male, Middle Aged, Thoughtful, considerate male); Korean_DecisiveQueen (Female, Middle Aged, Bold, decisive female); Korean_DominantMan (Male, Middle Aged, Powerful, dominant male); Korean_ElegantPrincess (Female, Young, Refined, elegant young female); Korean_EnchantingSister (Female, Young, Enchanting, captivating female); Korean_EnthusiasticTeen (Male, Young, Eager, enthusiastic teen); Korean_FriendlyBigSister (Female, Middle Aged, Friendly, supportive sister); Korean_GentleBoss (Male, Middle Aged, Gentle, kind boss); Korean_GentleWoman (Female, Middle Aged, Soft, gentle female); Korean_HaughtyLady (Female, Middle Aged, Proud, haughty female); Korean_InnocentBoy (Male, Young, Innocent, naive young male); Korean_IntellectualMan (Male, Middle Aged, Smart, intellectual male); Korean_IntellectualSenior (Male, Old, Wise, intellectual senior); Korean_LonelyWarrior (Male, Middle Aged, Solitary, stoic male); Korean_MatureLady (Female, Middle Aged, Poised, mature female); Korean_MysteriousGirl (Female, Young, Enigmatic, mysterious young female); Korean_OptimisticYouth (Male, Young, Cheerful, optimistic young male); Korean_PlayboyCharmer (Male, Young, Suave, charming young male); Korean_PossessiveMan (Male, Middle Aged, Intense, possessive male); Korean_QuirkyGirl (Female, Young, Quirky, unique young female); Korean_ReliableSister (Female, Middle Aged, Dependable, reliable female); Korean_ReliableYouth (Male, Young, Dependable young male); Korean_SassyGirl (Female, Young, Bold, sassy young female); Korean_ShyGirl (Female, Young, Shy, reserved young female); Korean_SoothingLady (Female, Middle Aged, Calming, soothing female); Korean_StrictBoss (Male, Middle Aged, Stern, strict male boss); Korean_SweetGirl (Female, Young, Sweet, gentle young female); Korean_ThoughtfulWoman (Female, Middle Aged, Thoughtful, reflective female); Korean_WiseElf (Female, Young, Whimsical, wise character); Korean_WiseTeacher (Male, Old, Patient, wise teacher)\n### Polish (4)\nPolish_male_1_sample4 (Male, Middle Aged, Clear, professional narrator); Polish_male_2_sample3 (Male, Middle Aged, Authoritative news anchor); Polish_female_1_sample1 (Female, Middle Aged, Serene, calm female); Polish_female_2_sample3 (Female, Middle Aged, Relaxed, casual female)\n### Portuguese (73)\nPortuguese_SentimentalLady (Female, Middle Aged, Emotional, sentimental female); Portuguese_BossyLeader (Male, Middle Aged, Commanding, bossy male); Portuguese_Wiselady (Female, Middle Aged, Wise, thoughtful female); Portuguese_Strong-WilledBoy (Male, Young, Determined young male); Portuguese_Deep-VoicedGentleman (Male, Middle Aged, Distinguished, deep male); Portuguese_UpsetGirl (Female, Young, Emotional, distressed female); Portuguese_PassionateWarrior (Male, Middle Aged, Fierce, passionate male); Portuguese_AnimeCharacter (Female, Young, Animated, expressive character); Portuguese_ConfidentWoman (Female, Middle Aged, Self-assured female); Portuguese_AngryMan (Male, Middle Aged, Intense, angry male); Portuguese_CaptivatingStoryteller (Male, Middle Aged, Engaging narrator); Portuguese_Godfather (Male, Old, Gravelly, authoritative male); Portuguese_ReservedYoungMan (Male, Young, Quiet, reserved young male); Portuguese_SmartYoungGirl (Female, Young, Intelligent, bright young female); Portuguese_Kind-heartedGirl (Female, Young, Compassionate young female); Portuguese_Pompouslady (Female, Middle Aged, Grand, pompous female); Portuguese_Grinch (Male, Middle Aged, Grumpy, grouchy character); Portuguese_Debator (Male, Middle Aged, Articulate, persuasive male); Portuguese_SweetGirl (Female, Young, Sweet, gentle young female); Portuguese_AttractiveGirl (Female, Young, Attractive, alluring female); Portuguese_ThoughtfulMan (Male, Middle Aged, Reflective, thoughtful male); Portuguese_PlayfulGirl (Female, Young, Fun, playful young female); Portuguese_GorgeousLady (Female, Middle Aged, Beautiful, elegant female); Portuguese_LovelyLady (Female, Middle Aged, Lovely, charming female); Portuguese_SereneWoman (Female, Middle Aged, Peaceful, calm female); Portuguese_SadTeen (Male, Young, Melancholic, sad teen); Portuguese_MaturePartner (Male, Middle Aged, Mature, dependable male); Portuguese_Comedian (Male, Middle Aged, Humorous, comedic male); Portuguese_NaughtySchoolgirl (Female, Young, Mischievous young female); Portuguese_Narrator (Male, Middle Aged, Clear, professional narrator); Portuguese_ToughBoss (Male, Middle Aged, Hard-nosed, tough male); Portuguese_Fussyhostess (Female, Middle Aged, Particular, meticulous female); Portuguese_Dramatist (Male, Middle Aged, Dramatic, theatrical male); Portuguese_Steadymentor (Male, Middle Aged, Reliable, mentoring male); Portuguese_Jovialman (Male, Middle Aged, Cheerful, jovial male); Portuguese_CharmingQueen (Female, Middle Aged, Charming, regal female); Portuguese_SantaClaus (Male, Old, Jolly, festive character); Portuguese_Rudolph (Male, Young, Playful, festive character); Portuguese_Arnold (Male, Middle Aged, Strong, tough male character); Portuguese_CharmingSanta (Male, Old, Charming, festive character); Portuguese_CharmingLady (Female, Middle Aged, Charming, elegant female); Portuguese_Ghost (Male, Middle Aged, Eerie, spectral character); Portuguese_HumorousElder (Male, Old, Witty, humorous older male); Portuguese_CalmLeader (Male, Middle Aged, Composed, calm leader); Portuguese_GentleTeacher (Female, Middle Aged, Patient, gentle teacher); Portuguese_EnergeticBoy (Male, Young, Lively, energetic young male); Portuguese_ReliableMan (Male, Middle Aged, Dependable, reliable male); Portuguese_SereneElder (Male, Old, Peaceful, wise elder); Portuguese_GrimReaper (Male, Middle Aged, Dark, ominous character); Portuguese_AssertiveQueen (Female, Middle Aged, Bold, assertive female); Portuguese_WhimsicalGirl (Female, Young, Dreamy, whimsical female); Portuguese_StressedLady (Female, Middle Aged, Tense, stressed female); Portuguese_FriendlyNeighbor (Male, Middle Aged, Friendly, neighborly male); Portuguese_CaringGirlfriend (Female, Young, Loving, caring young female); Portuguese_PowerfulSoldier (Male, Middle Aged, Strong, powerful male); Portuguese_FascinatingBoy (Male, Young, Charming, fascinating young male); Portuguese_RomanticHusband (Male, Middle Aged, Romantic, loving male); Portuguese_StrictBoss (Male, Middle Aged, Stern, strict boss); Portuguese_InspiringLady (Female, Middle Aged, Motivating, inspiring female); Portuguese_PlayfulSpirit (Female, Young, Fun, playful young female); Portuguese_ElegantGirl (Female, Young, Refined, elegant young female); Portuguese_CompellingGirl (Female, Young, Engaging, compelling female); Portuguese_PowerfulVeteran (Male, Old, Experienced, powerful veteran); Portuguese_SensibleManager (Male, Middle Aged, Practical, sensible male); Portuguese_ThoughtfulLady (Female, Middle Aged, Reflective, thoughtful female); Portuguese_TheatricalActor (Male, Middle Aged, Dramatic, theatrical male); Portuguese_FragileBoy (Male, Young, Delicate, fragile young male); Portuguese_ChattyGirl (Female, Young, Talkative, bubbly female); Portuguese_Conscientiousinstructor (Male, Middle Aged, Careful, thorough instructor); Portuguese_RationalMan (Male, Middle Aged, Logical, rational male); Portuguese_WiseScholar (Male, Old, Learned, scholarly male); Portuguese_FrankLady (Female, Middle Aged, Direct, frank female); Portuguese_DeterminedManager (Male, Middle Aged, Focused, decisive manager)\n### Romanian (4)\nRomanian_male_1_sample2 (Male, Middle Aged, Dependable, reliable male); Romanian_male_2_sample1 (Male, Young, Lively, energetic young male); Romanian_female_1_sample4 (Female, Young, Cheerful, optimistic female); Romanian_female_2_sample1 (Female, Middle Aged, Soft, gentle female)\n### Russian (8)\nRussian_HandsomeChildhoodFriend (Male, Young, Charming, familiar young male); Russian_BrightHeroine (Female, Middle Aged, Bright, regal female); Russian_AmbitiousWoman (Female, Middle Aged, Driven, ambitious female); Russian_ReliableMan (Male, Middle Aged, Dependable, reliable male); Russian_CrazyQueen (Female, Young, Wild, unpredictable female); Russian_PessimisticGirl (Female, Young, Gloomy, pessimistic female); Russian_AttractiveGuy (Male, Young, Charming, attractive young male); Russian_Bad-temperedBoy (Male, Young, Irritable, short-tempered male)\n### Spanish (47)\nSpanish_SereneWoman (Female, Middle Aged, Peaceful, calm female); Spanish_MaturePartner (Male, Middle Aged, Mature, dependable male); Spanish_CaptivatingStoryteller (Male, Middle Aged, Engaging narrator); Spanish_Narrator (Male, Middle Aged, Clear, professional narrator); Spanish_WiseScholar (Male, Old, Learned, scholarly male); Spanish_Kind-heartedGirl (Female, Young, Compassionate young female); Spanish_DeterminedManager (Male, Middle Aged, Focused, decisive manager); Spanish_BossyLeader (Male, Middle Aged, Commanding, bossy male); Spanish_ReservedYoungMan (Male, Young, Quiet, reserved young male); Spanish_ConfidentWoman (Female, Middle Aged, Self-assured female); Spanish_ThoughtfulMan (Male, Middle Aged, Reflective, thoughtful male); Spanish_Strong-WilledBoy (Male, Young, Determined young male); Spanish_SophisticatedLady (Female, Middle Aged, Elegant, sophisticated female); Spanish_RationalMan (Male, Middle Aged, Logical, rational male); Spanish_AnimeCharacter (Female, Young, Animated, expressive character); Spanish_Deep-tonedMan (Male, Middle Aged, Deep, resonant male); Spanish_Fussyhostess (Female, Middle Aged, Particular, meticulous female); Spanish_SincereTeen (Male, Young, Honest, sincere teen); Spanish_FrankLady (Female, Middle Aged, Direct, frank female); Spanish_Comedian (Male, Middle Aged, Humorous, comedic male); Spanish_Debator (Male, Middle Aged, Articulate, persuasive male); Spanish_ToughBoss (Male, Middle Aged, Hard-nosed, tough male); Spanish_Wiselady (Female, Middle Aged, Wise, thoughtful female); Spanish_Steadymentor (Male, Middle Aged, Reliable, mentoring male); Spanish_Jovialman (Male, Middle Aged, Cheerful, jovial male); Spanish_SantaClaus (Male, Old, Jolly, festive character); Spanish_Rudolph (Male, Young, Playful, festive character); Spanish_Intonategirl (Female, Young, Expressive, melodic young female); Spanish_Arnold (Male, Middle Aged, Strong, tough male character); Spanish_Ghost (Male, Middle Aged, Eerie, spectral character); Spanish_HumorousElder (Male, Old, Witty, humorous older male); Spanish_EnergeticBoy (Male, Young, Lively, energetic young male); Spanish_WhimsicalGirl (Female, Young, Dreamy, whimsical female); Spanish_StrictBoss (Male, Middle Aged, Stern, strict boss); Spanish_ReliableMan (Male, Middle Aged, Dependable, reliable male); Spanish_SereneElder (Male, Old, Peaceful, wise elder); Spanish_AngryMan (Male, Middle Aged, Intense, angry male); Spanish_AssertiveQueen (Female, Middle Aged, Bold, assertive female); Spanish_CaringGirlfriend (Female, Young, Loving, caring young female); Spanish_PowerfulSoldier (Male, Middle Aged, Strong, powerful male); Spanish_PassionateWarrior (Male, Middle Aged, Fierce, passionate male); Spanish_ChattyGirl (Female, Young, Talkative, bubbly young female); Spanish_RomanticHusband (Male, Middle Aged, Romantic, loving male); Spanish_CompellingGirl (Female, Young, Engaging, compelling female); Spanish_PowerfulVeteran (Male, Old, Experienced, powerful veteran); Spanish_SensibleManager (Male, Middle Aged, Practical, sensible male); Spanish_ThoughtfulLady (Female, Middle Aged, Reflective, thoughtful female)\n### Thai (4)\nThai_male_1_sample8 (Male, Middle Aged, Peaceful, calm male); Thai_male_2_sample2 (Male, Middle Aged, Warm, friendly male); Thai_female_1_sample1 (Female, Middle Aged, Self-assured female); Thai_female_2_sample2 (Female, Young, Lively, energetic female)\n### Turkish (2)\nTurkish_CalmWoman (Female, Middle Aged, Serene, calm female); Turkish_Trustworthyman (Male, Middle Aged, Reliable, trustworthy male)\n### Ukrainian (2)\nUkrainian_CalmWoman (Female, Middle Aged, Serene, calm female); Ukrainian_WiseScholar (Male, Old, Learned, scholarly male)\n### Vietnamese (1)\nVietnamese_kindhearted_girl (Female, Young, Compassionate, kind young female)\n\n## Inworld Max Premium — #1 ranked TTS, ~16 chars/sat (135 voices)\n### Arabic (2)\nNour (Female, Middle Aged, Polished female Arabic voice with a friendly tone, great for voiceover or support); Omar (Male, Middle Aged, Bright, confident Arabic male voice, great for announcements and broadcasts)\n### Chinese (4)\nJing (Female, Young, An energetic, fast-paced young Chinese female); Xiaoyin (Female, Young, A youthful Chinese female voice with a gentle, sweet quality); Xinyi (Female, Young, A Chinese woman with a neutral tone, perfect for narrations); Yichen (Male, Middle Aged, A calm, flat young adult male Chinese voice)\n### Dutch (4)\nErik (Male, Middle Aged, Older Dutch male voice with a weathered edge); Katrien (Female, Middle Aged, Dutch woman with an expressive voice); Lennart (Male, Middle Aged, A confident Dutch male voice. Calm and relaxed); Lore (Female, Middle Aged, Clear, calm Dutch female voice, great for narrations and professional use)\n### English (95)\nAbby (Female, Young, Bright, eager American female child voice, ideal for animated characters and educational content); Alex (Male, Middle Aged, Energetic and expressive mid-range male voice, with a mildly nasal quality); Amina (Female, Middle Aged, Warm, inviting West African female voice, ideal for community outreach and storytelling); Anjali (Female, Middle Aged, Confident, articulate Indian female voice, ideal for professional training materials); Arjun (Male, Middle Aged, Clear, composed Indian male voice, well-suited for instructional webinars); Ashley (Female, Middle Aged, A warm, natural female voice); Avery (Male, Young, Youthful, performative male voice, suited for gameshow-style hosting); Bianca (Female, Middle Aged, Deep, controlled female voice, ideal for serious corporate reads); Blake (Male, Middle Aged, Rich, intimate male voice, perfect for audiobooks and romantic content); Brandon (Male, Middle Aged, Bold, strident male voice, ideal for structured announcements and news-style reads); Brian (Male, Middle Aged, Friendly, encouraging American male voice, ideal for educational tutorials); Callum (Male, Middle Aged, Casual and friendly Australian male voice, ideal for informal instructional content); Carter (Male, Middle Aged, Energetic, mature radio announcer-style male voice, great for storytelling); Cedric (Male, Middle Aged, Crisp, measured male voice, ideal for formal announcements and premium narration); Celeste (Female, Middle Aged, Soft, whispery female voice, ideal for ASMR and gentle mindfulness sessions); Chloe (Female, Young, Thoughtful, introspective youthful female voice, perfect for coming-of-age narratives); Claire (Female, Middle Aged, Warm, gentle Eastern European female voice, ideal for bedtime stories); Clive (Male, Middle Aged, British-accented English male with a calm, cordial quality); Conrad (Male, Middle Aged, Gruff, weathered male voice, perfect for detective archetypes and audiobook roles); Craig (Male, Old, Older British male with a refined and articulate voice); Damon (Male, Middle Aged, Calm, raspy male voice, suited for moody narration and atmospheric roleplay); Darlene (Female, Middle Aged, Soothing, comforting Southern female voice, ideal for bedtime stories); Deborah (Female, Young, Warm, peaceful female voice with a calm tone); Dennis (Male, Middle Aged, Middle-aged man with a smooth, calm and friendly voice); Derek (Male, Middle Aged, Steady, professional, composed American male voice, ideal for banking support); Dominus (Male, Middle Aged, Robotic, deep male voice with a menacing quality. Perfect for villains); Duncan (Male, Middle Aged, Warm, articulate British male voice for customer support and education); Edward (Male, Middle Aged, American male with an emphatic, confident and streetwise tone); Eleanor (Female, Middle Aged, Polished, approachable British female voice for support and learning); Elizabeth (Female, Middle Aged, Professional middle-aged woman, perfect for narrations and voiceovers); Elliot (Male, Middle Aged, Calm, steady male voice, suitable for nature documentaries and informational content); Ethan (Male, Young, Assured, precise male voice, perfect for tech tutorials and gadget overviews); Evan (Male, Middle Aged, Friendly, approachable, easygoing male voice, ideal for onboarding and retail assistance); Evelyn (Female, Middle Aged, Gentle, intimate female voice, ideal for ASMR and calming conversations); Felix (Male, Middle Aged, Calm, friendly British male voice, ideal for help and tutorials); Gareth (Male, Middle Aged, Soothing, gentle male voice, ideal for guided meditations and relaxation); Graham (Male, Middle Aged, Profound, authoritative British male voice, perfect for historical documentaries); Grant (Male, Middle Aged, Calm, attentive, helpful male voice, ideal for troubleshooting and support); Hades (Male, Middle Aged, Commanding and gruff male voice, think an omniscient narrator or castle guard); Hamish (Male, Middle Aged, Friendly and casual Australian male voice, ideal for character-driven roles); Hana (Female, Young, Bright, expressive young female voice, perfect for storytelling and gaming); Hank (Male, Middle Aged, Warm, laid-back Southern male voice, ideal for travel documentaries); Jake (Male, Young, Amiable, introspective male voice, ideal for motivational talks); James (Male, Middle Aged, Vibrant, expressive male voice, perfect for animated video content and event hosting); Jason (Male, Middle Aged, Lucid, engrossing male voice, ideal for tech tips and creative content); Jessica (Female, Middle Aged, Encouraging, articulate American female voice, perfect for self-help audiobooks); Jonah (Male, Middle Aged, Soothing, calm male voice, great for tutorial guidance and gentle instructions); Julia (Female, Middle Aged, Quirky, high-pitched female voice that delivers lines with playful energy); Kayla (Female, Young, Enthusiastic, youthful female voice, ideal for reaction videos and product reviews); Kelsey (Female, Middle Aged, Warm, empathetic, reassuring female voice, ideal for phone support); Lauren (Female, Middle Aged, Confident, friendly American female voice, ideal for corporate presentations); Levi (Male, Middle Aged, Measured, ominous male voice, ideal for suspense narration and dark fantasy); Liam (Male, Middle Aged, Upbeat, motivating Australian male voice, perfect for energizing workout sessions); Loretta (Female, Middle Aged, Inviting, folksy Southern female voice, perfect for cooking shows and family tales); Lucian (Male, Middle Aged, Brooding, foreboding male voice, suited for villainous character arcs); Luna (Female, Middle Aged, Calm, relaxing female voice, perfect for meditations, sleep stories, and mindfulness); Malcolm (Male, Middle Aged, Authoritative, manipulative male voice, perfect for cunning leaders); Marcus (Male, Middle Aged, Authoritative, empathetic male voice, great for civic campaigns and outreach); Mark (Male, Middle Aged, Energetic, expressive man with a rapid-fire delivery); Marlene (Female, Middle Aged, Friendly, relaxed Southern female voice, ideal for cooking tutorials); Mia (Female, Young, Youthful, expressive female voice, ideal for adolescent characters); Miranda (Female, Middle Aged, Menacing, cold-hearted female voice, perfect for strategic villains); Mortimer (Male, Middle Aged, Gravelly, aggressive male character voice, ideal for fantasy villains); Nadia (Female, Middle Aged, Personable, lively female voice, perfect for tutorial walkthroughs); Naomi (Female, Middle Aged, Warm, grounded female voice, perfect for narrative podcasting); Nate (Male, Young, Conversational, sociable male voice, great for customer support); Oliver (Male, Middle Aged, Neutral and clear male voice, ideal for public announcements and education); Olivia (Female, Middle Aged, Young, British female with a friendly and helpful tone); Pippa (Female, Middle Aged, Friendly and casual Australian female voice, ideal for relaxed instructional content); Pixie (Female, Middle Aged, High-pitched, childlike female voice with a squeaky quality — great for cartoons); Priya (Female, Young, Even-toned female voice with an Indian accent); Reed (Male, Middle Aged, Clear, professional American male voice, well-suited for support and training); Riley (Female, Young, Playful, youthful female voice, perfect for animated storytelling); Ronald (Male, Old, Confident, British man with a deep, gravelly voice); Rupert (Male, Middle Aged, Resonant, commanding British male voice, ideal for motivational speeches); Saanvi (Female, Middle Aged, Crisp, articulate Indian female voice, ideal for e-learning modules); Sarah (Female, Middle Aged, Fast-talking young adult woman, with a questioning and curious tone); Sebastian (Male, Middle Aged, Intimidating, steely male voice, perfect for ruthless antagonists); Selene (Female, Young, Soft, flirtatious female voice, ideal for companion-style interactions); Serena (Female, Middle Aged, Soft, nurturing female voice, perfect for mindfulness sessions); Shaun (Male, Middle Aged, Friendly, dynamic male voice great for conversations); Simon (Male, Middle Aged, Articulate, insightful male voice, perfect for corporate presentations); Snik (Male, Middle Aged, Hoarse, cunning male voice, perfect for devious goblin roles and tricksters); Sophie (Female, Middle Aged, Friendly British female voice, great for assistance and knowledge sharing); Tessa (Female, Middle Aged, Upbeat, conversational Australian female voice, perfect for lifestyle vlogs); Theodore (Male, Old, Gravelly male voice, with a time-worn quality); Timothy (Male, Young, Lively, upbeat American male voice); Trevor (Male, Middle Aged, Punchy, expressive male voice, perfect for energetic promos); Tristan (Male, Middle Aged, Deliberate, controlled male voice, ideal for documentary narration); Tyler (Male, Middle Aged, Authoritative, insightful male voice, ideal for tech explainer videos); Veronica (Female, Middle Aged, Intimidating, commanding female voice, perfect for ruthless antagonists); Victor (Male, Middle Aged, Ominous, sinister male voice, ideal for dark conspiracies and suspense); Victoria (Female, Middle Aged, Silky, cunning British female voice, ideal for narrating intricate plots); Vinny (Male, Middle Aged, Gritty, assertive New York male voice, perfect for crime dramas); Wendy (Female, Old, Posh, middle-aged British female voice)\n### French (4)\nAlain (Male, Middle Aged, Deep, smooth middle-aged male French voice. Composed and calm); Étienne (Male, Middle Aged, Calm young adult French male); Hélène (Female, Middle Aged, Middle-aged French woman, with a smooth, musical, and graceful voice); Mathieu (Male, Middle Aged, A French male voice carrying a nasal quality)\n### German (2)\nJohanna (Female, Middle Aged, A calm older German female with a low, smoky voice); Josef (Male, Middle Aged, An articulate German male voice with an announcer-like quality)\n### Hebrew (2)\nOren (Male, Middle Aged, Steady male Hebrew voice, great for podcasts and voiceovers); Yael (Female, Middle Aged, Mid-range female Hebrew voice, suitable for narrations and storytelling)\n### Hindi (2)\nManoj (Male, Middle Aged, Clear, professional Hindi male voice. Great for narrations and customer service); Riya (Female, Middle Aged, Professional, clear female voice with an articulate and polished delivery)\n### Italian (2)\nGianni (Male, Middle Aged, Deep, smooth Italian male voice that speaks rapidly); Orietta (Female, Middle Aged, Calm adult female Italian voice, with a soothing cadence)\n### Japanese (2)\nAsuka (Female, Middle Aged, Friendly, young adult Japanese female voice); Satoshi (Male, Middle Aged, Dramatic, expressive male Japanese voice filled with energy)\n### Korean (4)\nHyunwoo (Male, Middle Aged, Young adult Korean male voice); Minji (Male, Young, Energetic, friendly young Korean female voice); Seojun (Male, Young, Clear, deep mature Korean male voice); Yoona (Female, Middle Aged, Korean woman with a gentle, soothing voice)\n### Polish (2)\nSzymon (Male, Middle Aged, Polish adult male voice with a warm, friendly quality); Wojciech (Male, Middle Aged, A middle-aged Polish male voice)\n### Portuguese (2)\nHeitor (Male, Middle Aged, Composed Portuguese-speaking male voice with a neutral tone); Maitê (Female, Middle Aged, Middle-aged Portuguese-speaking female voice)\n### Russian (4)\nDmitry (Male, Middle Aged, Deep, gravelly male voice with a commanding and narrative tone); Elena (Female, Middle Aged, Clear, mid-range female voice with a smooth texture and neutral tone); Nikolai (Male, Middle Aged, Deep, resonant male voice with a clear, theatrical, and narrative quality); Svetlana (Female, Middle Aged, Soft, high-pitched female voice with a moderate pace and breathy quality)\n### Spanish (4)\nDiego (Male, Young, Spanish-speaking male voice with a soothing, gentle quality); Lupita (Female, Young, Vibrant, energetic young Spanish-speaking female voice); Miguel (Male, Middle Aged, A calm adult Spanish-speaking male voice, perfect for storytelling); Rafael (Male, Middle Aged, Middle-aged Spanish-speaking male with a deep, composed voice. Great for narrations)'}, 'modelId': {'type': 'number', 'description': 'Optional. 3 tiers: OmniVoice Global (602+ langs, ~106 chars/sat), Inworld Premium (#1 ranked, ~16 chars/sat), Minimax Studio (voice cloning, ~5 chars/sat). Omit for default.'}, 'language': {'enum': ['kbt', 'ab', 'abr', 'abn', 'fub', 'ady', 'aal', 'af', 'yay', 'ajg', 'keu', 'ala', 'sq', 'arq', 'aao', 'qva', 'abs', 'adx', 'am', 'anw', 'anp', 'xmv', 'an', 'aae', 'qxu', 'hy', 'ahs', 'prq', 'eiv', 'as', 'ast', 'tay', 'awo', 'quy', 'az', 'bba', 'bcy', 'bde', 'ksf', 'bfd', 'fui', 'bqg', 'abv', 'bkh', 'bjt', 'bft', 'bce', 'bax', 'bsj', 'bjn', 'abb', 'bci', 'bhr', 'bjk', 'bas', 'bzw', 'ba', 'eu', 'btm', 'bnm', 'btv', 'bbl', 'bda', 'beb', 'be', 'bn', 'bew', 'bhb', 'bho', 'bxf', 'bhp', 'brx', 'bux', 'bky', 'bmq', 'bou', 'fue', 'bs', 'brh', 'bra', 'br', 'bdm', 'bug', 'bhh', 'bg', 'bum', 'bns', 'bnn', 'bwr', 'bys', 'my', 'bsk', 'miu', 'qvl', 'cky', 'wes', 'sro', 'yue', 'ca', 'ceb', 'cen', 'ckb', 'nhn', 'pbs', 'pst', 'ncx', 'tar', 'esu', 'fuq', 'shu', 'ny', 'zpv', 'cgg', 'zoh', 'qug', 'zh', 'qxa', 'the', 'cjk', 'cv', 'ckl', 'kjc', 'zoc', 'kw', 'qwa', 'hr', 'mfn', 'xtu', 'cs', 'dbd', 'dag', 'dml', 'da', 'dar', 'dzg', 'dcc', 'deg', 'kna', 'dgh', 'mki', 'dv', 'adf', 'cfa', 'dgo', 'dmk', 'dty', 'dua', 'nl', 'ldb', 'dyu', 'bgp', 'gui', 'avl', 'kqo', 'mhr', 'ydd', 'ebr', 'ego', 'arz', 'etu', 'elm', 'afo', 'ebu', 'en', 'myv', 'ish', 'eo', 'et', 'eto', 'ewo', 'ext', 'fan', 'fat', 'gur', 'fmp', 'fil', 'tlp', 'fi', 'fip', 'fr', 'ff', 'gl', 'wof', 'lg', 'gbm', 'gwt', 'gwc', 'gbr', 'gby', 'gyz', 'gej', 'ka', 'de', 'ges', 'aln', 'bbj', 'gid', 'glw', 'gom', 'gig', 'ank', 'gol', 'el', 'gn', 'gdf', 'amu', 'gu', 'gju', 'afb', 'ggg', 'guz', 'gsl', 'gwe', 'ztu', 'hoj', 'hah', 'ht', 'cnh', 'hao', 'hla', 'ha', 'haw', 'haz', 'he', 'hem', 'hz', 'kjk', 'acw', 'hi', 'var', 'mau', 'nhq', 'hbb', 'mxs', 'hul', 'hu', 'hkk', 'hwo', 'ibb', 'is', 'ida', 'idu', 'ig', 'ahl', 'kpo', 'ikw', 'qvi', 'id', 'mvy', 'ia', 'ik', 'ga', 'os', 'its', 'iso', 'it', 'itw', 'itz', 'vmj', 'ijc', 'jax', 'ja', 'jqr', 'qxw', 'jns', 'jv', 'juo', 'kaj', 'aju', 'vmc', 'kbd', 'lkb', 'kea', 'kab', 'gjk', 'ckr', 'ijn', 'kls', 'kln', 'xka', 'kam', 'kcq', 'bjj', 'kbl', 'kn', 'kai', 'ks', 'tkt', 'bsh', 'kk', 'eyo', 'khg', 'ogo', 'xhe', 'km', 'khw', 'zga', 'kfk', 'rw', 'ky', 'fkk', 'thq', 'plk', 'bcs', 'trp', 'kol', 'bkm', 'kmy', 'knn', 'koo', 'ko', 'kfp', 'kfe', 'eko', 'ksd', 'kj', 'uki', 'bbu', 'kto', 'kuh', 'kwm', 'nmg', 'lla', 'hia', 'lo', 'alo', 'lss', 'ltg', 'lv', 'apc', 'ste', 'xpe', 'lir', 'ayl', 'lij', 'mgi', 'ln', 'lt', 'lrk', 'rag', 'src', 'qvj', 'loa', 'lnu', 'ztp', 'lua', 'luo', 'lus', 'lb', 'ffm', 'mde', 'rup', 'mk', 'mxu', 'maf', 'mai', 'ms', 'ml', 'gcc', 'tcf', 'mt', 'tbf', 'mfv', 'mqy', 'mni', 'msw', 'gv', 'mi', 'mr', 'mrt', 'mfm', 'mrr', 'mve', 'mcn', 'msh', 'mcf', 'zpy', 'vmz', 'mzl', 'mfo', 'mbo', 'mdd', 'byv', 'mek', 'mer', 'acm', 'mtr', 'nan', 'xmf', 'vmm', 'mkf', 'bri', 'mdf', 'ver', 'mn', 'ary', 'meu', 'mcx', 'mgg', 'mua', 'mhk', 'mse', 'mug', 'mui', 'mne', 'ars', 'nal', 'nmz', 'ng', 'nap', 'npi', 'nbh', 'anc', 'nnh', 'ngi', 'jgo', 'nla', 'fuv', 'pcm', 'noe', 'fia', 'ayp', 'max', 'bmm', 'hno', 'kmr', 'pmq', 'pbu', 'uzn', 'gya', 'no', 'nb', 'nn', 'ncf', 'yes', 'nyu', 'nja', 'hux', 'oc', 'odk', 'ory', 'odu', 'acx', 'nlv', 'orc', 'oru', 'orm', 'aom', 'phr', 'pwn', 'pa', 'pmy', 'kvx', 'nso', 'pip', 'fa', 'pex', 'phl', 'pms', 'piy', 'plt', 'pl', 'poc', 'pt', 'fuc', 'fuf', 'qxp', 'ps', 'pko', 'byx', 'chq', 'thr', 'lag', 'kyx', 'rth', 'zor', 'ro', 'rm', 'rof', 'roo', 'dru', 'ru', 'quv', 'aec', 'skg', 'szy', 'sau', 'ccg', 'ndi', 'pow', 'hue', 'poe', 'trq', 'mig', 'ssi', 'sa', 'qxt', 'ztn', 'sat', 'qus', 'sps', 'skr', 'sc', 'say', 'trv', 'sr', 'sei', 'scl', 'sn', 'sjr', 'nco', 'scn', 'qws', 'sip', 'snc', 'sd', 'sbn', 'si', 'xti', 'qum', 'siw', 'sk', 'sl', 'sol', 'so', 'snk', 'giz', 'cpy', 'mxy', 'bzc', 'pbt', 'qup', 'vmp', 'es', 'arb', 'zgh', 'apd', 'sua', 'sva', 'sw', 'sv', 'rob', 'thv', 'dav', 'tg', 'ta', 'tdx', 'tan', 'txy', 'yer', 'tt', 'tuq', 'te', 'kdh', 'tio', 'cux', 'cte', 'ttr', 'buo', 'twu', 'tkg', 'nhg', 'cut', 'th', 'bo', 'mtx', 'tvo', 'tgc', 'tig', 'ti', 'zts', 'tpz', 'tpl', 'ctl', 'tli', 'tok', 'tqp', 'tdn', 'txs', 'ttj', 'ttu', 'trw', 'xmw', 'lto', 'tn', 'tuy', 'bag', 'tul', 'tcy', 'tvu', 'lcm', 'aeb', 'tui', 'tuv', 'tr', 'tk', 'mtu', 'tw', 'byc', 'ug', 'uk', 'umb', 'hsb', 'ur', 'ush', 'uz', 'vai', 'vi', 'vot', 'vro', 'wci', 'kxp', 'wja', 'wbl', 'lwg', 'juk', 'wji', 'cy', 'weo', 'fy', 'pua', 'jmx', 'mlq', 'mrj', 'fuh', 'pnb', 'wo', 'udl', 'ztg', 'xh', 'ekr', 'sah', 'jal', 'qur', 'yav', 'yaq', 'qux', 'ets', 'yi', 'ydg', 'yo', 'mab', 'nhi', 'dje', 'zza', 'zu'], 'type': 'string', 'description': "OmniVoice tier ONLY: ISO 639 language code (646 supported). Default: 'en'. NOTE: on the Inworld/Minimax tiers this field is silently ignored — you get the chosen voice's own language (usually English) with no error. For a non-English language, either select the OmniVoice tier (modelId) or pick a voice whose language matches. Full language list at the GET /api/l402/text-to-speech endpoint."}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'voice_description': {'type': 'string', 'description': "OmniVoice only: voice-design words, one per group, separated by commas: male|female; child|teenager|young adult|middle-aged|elderly; very low|low|moderate|high|very high pitch; whisper; american|british|australian|canadian|indian|chinese|korean|japanese|portuguese|russian accent. Example: 'female, young adult, high pitch'. Any other word is refused before payment."}}}

{'type': 'object', 'required': ['paymentId', 'audioBase64'], 'properties': {'diarize': {'type': 'boolean', 'description': "Identify different speakers (default false). Forces segment granularity upstream. If the speaker-label request fails, you still get the text, and result.degraded includes 'diarization'."}, 'language': {'type': 'string', 'description': "Language code (e.g., 'en', 'es')"}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'timestamps': {'enum': ['none', 'segment', 'word'], 'type': 'string', 'description': "Timestamp granularity in result.segments. 'word' returns per-word start/end times (subtitle alignment, karaoke captions, cutting video to speech). Default 'segment'. If the timestamp request fails, you still get the text, and result.degraded includes 'timestamps' (no segments, srt or vtt)."}, 'audioBase64': {'type': 'string', 'description': 'Base64 encoded audio file'}, 'callback_id': {'type': 'string', 'description': 'Optional correlation string echoed back in the webhook body. Max 128 chars.'}, 'callback_url': {'type': 'string', 'description': 'Optional HTTPS webhook we POST when the job finishes (HMAC-signed). Polling still works.'}}}

{'type': 'object', 'required': ['paymentId', 'audioBase64', 'targetLanguage'], 'properties': {'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'audioBase64': {'type': 'string', 'description': 'Base64-encoded audio file'}, 'sourceLanguage': {'type': 'string', 'description': 'Optional — auto-detected if omitted. Accepts ISO-639 codes for the 13 STT languages: en, zh, hi, es, ar, fr, pt, ru, de, ja, ko, it, nl. NOTE: only these 13 are transcribable — a wrong hint (or audio in another language) yields a garbled transcript that is still billed as success. Omit to auto-detect and verify the transcript before trusting the translation.'}, 'targetLanguage': {'type': 'string', 'description': "Target language — English name (e.g. 'Spanish') or ISO-639 code (e.g. 'es', 'en-US'). 119 languages supported."}}}

{'type': 'object', 'required': ['paymentId', 'epubBase64', 'targetLanguage'], 'properties': {'fileName': {'type': 'string', 'description': 'Optional original filename, used to name the download.'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'epubBase64': {'type': 'string', 'description': 'Base64-encoded EPUB (max 50 MB)'}, 'sourceLanguage': {'type': 'string', 'description': 'Optional source-language hint. Omit to let the model read it from the text.'}, 'targetLanguage': {'type': 'string', 'description': "Target language — English name (e.g. 'Spanish') or ISO-639 code (e.g. 'es'). Must equal the targetLanguage the payment was quoted with."}}}

{'type': 'object', 'required': ['paymentId', 'text', 'targetLanguage'], 'properties': {'text': {'type': 'string', 'description': 'Text to translate. Max 6000 characters.'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid). Price = 50 sats + 0.002/char.'}, 'targetLanguage': {'type': 'string', 'description': "MADLAD language code ('mag', 'arz', 'bho', 'hne') or English name ('Magahi', 'Egyptian Arabic'). Rejected before payment if unsupported."}}}

{'type': 'object', 'required': ['paymentId', 'text', 'targetLanguage'], 'properties': {'text': {'type': 'string', 'description': 'Text to translate'}, 'modelId': {'type': 'number', 'description': 'Optional. Translation model is selected automatically.'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'sourceLanguage': {'type': 'string', 'description': "Source language (auto-detected if omitted). NOTE: only checked for being a known language, not against your text — a wrong but valid value (e.g. 'German' for Spanish text) is accepted and silently mistranslates with no error. Omit it to let auto-detect work."}, 'targetLanguage': {'type': 'string', 'description': "Target language — English name ('Spanish', 'Chinese (Simplified)') or ISO-639 code / locale tag ('es', 'pt-BR'). 119 supported; full list at the GET /api/l402/translate-text endpoint."}}}

{'type': 'object', 'required': ['paymentId', 'imageBase64'], 'properties': {'scale': {'enum': ['2', '4'], 'type': 'string', 'description': 'Upscale factor: 2x or 4x (default 4x)'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (must be paid)'}, 'imageBase64': {'type': 'string', 'description': 'Base64-encoded image (PNG, JPEG, WEBP) or data URI'}, 'face_enhance': {'type': 'boolean', 'description': 'Apply face enhancement during upscaling (default false)'}}}

{'type': 'object', 'required': ['sessionId'], 'properties': {'text': {'type': 'string', 'description': 'Text to speak (mode 1). Uses OmniVoice TTS.'}, 'encoding': {'enum': ['mulaw_8000', 'pcm_l16_16000'], 'type': 'string', 'description': 'Encoding of audioBase64. mp3/opus require ffmpeg (not yet wired in MVP).'}, 'language': {'type': 'string', 'description': 'Language override for this utterance (default: session language)'}, 'sessionId': {'type': 'string', 'description': 'Session ID from open_voice_bridge'}, 'audioBase64': {'type': 'string', 'description': "Pre-rendered audio bytes, base64 (mode 2). Use with 'encoding'."}, 'voiceDescription': {'type': 'string', 'description': 'OmniVoice voice-design words, one per group, separated by commas: male|female; child|teenager|young adult|middle-aged|elderly; very low|low|moderate|high|very high pitch; whisper; american|british|australian|canadian|indian|chinese|korean|japanese|portuguese|russian accent. When OmniVoice speaks the line, any other word is dropped: it speaks in its default voice and the reply carries a warning. When OmniVoice was not ready at open_voice_bridge, a fallback voice speaks and ignores this field.'}}}

{'type': 'object', 'required': ['paymentId', 'slug'], 'properties': {'slug': {'type': 'string', 'description': 'Service slug to vote for (from list_planned_services)'}, 'paymentId': {'type': 'string', 'description': 'Valid payment ID (1 sat, must be paid)'}}}