40+ Lightning-paid AI tools for agents: calls, SMS, fax, voice, translation. No signup, no keys.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
When your task hits a wall that requires a human — booking, negotiating, navigating IVR menus, getting information from a business — send an AI voice agent to handle the call. The agent follows your instructions, has a real two-way conversation, and returns a full transcript with structured analysis. One redial, 2 minutes later, if nobody answers, a voicemail answers, the line is busy or the call drops within 30 seconds. No redial after the person speaks and hangs up, asks to stop or opts out, or after the agent leaves a voicemail message. A person who asks not to be called again is added to our do-not-contact list. The redial runs on the deposit's unused minutes (none left: no redial), and a connected redial bills at least 1 minute. May return state='pending_confirm' with clarification questions if critical info is missing — call confirm_ai_call to proceed. Async — poll with check_job_status(jobType='ai-call'). Priced in sats per destination and duration — create_payment returns the exact amount before you pay. Languages: en-US, en-GB, es-ES, fr-FR, de-DE, ja-JP, zh-CN, multi. Pay with Bitcoin Lightning — no telecom account, no API key, no subscription. When NOT to use: not when you want to drive the conversation with your own LLM (use open_voice_bridge — you keep the brain, we provide PSTN/STT/TTS primitives). Not for one-shot TTS broadcasts or IVR delivery (use place_call). Not for SMS (use send_sms). Requires create_payment with toolName='ai_call', phoneNumber, and durationMinutes. The agent identifies itself as a virtual assistant calling for a client, and answers questions about the service if the recipient asks. At the end of a normal call it asks the recipient for permission to share the recording; without a clear yes, the recording is deleted and never returned. 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.
Instructions for the AI agent (what to say, ask, or accomplish)
Valid payment ID (must be paid)
Phone number in E.164 format (e.g., +14155550100)
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.
Optional opening line for the agent
Max call duration 1-10 minutes (default: 3)
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
When your task hits a wall that requires a human — booking, negotiating, navigating IVR menus, getting information from a business — send an AI voice agent to handle the call. The agent follows your instructions, has a real two-way conversation, and returns a full transcript with structured analysis. One redial, 2 minutes later, if nobody answers, a voicemail answers, the line is busy or the call drops within 30 seconds. No redial after the person speaks and hangs up, asks to stop or opts out, or after the agent leaves a voicemail message. A person who asks not to be called again is added to our do-not-contact list. The redial runs on the deposit's unused minutes (none left: no redial), and a connected redial bills at least 1 minute. May return state='pending_confirm' with clarification questions if critical info is missing — call confirm_ai_call to proceed. Async — poll with check_job_status(jobType='ai-call'). Priced in sats per destination and duration — create_payment returns the exact amount before you pay. Languages: en-US, en-GB, es-ES, fr-FR, de-DE, ja-JP, zh-CN, multi. Pay with Bitcoin Lightning — no telecom account, no API key, no subscription. When NOT to use: not when you want to drive the conversation with your own LLM (use open_voice_bridge — you keep the brain, we provide PSTN/STT/TTS primitives). Not for one-shot TTS broadcasts or IVR delivery (use place_call). Not for SMS (use send_sms). Requires create_payment with toolName='ai_call', phoneNumber, and durationMinutes. The agent identifies itself as a virtual assistant calling for a client, and answers questions about the service if the recipient asks. At the end of a normal call it asks the recipient for permission to share the recording; without a clear yes, the recording is deleted and never returned. 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.
| Argument | Type | Description |
|---|---|---|
| task* | string | Instructions for the AI agent (what to say, ask, or accomplish) |
| language | string | 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* | string | Valid payment ID (must be paid) |
| phoneNumber* | string | Phone number in E.164 format (e.g., +14155550100) |
| beginMessage | string | Optional opening line for the agent |
| durationMinutes | number | Max call duration 1-10 minutes (default: 3) |
{
"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)"
}
}
}Analyze and describe image content, answer visual questions, extract information from screenshots or photos. Uses Qwen VL — multimodal vision-language model with strong OCR, chart reading, and spatial reasoning. 21 sats per image. Pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='analyze_image'.
| Argument | Type | Description |
|---|---|---|
| prompt* | string | Question or analysis prompt for the image |
| modelId | number | Optional. Omit for default model. |
| paymentId* | string | Valid payment ID (must be paid) |
| imageBase64* | string | 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"
],
"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)."
}
}
}Animate a still image into cinematic video with MiniMax H3 — provide a first frame and a prompt to direct the motion. Native audio. Async — returns requestId, poll with check_job_status. 768p or 2K (2K is upscaled from a 768p render), duration 5-15 seconds, priced per second by resolution. Pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='animate_image'.
| Argument | Type | Description |
|---|---|---|
| prompt* | string | Text prompt describing the animation |
| modelId | number | Optional. Omit for default model. |
| duration* | number | Duration in seconds (5-15) |
| paymentId* | string | Valid payment ID (must be paid) |
| resolution | string | 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* | string | Base64 encoded image to animate |
{
"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"
}
}
}Wait for an async job to finish and return its result in ONE call — no manual polling loop. Pass the requestId + jobType from an async tool (generate_video, animate_image, generate_3d_model, transcribe_audio, epub_to_audiobook, ai_call). If your MCP client opened the request with 'Accept: text/event-stream', this streams live progress (notifications/progress) while it waits, then returns the final result; otherwise it does a single status check and returns immediately (call again until status='COMPLETED'). For long jobs it waits up to ~4 minutes per call, then returns status='IN_PROGRESS' with timed_out=true — call again with the same requestId to keep waiting. Equivalent to check_job_status + get_job_result combined. Free; no payment.
| Argument | Type | Description |
|---|---|---|
| jobType* | string | Must match the async tool that returned requestId. |
| paymentId | string | Optional: the paymentId that bought this job. If its payment was refunded, the claim link comes back only when this matches — or call check_payment_status(paymentId). |
| requestId* | string | The requestId returned by the async tool. |
{
"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."
},
"paymentId": {
"type": "string",
"description": "Optional: the paymentId that bought this job. If its payment was refunded, the claim link comes back only when this matches — or call check_payment_status(paymentId)."
},
"requestId": {
"type": "string",
"description": "The requestId returned by the async tool."
}
}
}Turn airline boarding passes (PDF or screenshot) into Google Wallet passes with the fields a plain scan drops — boarding zone, gate, boarding time — for a whole family in one go. Returns one save link per passenger plus a single 'add all' link. The original barcode is preserved byte-for-byte so it scans at the gate. Priced 100 sats PER PASS: create_payment with toolName='boardingpass_wallet' and quantity=<number of passes> (if you under-count, the call returns the exact price to re-pay). Image/screenshot files that turn out to carry no extra fields are refunded. Privacy: files are processed in memory and never stored; the save link expires in 30 minutes, so nothing is retained. Pay with Bitcoin Lightning — no account, no card.
| Argument | Type | Description |
|---|---|---|
| documents | array | Base64 boarding passes, one per file (up to 8), for a family/booking. Provide this OR documentBase64 (at least one required). |
| paymentId* | string | Valid payment ID (must be paid). Price = 100 × number of passes. |
| documentBase64 | string | 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": [
"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."
}
}
}Poll the status of an async job. Use this after calling any async tool (generate_video, animate_image, generate_3d_model, transcribe_audio, epub_to_audiobook, ai_call) that returns a requestId. Returns JSON: { status: 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', requestId, jobType }. For epub-audiobook, also includes progress (0-100) and chapterProgress array. Poll every 5-10 seconds. When status is 'COMPLETED', call get_job_result to retrieve the output. When status is 'FAILED', the response includes an error message — do not retry automatically. This tool is free and does not require payment. Do NOT use for synchronous tools (generate_image, generate_text, etc.) — those return results immediately.
| Argument | Type | Description |
|---|---|---|
| jobType* | string | 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 fallback jobType generate_video returns when the primary video model is at capacity. |
| requestId* | string | 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": [
"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 fallback jobType generate_video returns when the primary video model 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)"
}
}
}Check whether a Lightning invoice has been paid. Returns JSON: { paid, serviceUsed, refundAllowed, readyToUse, next, state } — readyToUse=true means paid, not yet consumed, and no refund queued; next says what to do. state is unpaid, paid, delivered, held, refund-open, claimed or expired. held (with its appeal_url) is present while the payment is held for review. deliveryStatus and deliveryDetail are present for SMS and fax: a send that succeeded means accepted, not delivered, so poll for the carrier outcome. Call after create_payment to verify the user has paid before calling the target tool. Invoices expire after 10 minutes — if expired, create a new payment. Most MCP clients with a connected wallet pay instantly, so a single check is usually sufficient. This tool is free and does not require payment.
| Argument | Type | Description |
|---|---|---|
| paymentId* | string | The paymentId returned by create_payment |
{
"type": "object",
"required": [
"paymentId"
],
"properties": {
"paymentId": {
"type": "string",
"description": "The paymentId returned by create_payment"
}
}
}Clone a voice you own or have permission to use, from a single audio sample. Returns a reusable voice_id for text_to_speech. Requires consent=true; cloning a voice to impersonate someone is prohibited. High-fidelity reproduction capturing tone, cadence, and accent. SAMPLE REQUIREMENTS: MP3, M4A or WAV, 10 seconds to 5 minutes, 20 MB max, one speaker, no background music — a sample outside these limits is rejected upstream and the clone fails. Turbo (faster) or HD (higher quality) modes. 7,500 sats per clone. Pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='clone_voice'.
| Argument | Type | Description |
|---|---|---|
| model | string | Voice model: turbo (faster) or hd (higher quality) |
| consent* | boolean | 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 | number | Text validation accuracy 0-1 (default 0.7) |
| paymentId* | string | Valid payment ID (must be paid) |
| voiceFileUrl* | string | 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",
"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."
}
}
}Colorize black-and-white or grayscale photos. DDColor (dual-decoder, ICCV 2023) — vivid, natural colorization. Impossible for text/vision LLMs. 5 sats per image, pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='colorize_image'.
| Argument | Type | Description |
|---|---|---|
| paymentId* | string | Valid payment ID (must be paid) |
| model_size | string | Model variant: 'large' (best quality) or 'tiny' (faster). Default: large |
| imageBase64* | string | Base64-encoded grayscale or B&W image (PNG, JPEG) or data URI |
{
"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"
}
}
}Confirm an AI call after reviewing push-back questions, optionally providing answers to missing info. Required when ai_call returns state='pending_confirm'. Uses the original payment — no new payment needed. Returns call_id for polling with check_job_status(jobType='ai-call').
| Argument | Type | Description |
|---|---|---|
| answers | object | Key-value answers to the push-back questions (keys are the question strings, values are your answers). Omit to confirm the task as-is. |
| sessionId* | string | Session ID from the ai_call response |
{
"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"
}
}
}Convert files between 200+ formats: documents (PDF, DOCX, XLSX, HTML→PDF), images (PNG, JPG, WEBP, SVG), PDF first page to image (PDF→JPG, PDF→PNG), audio (MP3, WAV, FLAC), video (MP4, AVI, MOV). Industrial-grade conversion engine — preserves formatting and quality. Returns download URL. 100 sats. Pay per request with Bitcoin Lightning — no API key, no account, no subscription needed. Requires create_payment with toolName='convert_file'.
| Argument | Type | Description |
|---|---|---|
| fileUrl | string | Public URL to the file (provide this OR fileBase64) |
| paymentId* | string | Valid payment ID (must be paid) |
| fileBase64 | string | Base64-encoded file (provide this OR fileUrl) |
| extensionTo* | string | Target format without dot (e.g., 'pdf', 'docx') |
| extensionFrom* | string | Source format without dot (e.g., 'pdf', 'docx') |
{
"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')"
}
}
}Convert HTML or Markdown to a pixel-perfect PDF. Returns JSON: { url } — a temporary download URL (valid ~1 hour). Great for generating invoices, reports, receipts, or formatted documents programmatically. Supports full HTML/CSS including tables, images (base64 or URL), and inline styles. For Markdown input, set format='markdown'. 50 sats per conversion. Use convert_file instead for converting existing files between formats (e.g., DOCX→PDF). Pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='convert_html_to_pdf'.
| Argument | Type | Description |
|---|---|---|
| html* | string | HTML or Markdown content to convert |
| format | string | Input format (default: html) |
| paymentId* | string | Valid payment ID (must be paid) |
{
"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)"
}
}
}Pay for 2 to 10 calls with ONE Lightning invoice, up to 2,000 sats in all. Each item is { toolName, ...the same inputs create_payment takes for that tool }. The server checks and prices EVERY item first: one bad item refuses the whole cart, with no invoice, and the error names the item by its index. Returns JSON: { cartId, lightningInvoice, totalSats, expiresAt, items: [{ index, toolName, paymentId, amountSats }] }. Pay the ONE invoice. Then call each item's tool with that item's own paymentId, exactly as you would after create_payment. KEEP the paymentIds from this reply: each is the only way to use that item or to be refunded for it, and nothing can show them to you again. check_payment_status(cartId) shows the state of each item (it never repeats the paymentIds). An item you do not use is refunded for its own price after about an hour. Only one-shot tools can be in a cart (text, translation, image tools, document tools, text_to_speech); for calls, SMS, fax, email, video, music and other long jobs use create_payment.
| Argument | Type | Description |
|---|---|---|
| items* | array | The calls to pay for. Each item is an object with toolName and the inputs create_payment takes for that tool (for example prompt for generate_text, text and targetLanguage for translate_text). |
{
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"toolName"
],
"properties": {
"text": {
"type": "string",
"description": "For text_to_speech and translate_text: the exact text (priced per character, locked to the item)."
},
"prompt": {
"type": "string",
"description": "For generate_text and translate_text: the exact text you will send (the price is its character count, locked to the item)."
},
"modelId": {
"type": [
"number",
"string"
],
"description": "Optional. AI model id or name, as for create_payment."
},
"quantity": {
"type": "number",
"description": "For extract_document and extract_receipt: the pages. Default 1."
},
"toolName": {
"enum": [
"generate_text",
"translate_text",
"generate_image",
"edit_image",
"analyze_image",
"remove_background",
"upscale_image",
"restore_face",
"detect_nsfw",
"detect_objects",
"remove_object",
"colorize_image",
"deblur_image",
"estimate_depth",
"render_card",
"convert_file",
"merge_pdfs",
"convert_html_to_pdf",
"extract_document",
"extract_receipt",
"text_to_speech"
],
"type": "string",
"description": "The tool this item pays for."
},
"resolution": {
"type": "string",
"description": "For image tools priced by size: the resolution, as for create_payment."
},
"fileContext": {
"type": "string",
"description": "For generate_text: attached file text, if any (it is part of the price)."
},
"systemPrompt": {
"type": "string",
"description": "For generate_text: the system prompt, if you use one (it is part of the price)."
},
"targetLanguage": {
"type": "string",
"description": "For translate_text: the target language (it picks the engine and so the price)."
}
},
"additionalProperties": true
},
"maxItems": 10,
"minItems": 2,
"description": "The calls to pay for. Each item is an object with toolName and the inputs create_payment takes for that tool (for example prompt for generate_text, text and targetLanguage for translate_text)."
}
}
}Create a Lightning invoice to pay for one AI service call. Returns JSON: { paymentId, invoice (BOLT11), amount (sats), expiresAt }. Each payment covers exactly one tool call — call this once per operation. Typical flow: list_models → create_payment → check_payment_status → call tool. The invoice expires in 10 minutes. Call list_models first to discover modelId values. modelId is optional — omit it to use the default (best) model. Some tools require extra params at payment time because pricing depends on them: generate_text requires prompt (price = f(char count)); text_to_speech requires text (price = f(char count) by tier); transcribe_audio / transcribe_translate take durationMinutes (10 sats/min — declare your audio length, default 1); send_sms, place_call, ai_call require phoneNumber; generate_video and animate_image require duration, and take an optional resolution (250-400 sats/sec by resolution — quote with the SAME duration and resolution you will execute with); edit_image is a flat 200 sats per edit (resolution is optional and does not change the price); epub_to_audiobook requires characterCount (total text characters in the book — price is per-character by voice tier, minimum 500 sats). If required params are missing, the response includes an error with the missing field names.
| Argument | Type | Description |
|---|---|---|
| ocr | boolean | 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 | string | Legacy alias for generate_video: 'standard'→768p, 'pro'→2K. Prefer 'resolution'. |
| text | string | Required for text_to_speech: the exact text to synthesize (price is per-character by tier, locked to payment) |
| prompt | string | Required for generate_text: the exact prompt (price calculated from char count, locked to payment) |
Recover detail from camera-shake and accidental motion blur. NAFNet (ECCV 2022, SOTA on GoPro/SIDD benchmarks). Best for: handheld shake, bumped camera, whole-frame uniform blur. NOT effective for: intentional panning blur, bokeh/depth-of-field, or artistic motion effects. Also supports denoising (grainy/noisy photos). 110 sats per image (~2 min processing), pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='deblur_image'.
| Argument | Type | Description |
|---|---|---|
| paymentId* | string | Valid payment ID (must be paid) |
| task_type | string | 'Image Debluring (GoPro)' for camera shake (default), 'Image Debluring (REDS)' for video frame blur, 'Image Denoising' for grain/noise |
| imageBase64* | string | 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)"
},
"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"
}
}
}Classify image safety (normal / suggestive / explicit). Falcons.ai NSFW detection — 100x cheaper and faster than asking an LLM. Returns classification label and boolean is_nsfw flag. Essential for content moderation pipelines. 2 sats per image, pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='detect_nsfw'.
| Argument | Type | Description |
|---|---|---|
| paymentId* | string | Valid payment ID (must be paid) |
| imageBase64* | string | Base64-encoded 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"
}
}
}Detect and locate objects in an image by name. Grounding DINO (open-set detector, ECCV 2024) — describe what to find in natural language, get bounding box coordinates and confidence scores. Structured pixel data agents can't get from vision LLMs. 5 sats per image, pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='detect_objects'.
| Argument | Type | Description |
|---|---|---|
| query* | string | Comma-separated object names to detect (e.g. 'cat, dog, person') |
| paymentId* | string | Valid payment ID (must be paid) |
| imageBase64* | string | Base64-encoded image (PNG, JPEG, WEBP) or data URI |
| box_threshold | number | Confidence threshold for detection boxes (0-1, default 0.25) |
| text_threshold | number | Confidence threshold for text matching (0-1, default 0.25) |
{
"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)"
}
}
}Send a document out for legally binding e-signature and have the signed copy emailed back. Upload the PDF, name up to 3 signers, and give the email where the signed copy should land. Flat 1000 sats per document. The request is fulfilled through an established e-sign provider. The signed copy arrives once every signer has signed, so expect their turnaround — hours to days — not seconds. The API reply acknowledges the request; there is nothing to poll. Privacy: the PDF is processed in memory and never stored. Pay with Bitcoin Lightning — no account, no card. Requires create_payment with toolName='e_signature'.
| Argument | Type | Description |
|---|---|---|
| note | string | Optional note shown to the signers. |
| signers* | array | 1-3 signers, each with a name and email. |
| paymentId* | string | Valid payment ID (must be paid). Price = 1000 sats flat. |
| customerEmail* | string | Your email — the signed copy is sent here once everyone has signed. |
| documentBase64* | string | Base64-encoded PDF to be signed (a data: URI is accepted). Max 8MB. Must be a PDF. |
{
"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."
}
}
}Edit an image with natural language instructions. Uses MAI-Image-2.6, ranked #3 on the Artificial Analysis image-editing leaderboard as of September 2026 — understands context, handles object addition/removal, style transfer, and inpainting. Returns JSON with image URL. 200 sats per edit, one flat price. Pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='edit_image'.
| Argument | Type | Description |
|---|---|---|
| prompt* | string | Editing instructions describing what to change |
| paymentId* | string | Valid payment ID (must be paid) |
| resolution | string | Ignored: MAI-Image-2.6 has no resolution setting. Accepted for compatibility; every edit is 200 sats. |
| aspectRatio | string | Output aspect ratio (default: match_input_image, which keeps the input's shape) |
| imageBase64* | string | Base64 encoded image to edit |
| outputFormat | string | Output format |
| returnBase64 | boolean | 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. |
Hang up a Voice Bridge call, finalize billing, and return a LNURL-withdraw refund link for unused deposit time. Also returns the final transcript for convenience.
| Argument | Type | Description |
|---|---|---|
| sessionId* | string | Session ID from open_voice_bridge |
{
"type": "object",
"required": [
"sessionId"
],
"properties": {
"sessionId": {
"type": "string",
"description": "Session ID from open_voice_bridge"
}
}
}Convert books (EPUB/PDF/TXT) to full audiobooks with automatic chapter detection, multi-voice narration, and optional translation to any language before narration. 3 voice tiers: OmniVoice Global (602+ langs, ~106 chars/sat), Inworld Premium (#1 ranked TTS ELO 1217, ~16 chars/sat), Minimax Studio (voice cloning from reference clip, ~5 chars/sat). Min 500 sats. Async — returns jobId, poll until completed (5-60+ min). Single payment, full outcome — no multi-step orchestration required. Pay with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='epub_to_audiobook'.
| Argument | Type | Description |
|---|---|---|
| speed | number | Speech speed 0.5-2.0 |
| voice | string | 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 | number | Optional. 3 voice tiers: OmniVoice Global (602+ langs), Inworld Premium (#1 ranked), Minimax Studio (voice clone). Omit for default. |
| fileName* | string | Original filename with extension (e.g., 'mybook.epub', 'document.pdf', 'story.txt'). Required to detect format. |
Estimate per-pixel depth from a single photo. Depth Anything V2 (NeurIPS 2024, 3.8M+ runs) returns BOTH the raw greyscale depth map — what a ControlNet, AR or 3D reconstruction pipeline consumes — and a colour visualization for humans. Structured geometry a vision LLM cannot produce. 5 sats per image, pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='estimate_depth'.
| Argument | Type | Description |
|---|---|---|
| paymentId* | string | Valid payment ID (must be paid) |
| model_size | string | Model size — larger is more accurate, price is the same (default Large) |
| imageBase64* | string | Base64-encoded image (PNG, JPEG, WEBP) or data URI |
{
"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"
}
}
}Extract text from PDFs and images as clean Markdown. Uses Mistral OCR — handles complex layouts, tables, handwriting, multi-column documents, and mathematical notation. Preserves document hierarchy in structured Markdown. 10 sats/page. Pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='extract_document' and quantity=pageCount for multi-page PDFs.
| Argument | Type | Description |
|---|---|---|
| modelId | number | Optional. Omit for default model. |
| paymentId* | string | Valid payment ID (must be paid) |
| documentBase64* | string | Base64 encoded PDF or image |
{
"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"
}
}
}Extract structured data from receipts, invoices, and financial documents. Uses a dual-model pipeline (Mistral OCR + Kimi K3) for high-accuracy extraction. Returns JSON with merchant, date, line items, totals, tax, currency, and expense category. Handles crumpled receipts, faded text, and multi-page invoices. 25 sats/page. Pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='extract_receipt'.
| Argument | Type | Description |
|---|---|---|
| paymentId* | string | Valid payment ID (must be paid) |
| documentBase64* | string | 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",
"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."
}
}
}Generate a textured 3D GLB model from EITHER a photo OR a text prompt (provide exactly one, not both). Uses Tencent Hunyuan3D — high-fidelity geometry and PBR materials. Async — returns requestId, poll with check_job_status. 1600 sats per model. Pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='generate_3d_model'.
| Argument | Type | Description |
|---|---|---|
| prompt | string | Text description for text-to-3D (max 1024 chars). Provide EITHER this OR imageBase64, not both. |
| modelId | number | Optional. Omit for default model. |
| paymentId* | string | Valid payment ID (must be paid) |
| imageBase64 | string | Base64 encoded image (PNG, JPEG, or WEBP) for image-to-3D. Provide EITHER this OR prompt, not both. |
{
"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."
}
}
}Generate an image from a text prompt. Returns JSON with image URL. Models: Grok Imagine 2 (fast creative generation, 100 sats), Seedream 5 Pro (most permissive content policy, 150 sats at 1K / 300 at 2K), GPT Image 2.5 (ranked #1 on the Artificial Analysis text-to-image leaderboard as of September 2026, 1200 sats, default). Supports img2img with optional base64 input. Optional aspectRatio (default 1:1) works on every model tier and does not change the price. Stable endpoints — models upgrade automatically as SOTA evolves. Pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='generate_image'.
| Argument | Type | Description |
|---|---|---|
| prompt* | string | Text prompt describing the image |
| modelId | number | Optional. Omit for default (best) model. |
| paymentId* | string | Valid payment ID (must be paid) |
| aspectRatio | string | Optional output shape, default 1:1. Same price for every shape. |
| imageBase64 | string | Optional base64 image for img2img generation |
{
"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"
}
}
}Generate a full song with AI vocals from a style prompt plus lyrics — or an INSTRUMENTAL bed / underscore (background music under video narration, intros, outros) by sending ONLY structure tags and no words. You choose the length: 15-300 seconds at 5 sats/second (75-1500 sats). Specify BPM, key, genre, mood in prompt. Returns a 44.1 kHz 16-bit stereo WAV URL. Structure tags must each be on their OWN line — words on a tag line are DROPPED by the model, which silently shortens the song. Don't want to write lyrics? Set lyricsAddon:true (+25 sats) and optionally lyricsAbout to say what they should be about. Pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='generate_music' AND the same duration (the price is bound to it).
| Argument | Type | Description |
|---|---|---|
| lyrics | string | 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* | string | Music style with BPM, key, genre, mood, instruments (up to 2,000 chars). Example: 'E minor, 90 BPM, acoustic guitar ballad, male vocal' |
| modelId | number | Optional. Omit for default model. |
| duration | integer | Song length in seconds, 15-300. THE PRICE (5 sats/second) — must match the duration sent to create_payment. Default: 15 |
| paymentId* | string | Valid payment ID (must be paid) |
Generate text using frontier AI language models. Pure per-character pricing (no minimum): Kimi K3 (best, ~10 chars/sat, 1M context, default), GPT-OSS-120B (standard, ~1000 chars/sat, 119 languages, best value). Rates are BTC-pegged and re-quoted hourly, so treat them as approximate — the 402 challenge is the authoritative price. Supports document Q&A via fileContext. For images, use the analyze_image tool. Stable endpoints — models upgrade automatically. Pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='generate_text' and the exact prompt.
| Argument | Type | Description |
|---|---|---|
| prompt* | string | The text prompt or question |
| modelId | number | Optional. Omit for default (best) model. |
| fileName | string | Name of the attached file |
| maxTokens | number | Max tokens in response |
| paymentId* | string | Valid payment ID (must be paid) |
| fileContext | string | Extracted file text to include as context |
| imageBase64 | string | Base64 data URI for vision analysis (best model only) |
| systemPrompt | string |
Generate cinematic video from a text prompt. Uses MiniMax H3 — top 2 on the Artificial Analysis text-to-video leaderboard — with native audio. Async — returns requestId, poll with check_job_status. 768p or 2K (2K is upscaled from a 768p render), 5-15 seconds, priced per second by resolution (native audio free). Pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='generate_video' and duration, resolution params.
| Argument | Type | Description |
|---|---|---|
| prompt* | string | Text prompt describing the video |
| modelId | number | Optional. Omit for default model. |
| duration* | number | Duration in seconds (5-15) |
| paymentId* | string | Valid payment ID (must be paid) |
| resolution | string | 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 | boolean | 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 | string | 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. |
Get an exact sat cost quote for a service BEFORE creating a payment. Useful for budget-aware agents to price-check before committing. No payment required, no side effects. Pass service=text-to-speech&chars=1500, service=translate&chars=800, service=transcribe-audio&minutes=5, etc. Returns { amount_sats, breakdown, currency }. Omit params to see the full catalog of supported services.
| Argument | Type | Description |
|---|---|---|
| chars | number | Character count — required for TTS and translate |
| model | string | Optional model id for services with multiple tiers |
| pages | number | Page count — for OCR (default 1) |
| minutes | number | Audio length — required for transcribe-audio |
| seconds | number | Video duration — required for video / video-from-image |
| service | string | Service id (e.g. 'text-to-speech', 'translate', 'image', 'video', 'transcribe-audio', 'ocr'). Omit to list all services. |
{
"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."
}
}
}Get the machine-readable catalog of all error codes this API can return (e.g. TIMEOUT, CONTENT_FILTERED, RATE_LIMITED, L402_REFUND_ISSUED, L402_AUTO_ROUTED). Agents should branch on error_code rather than parsing free-text messages. No payment required.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Retrieve the final output of a completed async job. Call ONLY after check_job_status returns status='COMPLETED' — calling on a job that has not completed returns an error. Returns JSON whose shape depends on jobType: video/video-image → { videoUrl, duration }; image-3d → { modelUrl } (GLB format); transcription → { text, language, segments }; epub-audiobook → { url, annexeUrl, totalChapters, completedChapters } (annexeUrl is a companion PDF of equations, tables, addresses, keys and hashes the narration replaces with a spoken marker; null when the book had none); ai-call → { transcript, duration, summary }. A video or 3D job whose payment was refunded returns error_code RESULT_NOT_AVAILABLE, unless you pass its paymentId: the payer then gets the pending refund (error_code L402_REFUND_ISSUED). An audiobook whose payment was refunded also returns RESULT_NOT_AVAILABLE, with no link: claim the refund at /recover with the payment ID. A web 3D purchase not yet collected on its own page also returns RESULT_NOT_AVAILABLE. All URLs are temporary (valid ~1 hour) — download immediately. This tool is free and does not require payment. Do NOT use for synchronous tools — those return results directly.
| Argument | Type | Description |
|---|---|---|
| jobType* | string | 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 fallback jobType generate_video returns when the primary video model is at capacity. |
| paymentId | string | The paymentId that bought this job. On a failed or refunded 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 |
Get pricing for a specific model by ID. No payment required.
| Argument | Type | Description |
|---|---|---|
| modelId* | number | string | The AI model database ID from list_models. A numeric string ("16") is accepted and coerced. |
{
"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."
}
}
}Discover available AI models with numeric IDs, tier labels, capabilities, and per-call pricing in sats. Call this before create_payment to find the right modelId for your task. Returns JSON array: [{ id, name, tier, description, price, isDefault, category }]. Models marked isDefault=true are used when you omit modelId from create_payment. Filter by category to narrow results to a specific tool. This tool is free, requires no payment, and is idempotent — safe to call repeatedly.
| Argument | Type | Description |
|---|---|---|
| category | string | Filter by service category (matches tool names) |
{
"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)"
}
}
}List all planned services with current vote counts. Returns JSON array: [{ slug, name, description, votes }], sorted by votes descending. No payment required — this is a free discovery tool. Use the slug values with vote_on_service to cast votes. This tool is idempotent and safe to call repeatedly.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Merge multiple PDF files into a single document. Preserves bookmarks, links, and formatting. Returns JSON: { url } — a temporary download URL (valid ~1 hour). Minimum 2 files, no maximum. Files are concatenated in array order. 100 sats per merge regardless of file count. Use convert_file instead if you need format conversion (e.g., DOCX→PDF). Pay per request with Bitcoin Lightning — no API key, no account needed. Requires create_payment with toolName='merge_pdfs'.
| Argument | Type | Description |
|---|---|---|
| files* | array | Array of base64-encoded PDF files (minimum 2) |
| paymentId* | string | Valid payment ID (must be paid) |
{
"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)"
}
}
}Ask a frontier AI a question in your OWN language and get the answer back in that same language, in ONE payment. We translate the question to English, answer it with a frontier model, then translate the answer back. Two engines behind one endpoint: 119 mainstream languages use the LLM translate tier; anything those models do not serve falls through to MADLAD-400 on our own GPU (452 languages, 251 of which ChatGPT, Claude and Gemini do not support at all). So a Wolaytta, Tiv or Q'eqchi' speaker gets frontier reasoning in their own language, which no other API offers. Rare-language quality is uneven and published per language - GET https://sats4ai.com/api/languages. Priced from question length plus a fixed 2000-character answer allowance at the chosen tier's rate; the rare-language path costs more (GPU both ways). Requires create_payment with toolName='multilingual_ask' AND the `language` you intend to use - the quote depends on it.
| Argument | Type | Description |
|---|---|---|
| model | string | Standard | Better | Best. Best is Kimi K3 and costs materially more. Must match the create_payment quote. |
| language* | string | Language to answer in. English name ('Igbo'), ISO-639 code ('ig'), or a rare-language code ('wal'). Rejected before payment if unsupported. |
| question* | string | Your question, in your own language. Max 4000 characters. |
| paymentId* | string | Valid payment ID (must be paid), quoted for THIS language and tier. |
{
"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."
}
}
}Open a phone call you drive one turn at a time: we dial, transcribe what the other side says, and speak whatever text you send. You call voice_bridge_say to talk, poll_voice_bridge to read transcripts, end_voice_bridge to hang up. ⚠ Turn-based, NOT full-duplex conversation. After the callee stops talking, about 2 seconds of ours pass before your reply starts to play (we recognise the end of their turn, then speech starts under a second after you send the text), on top of your own model's thinking time: slower than the ~0.8s a natural back-and-forth needs. The callee cannot interrupt you while you speak. Pass filler (a short phrase such as 'One moment, please.') to cover a slow reply: we say it once if you have not started answering about 3.5 seconds after they stop. The loop: poll_voice_bridge with waitMs (e.g. 20000) returns when the callee has finished talking; answer with a short voice_bridge_say (one or two sentences); repeat. Good for: leaving a spoken message, navigating a voice-driven IVR (keypad tones are not supported yet), reading something out, a slow exchange where a pause is fine. For a real conversation with a human, use ai_call — we run the agent at conversational speed and return the transcript. Unused deposit time is refunded automatically when the call ends — including when the callee hangs up. Pass refundAddress (a Lightning address) and the remainder is SENT there with no further action; without it the refund is held as a claimable LNURL-withdraw link returned by end_voice_bridge. Use this when the content of the call must never leave your side, and the pace can tolerate a pause between turns. When NOT to use: not for fully-managed agent-style calls where we handle the brain (use ai_call). Not for one-shot TTS broadcasts or IVR playback (use place_call). Not when live transcript polling adds no value — the per-turn overhead isn't worth it. Privacy: transcripts held in memory only, garbage-collected 30 minutes after the call ends; call audio is never persisted. Pay with Bitcoin Lightning — no telecom account, no signup. Requires create_payment with toolName='voice_bridge_open', phoneNumber, durationMinutes. Deposit is priced per destination off the carrier rate sheet and is BTC-pegged, so call create_payment for the exact figure; premium-rate and satellite ranges are refused.
| Argument | Type | Description |
|---|---|---|
Bridge the digital-physical gap — place an automated phone call to deliver a spoken message or play audio to any number. Useful when your task requires notifying a human, delivering alerts, or reaching someone who isn't online. Pay with Bitcoin Lightning — no telecom account, no KYC, no subscription. Requires create_payment with toolName='place_call' and phoneNumber. The message plays first. Then a short spoken notice names the service and how to stop these calls: call the number back, or go to sats4ai.com/c. The notice fits the prepaid minutes. 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.
| Argument | Type | Description |
|---|---|---|
| message | string | Text to speak via TTS; must fit prepaid minutes including the closing spoken notice (about 12 s). Provide this OR audioUrl. |
Fetch new transcript events from an open Voice Bridge call since the last cursor. Returns partial + final transcripts + system events. Pass waitMs (e.g. 20000) to hold the call until the callee has FINISHED TALKING (a final transcript, then 0.7 s of silence) or the call changes state, then get everything at once: no polling timer, and you do not answer in the middle of their sentence. Without waitMs, poll in a loop (~500ms-1s) and decide yourself when they are done. No additional payment.
| Argument | Type | Description |
|---|---|---|
| cursor | number | Last seq number seen (default 0 = start from beginning) |
| waitMs | number | Optional. Hold the call up to this many milliseconds (max 25000) until the callee has finished talking: a FINAL transcript has arrived and nothing new for quietMs, or a system event arrives. Then everything since the cursor is returned at once. Partial transcripts alone do not end the wait. Default 0 = return immediately. |
| quietMs | number | Optional, used with waitMs. How many milliseconds of silence after a final transcript count as 'finished talking' (0-5000, default 700). 0 = return at the first final transcript, even mid-sentence. |
| sessionId* | string | Session ID from open_voice_bridge |
{
"type": "object",
"required": [
"sessionId"
],
"properties": {
"cursor": {
"type": "number",
"description": "Last seq number seen (default 0 = start from beginning)"
},
"waitMs": {
"type": "number",
"description": "Optional. Hold the call up to this many milliseconds (max 25000) until the callee has finished talking: a FINAL transcript has arrived and nothing new for quietMs, or a system event arrives. Then everything since the cursor is returned at once. Partial transcripts alone do not end the wait. Default 0 = return immediately."
},
"quietMs": {
"type": "number",
"description": "Optional, used with waitMs. How many milliseconds of silence after a final transcript count as 'finished talking' (0-5000, default 700). 0 = return at the first final transcript, even mid-sentence."
},
"sessionId": {
"type": "string",
"description": "Session ID from open_voice_bridge"
}
}
}When you're expecting a fax back — bank confirmation, court filing, signed document — open a 24h receive window at our shared number +1 320 299 1523. Matched by caller ID (last 10 digits of the sender), delivered to your email as soon as it arrives. Optional OCR add-on (+200 sats) returns a searchable text file alongside the PDF — useful for feeding the content to an agent or archiving. Optional callback_url POSTs an HMAC-signed webhook on delivery so your agent doesn't have to poll. No refund if no fax arrives within the window (prevents subscription squatting). If OCR fails, an LNURL-withdraw for 200 sats is included in the delivery email for partial refund. Pay with Bitcoin Lightning — no dedicated fax number rental, no monthly subscription, no account.
| Argument | Type | Description |
|---|---|---|
| ocr | boolean | Add OCR text extraction (+200 sats). Default: false. |
| email* | string | Email address to deliver the fax PDF to |
| paymentId* | string | Valid payment ID (must be paid) |
| fromNumber* | string | Expected sender fax number in E.164 format (matched by last 10 digits of caller ID) |
| callback_id | string | Optional opaque correlation string (max 128 chars). Echoed in the webhook body. |
| callback_url | string | Optional HTTPS webhook URL. POSTed (HMAC-signed) when fax is delivered. Public HTTPS only — no loopback/RFC1918. |
Remove background from any image, returning transparent PNG. Uses BiRefNet (state-of-the-art, Papers with Code — Sm 0.901 on DIS5K). Handles hair, fur, glass, transparency, and complex edges. Stable endpoint — model upgrades automatically as SOTA evolves. 44 sats per image, pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='remove_background'.
| Argument | Type | Description |
|---|---|---|
| paymentId* | string | Valid payment ID (must be paid) |
| imageBase64* | string | Base64-encoded 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"
}
}
}Remove unwanted objects from images by describing what to remove — no mask needed. Combines Grounding DINO detection (ECCV 2024) with Bria Eraser inpainting. Just say 'person', 'car', or 'watermark' and the object is erased and filled convincingly. 130 sats per image, pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='remove_object'.
| Argument | Type | Description |
|---|---|---|
| query* | string | What to remove (e.g. 'person', 'car', 'watermark', 'text') |
| paymentId* | string | Valid payment ID (must be paid) |
| imageBase64* | string | Base64-encoded image (PNG, JPEG, WEBP) or data URI |
| box_threshold | number | Detection confidence threshold (0-1, default 0.25) |
| text_threshold | number | Text matching threshold (0-1, default 0.25) |
{
"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)"
}
}
}Render a typographic card — headline, versus (two columns), list, stat (one big number) or quote — as a PNG or JPEG at 1920x1080 or 2560x1440. Deterministic layout, no AI model: the text you send is exactly what appears, which no image generator can promise. Built for video title cards and slides, thumbnails, quote cards and social posts. Lists and comparisons REVEAL one beat at a time (revealed:N / show_right:false) — render N states and cut between them, and the text never shifts. Optional theme (hex colours). Text coverage: Latin, Greek and Cyrillic (DejaVu Sans) with Noto Sans fallback for Arabic, Indic, Thai, Chinese, Japanese and Korean; emoji render as single-colour silhouettes in the text colour, not in full colour. Returns { url, width, height, format, mime, expires_in_seconds } — the url is a signed download valid 2 h; fetch it, the image is not inlined. Hard caps: 3 lines x 40 chars, 6 items x 40 chars — a spec over a cap is refused BEFORE payment. 5 sats per card. Pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='render_card'.
| Argument | Type | Description |
|---|---|---|
| sub | string | stat: small line above the number, e.g. a year |
| left | string | versus: left value (up to 22 chars) |
| size | string | Output size (default 1920x1080) |
| text | string | quote: the quoted words (up to 30 chars) |
| items | array | list: 1-6 items, each up to 40 chars; the last revealed item is drawn in the accent colour |
| label | string |
Open a MANUAL 48-hour refund review ticket for a service that FAILED (error, timeout, wrong output). Sends an email to the operator. DO NOT call this for unused-minute refunds on metered services (ai_call, voice_bridge) — those are returned automatically as an LNURL-withdraw link in the service's own response under `refund.lnurl_withdraw`, no manual ticket needed. If you call this on a metered payment that already has a pending LNURL refund, this tool will detect it and return the existing LNURL instead of creating a duplicate ticket. CLAIM WINDOW: refunds must be claimed within 30 days — after that the LNURL link stops working and the refund expires, so do not bank a link for later.
| Argument | Type | Description |
|---|---|---|
| string | Optional email address for follow-up | |
| invoice* | string | Lightning address (e.g., [email protected]) or bolt11 invoice for the refund |
| feedback | string | Optional description of what went wrong (max 2000 chars) |
| paymentId* | string | The payment ID from a failed service call |
{
"type": "object",
"required": [
"paymentId",
"invoice"
],
"properties": {
"email": {
"type": "string",
"description": "Optional email address for follow-up"
},
"invoice": {
"type": "string",
"description": "Lightning address (e.g., [email protected]) 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"
}
}
}Restore blurry, damaged, or AI-generated faces to sharp, natural quality. Uses CodeFormer (NeurIPS 2022, state-of-the-art FID 32.65 on CelebA-Test). Adjustable fidelity — balance between quality enhancement and identity preservation. Also enhances background and upsamples. Stable endpoint — model upgrades automatically as SOTA evolves. 25 sats per image, pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='restore_face'.
| Argument | Type | Description |
|---|---|---|
| upscale | number | Output upscale factor 1-4 (default 2) |
| fidelity | number | Fidelity to input: 0.0 = max quality enhancement, 1.0 = max identity preservation (default 0.5) |
| paymentId* | string | Valid payment ID (must be paid) |
| imageBase64* | string | Base64-encoded image containing faces (PNG, JPEG, WEBP) or data URI |
| face_upsample | boolean | Upsample restored faces (default true) |
| background_enhance | boolean | Also enhance the background (default true) |
{
"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)"
}
}
}Reach anyone with an email address — useful when your task requires formal communication, sending reports, or contacting someone outside chat. No SMTP server, no domain verification needed. Plain text, max 10,000 chars body, 200 chars subject. 200 sats. Pay with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='send_email'.
| Argument | Type | Description |
|---|---|---|
| to* | string | Recipient email address |
| body* | string | Email body text (plain text, max 10,000 characters) |
| replyTo | string | Optional reply-to email address |
| subject* | string | Email subject (max 200 characters) |
| paymentId* | string | 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. |
When your task requires a paper-trail on the other end — loan paperwork to a bank, signed contract to a notary, booking confirmation to a hotel in Japan — send a fax to any number worldwide. Two modes: 'pdf' (fetch from public URL) or 'text' (we format typed text into a PDF locally). Text/cover support Latin (incl. Central European, Vietnamese), Greek, Cyrillic, Japanese, Korean, Chinese (Simplified + Traditional), Thai, Hindi, Georgian, Armenian, Amharic; RTL scripts (Arabic/Hebrew) and emoji are rejected BEFORE your payment is consumed. Optional cover page. Pricing: 500 sats for up to 10 pages, +50 sats per additional page. Max 350 pages / 50 MB. Pass 'pages' to create_payment as 'quantity' to get the right invoice. Pay with Bitcoin Lightning — no fax machine, no phone line, no telecom account.
| Argument | Type | Description |
|---|---|---|
| mode* | string | 'pdf' = send PDF from pdfUrl. 'text' = generate PDF from typed text. |
| text | string | Required for mode=text: message text to format as PDF |
| pages | number | Expected page count (1-350). Used for pricing. Pass same value to create_payment as 'quantity'. |
| pdfUrl | string | Required for mode=pdf: public HTTPS URL returning application/pdf |
| coverText | string | Optional cover page text (mode=pdf only, adds 1 page) |
| paymentId* |
Reach a human via SMS when your task requires real-world coordination. Send to any phone number worldwide — delivery timing varies by destination. No phone plan, no SIM card, no telecom account needed. Pay with Bitcoin Lightning — no API key, no KYC, no subscription. Requires create_payment with toolName='send_sms' and phoneNumber+message at payment time. The phoneNumber must match the one used in create_payment. The message must not need more SMS segments than were paid for. Free rules, refused before payment, with no invoice: no links in the text, a send limit per destination number, and no number on our do-not-contact list. A paid send checks the limit and the list again; a refusal then refunds in full. A link added after payment is held, not refunded: a link is never sent. A US number: Queued. A text to a US number can take a few hours to arrive. Each SMS ends with a short signature line naming the service and a safety/stop link, within the paid segment count. 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.
| Argument | Type | Description |
|---|
Text-to-speech with 3 tiers: OmniVoice Global (602+ languages including Yoruba, Bengali, Cebuano, Twi, voice design, ~106 chars/sat — use 'language' parameter with ISO code), Inworld Premium (#1 ranked TTS ELO 1217, emotion control, 40+ languages, ~16 chars/sat), Minimax Studio (voice cloning from reference clip, 40+ languages, ~5 chars/sat). Adjustable speed (0.5-2.0x). Returns audio URL. Pay with Bitcoin Lightning — no API key or signup needed. When NOT to use: not for phone calls (use place_call for one-shot broadcasts, ai_call for AI voice agents, or open_voice_bridge to drive the call with your own LLM). For rare/underserved languages (Yoruba, Twi, Marathi, Cebuano, etc.), pick OmniVoice Global via language= — Inworld/Minimax don't cover these. Requires create_payment with toolName='text_to_speech'.
| Argument | Type | Description |
|---|---|---|
| text* | string | Text to convert to speech |
| speed | number | Speech speed multiplier (0.5-2.0) |
| voice | string | Voice ID. 467 total voices. Use list_models to see available TTS models. Or paste a custom cloned voice ID. ## Minimax Studio — voice cloning from reference clip, ~5 chars/sat (332 voices) ### Arabic (2) Arabic_CalmWoman (Female, Middle Aged, Serene, calm female); Arabic_FriendlyGuy (Male, Middle Aged, Warm, friendly male) ### Cantonese (6) Cantonese_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) ### Chinese (34) Chinese (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) ### Czech (3) czech_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) ### Dutch (2) Dutch_kindhearted_girl (Female, Young, Compassionate, kind young female); Dutch_bossy_leader (Male, Middle Aged, Commanding, bossy male) ### English (45) English_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) ### Finnish (3) finnish_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) ### French (6) French_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) ### German (3) German_FriendlyMan (Male, Middle Aged, Warm, friendly male); German_SweetLady (Female, Middle Aged, Sweet, gentle female); German_PlayfulMan (Male, Middle Aged, Fun, playful male) ### Greek (3) greek_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) ### Hindi (3) hindi_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) ### Indonesian (9) Indonesian_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) ### Italian (4) Italian_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) ### Japanese (15) Japanese_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) ### Korean (49) Korean_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) ### Polish (4) Polish_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) ### Portuguese (73) Portuguese_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) ### Romanian (4) Romanian_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) ### Russian (8) Russian_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) ### Spanish (47) Spanish_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) ### Thai (4) Thai_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) ### Turkish (2) Turkish_CalmWoman (Female, Middle Aged, Serene, calm female); Turkish_Trustworthyman (Male, Middle Aged, Reliable, trustworthy male) ### Ukrainian (2) Ukrainian_CalmWoman (Female, Middle Aged, Serene, calm female); Ukrainian_WiseScholar (Male, Old, Learned, scholarly male) ### Vietnamese (1) Vietnamese_kindhearted_girl (Female, Young, Compassionate, kind young female) ## Inworld Max Premium — #1 ranked TTS, ~16 chars/sat (135 voices) ### Arabic (2) Nour (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) ### Chinese (4) Jing (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) ### Dutch (4) Erik (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) ### English (95) Abby (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) ### French (4) Alain (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) ### German (2) Johanna (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) ### Hebrew (2) Oren (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) ### Hindi (2) Manoj (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) ### Italian (2) Gianni (Male, Middle Aged, Deep, smooth Italian male voice that speaks rapidly); Orietta (Female, Middle Aged, Calm adult female Italian voice, with a soothing cadence) ### Japanese (2) Asuka (Female, Middle Aged, Friendly, young adult Japanese female voice); Satoshi (Male, Middle Aged, Dramatic, expressive male Japanese voice filled with energy) ### Korean (4) Hyunwoo (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) ### Polish (2) Szymon (Male, Middle Aged, Polish adult male voice with a warm, friendly quality); Wojciech (Male, Middle Aged, A middle-aged Polish male voice) ### Portuguese (2) Heitor (Male, Middle Aged, Composed Portuguese-speaking male voice with a neutral tone); Maitê (Female, Middle Aged, Middle-aged Portuguese-speaking female voice) ### Russian (4) Dmitry (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) ### Spanish (4) Diego (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) |
Transcribe audio to text with WORD-LEVEL timestamps (timestamps:'word' returns per-word start/end times — subtitle alignment, karaoke captions, cutting video to speech) or segment timestamps. Uses Mistral Transcription — high-accuracy speech recognition that handles accents, background noise, and overlapping speakers. 13 languages: en, zh, hi, es, ar, fr, pt, ru, de, ja, ko, it, nl. Pass names (the people and places spoken in the audio) to help the speech model spell them right — free, same price. Up to 500 MB / 60 minutes per file. Async — returns requestId, poll with check_job_status(jobType='transcription'), then get_job_result. 10 sats/min. Privacy: audio and transcripts are ephemeral — processed, returned, and discarded. Never persisted. Pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='transcribe_audio'.
| Argument | Type | Description |
|---|---|---|
| names | array | Optional: the names and places spoken in the audio (characters, people, towns), e.g. ["Siobhan", "Tadhg", "Chicoutimi"]. It helps the speech model spell them right. Free: the price does not change. We send up to 100At most 4000 characters of names. List names only: a name that sounds like an ordinary word can replace that word in the transcript ("Noone" for "noon"). If the model refuses the list, you still get the transcript, without it, and result.degraded includes "names". |
| diarize | boolean | 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 | string | Optional. One of: detect (the default), en, zh, hi, es, ar, fr, pt, ru, de, ja, ko, it, nl. A locale tag (en-US) or the English name (French) also works; "auto" means detect. |
| paymentId |
Compound endpoint — one payment turns audio in any of 13 source languages into both a transcript AND a translation in any of 119 target languages. Perfect for WhatsApp voice messages in a language you don't speak (Yoruba → English), or recording a meeting in another language and reading it in yours. Auto-detects source if omitted. Pass names (the people and places spoken in the audio) to help the speech model spell them right — free, same price. Async — returns requestId, poll with check_job_status(jobType='transcribe-translate'). Flat price covers STT + translation. Cheaper than calling transcribe_audio + translate_text separately for typical voice messages. Pay with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='transcribe_translate'.
| Argument | Type | Description |
|---|---|---|
| names | array | Optional: the names and places spoken in the audio (characters, people, towns), e.g. ["Siobhan", "Tadhg", "Chicoutimi"]. It helps the speech model spell them right. Free: the price does not change. We send up to 100At most 4000 characters of names. List names only: a name that sounds like an ordinary word can replace that word in the transcript ("Noone" for "noon"). If the model refuses the list, you still get the transcript, without it, and result.degraded includes "names". |
| paymentId* | string | Valid payment ID (must be paid) |
| audioBase64* | string | Base64-encoded audio file |
| sourceLanguage | string | 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. |
Translate a whole EPUB into another language and get an EPUB back. Every chapter is translated with its markup intact — headings, emphasis, footnote links, images and code stay where they were — the package language is retargeted and the table of contents is translated. 119 target languages; the target language picks the engine and the engine's row carries the price (same per-character rate as translate_text for that language, min 50 sats). Async — returns requestId, poll with check_job_status(jobType='translate-epub'), then get_job_result for the download url (temporary, 6h). Pay with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='translate_epub', characterCount (visible characters of the book) and targetLanguage; the real file is re-priced at execution and a short-pay is refunded with the exact amount to re-pay.
| Argument | Type | Description |
|---|---|---|
| fileName | string | Optional original filename, used to name the download. |
| paymentId* | string | Valid payment ID (must be paid) |
| epubBase64* | string | Base64-encoded EPUB (max 50 MB) |
| sourceLanguage | string | Optional source-language hint. Omit to let the model read it from the text. |
| targetLanguage* | string | Target language — English name (e.g. 'Spanish') or ISO-639 code (e.g. 'es'). Must equal the targetLanguage the payment was quoted with. |
Translate into 452 languages, 251 of them NOT supported by ChatGPT, Claude or Gemini (29 of those 251 measured at fair quality or better against human references) — including Bhojpuri (~50M speakers), Maithili (~34M), Egyptian Arabic (~100M), Moroccan Arabic (~30M), Chhattisgarhi, Magahi, Manipuri, Kashmiri, Shan, Kachin, Awadhi, Tamazight, Crimean Tatar, Quechua, Nuer, Sango, plus indigenous and minority languages with no callable API anywhere. Runs MADLAD-400 (Apache-2.0). QUALITY VARIES AND IS PUBLISHED PER LANGUAGE: every language carries a measured tier — good (chrF++ >= 45 vs human reference translations), fair (32-45), unverified (no benchmark exists, untested, may be poor), experimental (known weak). The response repeats the tier so you can judge how much to trust it. GET https://sats4ai.com/api/l402/translate-rare-language for the full language list with tiers, or GET /api/languages. Unsupported languages are rejected BEFORE payment. For mainstream languages use translate_text instead — it is cheaper and more fluent. Priced 50 sats base + 0.002 sats/char (GPU). Pay with Bitcoin Lightning — no API key or signup. Requires create_payment with toolName='translate_rare_language'.
| Argument | Type | Description |
|---|---|---|
| text* | string | Text to translate. Max 6000 characters. |
| paymentId* | string | Valid payment ID (must be paid). Price = 50 sats + 0.002/char. |
| targetLanguage* | string | 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. 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."
}
}
}Translate text across 119 languages with high accuracy. The target language picks the engine: GPT-OSS 120B by default, or a higher-scoring model (Gemini) where one measurably beats it. Auto-detects source language. Privacy-preserving: no data stored. Pricing: 1 sat per 1,000 characters on the standard engine, minimum 1 sat per request; a routed language costs more. GET /api/languages returns the exact price, engine and measured chrF for every language, and the 402 always quotes the real amount before you pay. Language parameters accept English names ('Spanish', 'Chinese (Simplified)') or ISO-639 codes / locale tags ('es', 'en-US', 'pt-BR', 'zh-Hans'). Supported languages: Afrikaans, Albanian, Amharic, Arabic, Armenian, Assamese, Azerbaijani, Basque, Belarusian, Bengali, Bosnian, Bulgarian, Burmese, Catalan, Cebuano, Chichewa, Chinese (Simplified), Chinese (Traditional), Corsican, Croatian, Czech, Danish, Dari, Dutch, English, Esperanto, Estonian, Farsi, Fijian, Filipino, Finnish, French, Frisian, Galician, Georgian, German, Greek, Guarani, Gujarati, Haitian Creole, Hausa, Hawaiian, Hebrew, Hindi, Hmong, Hungarian, Icelandic, Igbo, Indonesian, Irish, Italian, Japanese, Javanese, Kannada, Kazakh, Khmer, Kinyarwanda, Korean, Kurdish, Kyrgyz, Lao, Latvian, Lingala, Lithuanian, Luganda, Luxembourgish, Macedonian, Malagasy, Malay, Malayalam, Maltese, Maori, Marathi, Mongolian, Nepali, Norwegian, Occitan, Odia, Pashto, Polish, Portuguese, Punjabi, Romanian, Romansh, Russian, Samoan, Scots Gaelic, Serbian, Sesotho, Setswana, Shona, Sindhi, Sinhala, Slovak, Slovenian, Somali, Spanish, Sundanese, Swahili, Swedish, Tajik, Tamil, Tatar, Telugu, Thai, Tigrinya, Tongan, Turkish, Turkmen, Ukrainian, Urdu, Uzbek, Vietnamese, Welsh, Wolof, Xhosa, Yiddish, Yoruba, Zulu. Pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='translate_text' and prompt (the text to translate).
| Argument | Type | Description |
|---|---|---|
| text* | string | Text to translate |
| modelId | number | Optional. Translation model is selected automatically. |
Upscale images 2x or 4x with neural super-resolution. Uses Real-ESRGAN (ICCV 2021, PSNR 32.73dB on Set5 4x, 100M+ production runs). Recovers real detail from low-resolution images — not interpolation. Optional face enhancement. Stable endpoint — model upgrades automatically as SOTA evolves. 5 sats per image, pay per request with Bitcoin Lightning — no API key or signup needed. Requires create_payment with toolName='upscale_image'.
| Argument | Type | Description |
|---|---|---|
| scale | string | Upscale factor: 2x or 4x (default 4x) |
| paymentId* | string | Valid payment ID (must be paid) |
| imageBase64* | string | Base64-encoded image (PNG, JPEG, WEBP) or data URI |
| face_enhance | boolean | Apply face enhancement during upscaling (default false) |
{
"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)"
}
}
}Inject audio into an open Voice Bridge call. Two modes: (1) text — we synthesize speech in any of 602 languages (English, Spanish and German start fastest); (2) audio_base64 + encoding — bring your own audio (mulaw_8000 or pcm_l16_16000 for MVP). Keep each reply to one or two sentences: the call is turn-based. While you speak, the callee cannot interrupt, and what they say is NOT heard (transcription is muted so you do not hear yourself, and for under a second after). One call takes at most 700 speech units of text, about 45 seconds of speech (each Chinese, Japanese, Korean or Thai character counts 3): send a longer message as several calls. The call returns when the speech has finished playing. If it fails after part of the line was spoken, the error says so: do not repeat the start. No additional payment — covered by the session deposit.
| Argument | Type | Description |
|---|---|---|
| text | string | Text to speak (mode 1). One or two sentences work best; at most 700 speech units (each Chinese, Japanese, Korean or Thai character counts 3), longer is refused with a 400. |
| encoding | string | Encoding of audioBase64. mp3/opus require ffmpeg (not yet wired in MVP). |
| language | string | Language override for this utterance (default: session language) |
| sessionId* | string | Session ID from open_voice_bridge |
| audioBase64 | string | Pre-rendered audio bytes, base64 (mode 2). Use with 'encoding'. |
| voiceDescription | string |
Vote for a planned service to be built next. Returns JSON: { success, slug, newVoteCount }. 1 sat per vote — multiple votes allowed. Call list_planned_services first to discover valid slugs and current vote counts. Highest-voted services get prioritized. Requires create_payment with toolName='vote_on_service'.
| Argument | Type | Description |
|---|---|---|
| slug* | string | Service slug to vote for (from list_planned_services) |
| paymentId* | string | Valid payment ID (1 sat, must be paid) |
{
"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)"
}
}
}| message | string | Required for send_sms: message text (max 1544 chars; billed per SMS segment, so longer or accented messages cost more) |
| modelId | number | Optional. AI model ID from list_models. Omit for default (best) model. |
| duration | number | Required for generate_video / animate_image: duration in seconds (5-15) |
| quantity | number | 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* | string | Tool name to pay for (e.g., 'generate_text', 'generate_image', 'generate_video', 'send_sms', 'place_call') |
| resolution | string | 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 | string | For generate_text: include extracted file text if attaching a file (affects price) |
| phoneNumber | string | Required for send_sms and place_call: phone in E.164 format (e.g., +14155550100) |
| systemPrompt | string | For generate_text: include if using a custom system prompt (affects price) |
| characterCount | number | 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 | boolean | Accepted and IGNORED — H3 audio is native and always on, at no extra cost. There is no way to request a silent render. |
| durationMinutes | number | 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": [
"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",
"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."
}
}
}| language |
| string |
| 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* | string | Valid payment ID (must be paid) |
| epubBase64* | string | Base64-encoded book file (EPUB, PDF, or TXT) |
| translateToLanguage | string | 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 | array | 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",
"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."
}
}
}| lyricsAbout | string | Optional, with lyricsAddon: what the lyrics should be about. Omit and the subject is inferred from your music prompt. |
| lyricsAddon | boolean | 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": {
"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."
}
}
}| Optional system prompt |
{
"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"
}
}
}| reference_image | string | 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": [
"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."
}
}
}| string |
| The requestId returned by the original async tool — same ID used with check_job_status |
{
"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 fallback jobType generate_video returns when the primary video model is at capacity."
},
"paymentId": {
"type": "string",
"description": "The paymentId that bought this job. On a failed or refunded 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"
}
}
}| codec |
| string |
| PCMU 8kHz (default, universal) or L16_16000 for HD voice when both endpoints support it |
| filler | string | Optional. A short phrase (at most 60 characters) we say ONCE when you are slow: if about 3.5 seconds pass after the callee stops talking and your voice_bridge_say has not started, the callee hears it, so they know you are still there. Example: "One moment, please." Write it in the callee's language. It is made while the phone rings and spoken in our default voice. It plays at most once until you speak again, the callee is not heard while it plays, and poll_voice_bridge then shows a filler_played event (do not say "one moment" yourself). Leave it out for a voicemail or a phone menu, where it is noise, and when you wait for long pauses (quietMs of several seconds): it would fire inside the pause and cut into their next words. |
| greeting | string | 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 | string | BCP-47 language tag (default en-US). See /api/l402/voice-bridge/coverage for the matrix. |
| paymentId* | string | Valid payment ID from create_payment (toolName=voice_bridge_open) |
| sttEnabled | boolean | Default true. Set false for TTS-only broadcast calls. |
| ttsEnabled | boolean | Default true. Set false to bring-your-own-audio via voice_bridge_say. |
| phoneNumber* | string | Destination phone number in E.164 format (e.g., +14155550100) |
| refundAddress | string | Lightning address (e.g. [email protected]). 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 | number | Deposit for N minutes, 2-30 (default 3). Unused time refunded. |
{
"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"
},
"filler": {
"type": "string",
"maxLength": 60,
"description": "Optional. A short phrase (at most 60 characters) we say ONCE when you are slow: if about 3.5 seconds pass after the callee stops talking and your voice_bridge_say has not started, the callee hears it, so they know you are still there. Example: \"One moment, please.\" Write it in the callee's language. It is made while the phone rings and spoken in our default voice. It plays at most once until you speak again, the callee is not heard while it plays, and poll_voice_bridge then shows a filler_played event (do not say \"one moment\" yourself). Leave it out for a voicemail or a phone menu, where it is noise, and when you wait for long pauses (quietMs of several seconds): it would fire inside the pause and cut into their next words."
},
"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. [email protected]). 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."
}
}
}| audioUrl |
| string |
| Public URL to audio file. Provide this OR message. |
| paymentId* | string | Valid payment ID (must be paid) |
| phoneNumber* | string | Phone number in E.164 format (e.g., +14155550100) |
| durationMinutes | number | Duration in minutes (1-30). Required for audioUrl. |
{
"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": [
"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."
}
}
}| stat: caption under the number (up to 60 chars) |
| lines | array | headline: 1-3 lines, each up to 40 characters |
| right | string | versus: right value, drawn in the accent colour |
| theme | object | Optional hex colours: background, foreground, accent, muted (default: near-black ground, Bitcoin-orange accent) |
| title | string | list: small caps title (up to 40 chars) |
| value | string | stat: the big number (up to 12 chars), e.g. '34 Md $' |
| format | string | Output format (default png) |
| source | string | quote: attribution line (up to 60 chars) |
| variant* | string | Card layout |
| revealed | integer | list: how many items are shown (default all) — render 1..N for a beat-by-beat reveal |
| paymentId* | string | Valid payment ID (must be paid) |
| left_label | string | versus: small label over the left value (up to 28 chars) |
| show_right | boolean | versus: false renders the left column only (first beat of a two-state reveal) |
| accent_line | integer | headline: index of the line drawn in the accent colour |
| right_label | string | versus: small label over the right value |
{
"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",
"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."
}
}
}| string |
| Valid payment ID (must be paid) |
| phoneNumber* | string | Destination fax number in E.164 format (e.g. +14155550100) |
{
"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)"
}
}
}| message* | string | Message text (max 1544 chars — a short signature line is appended; billed per SMS segment) |
| paymentId* | string | Valid payment ID (must be paid) |
| phoneNumber* | string | 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",
"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."
}
}
}| modelId | number | 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 | string | 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* | string | Valid payment ID (must be paid) |
| voice_description | string | 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",
"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": {
"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."
}
}
}| string |
| Valid payment ID (must be paid) |
| timestamps | string | 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* | string | Base64 encoded audio file |
| callback_id | string | Optional correlation string echoed back in the webhook body. Max 128 chars. |
| callback_url | string | Optional HTTPS webhook we POST when the job finishes (HMAC-signed). Polling still works. |
{
"type": "object",
"required": [
"paymentId",
"audioBase64"
],
"properties": {
"names": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional: the names and places spoken in the audio (characters, people, towns), e.g. [\"Siobhan\", \"Tadhg\", \"Chicoutimi\"]. It helps the speech model spell them right. Free: the price does not change. We send up to 100At most 4000 characters of names. List names only: a name that sounds like an ordinary word can replace that word in the transcript (\"Noone\" for \"noon\"). If the model refuses the list, you still get the transcript, without it, and result.degraded includes \"names\"."
},
"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": "Optional. One of: detect (the default), en, zh, hi, es, ar, fr, pt, ru, de, ja, ko, it, nl. A locale tag (en-US) or the English name (French) also works; \"auto\" means detect."
},
"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."
}
}
}| targetLanguage* | string | Target language — English name (e.g. 'Spanish') or ISO-639 code (e.g. 'es', 'en-US'). 119 languages supported. |
{
"type": "object",
"required": [
"paymentId",
"audioBase64",
"targetLanguage"
],
"properties": {
"names": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional: the names and places spoken in the audio (characters, people, towns), e.g. [\"Siobhan\", \"Tadhg\", \"Chicoutimi\"]. It helps the speech model spell them right. Free: the price does not change. We send up to 100At most 4000 characters of names. List names only: a name that sounds like an ordinary word can replace that word in the transcript (\"Noone\" for \"noon\"). If the model refuses the list, you still get the transcript, without it, and result.degraded includes \"names\"."
},
"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."
}
}
}| paymentId* | string | Valid payment ID (must be paid) |
| sourceLanguage | string | 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* | string | 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",
"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."
}
}
}| 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": [
"sessionId"
],
"properties": {
"text": {
"type": "string",
"description": "Text to speak (mode 1). One or two sentences work best; at most 700 speech units (each Chinese, Japanese, Korean or Thai character counts 3), longer is refused with a 400."
},
"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."
}
}
}