{"uid":"cap_K_7xCCPYAljZ7Uv5kFh4B","slug":"agents-zerogpu-ai-zeroclick-text-to-speech-chatterbox-nano-5d8887c9","name":"ZeroClick Text-to-Speech (chatterbox-nano)","description":"Text-to-speech from a JSON body. Voice cloning (a `voice_sample` upload) is not\navailable on this route. The model is the configured `chatterbox-nano`\nrather than one read from the request. Billed per audio second: the allowance\ncheck asks for the 1-second floor, and `zc-usage` reports\n`max(1, ceil(x-audio-duration-seconds))` audio seconds on success.\n\nAuthenticated by verifying the `zc-signature` HMAC over the raw\nrequest bytes; the same orchestration as `/v1/audio/speech` runs behind it.\n","url":"https://agents.zerogpu.ai/zeroclick/v1/audio/speech?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["input"],"properties":{"seed":{"type":"integer","example":1234,"maximum":4294967295,"minimum":0,"description":"Pins sampling for repeatable output (best-effort)."},"input":{"type":"string","format":"textarea","example":"Testing model to generate voice. Hey how are you today?","maxLength":2000,"minLength":1,"description":"The text to speak. Inline tags such as `[laugh]` and `[cough]` add paralinguistic cues."},"model":{"enum":["chatterbox-nano"],"type":"string","default":"chatterbox-nano","example":"chatterbox-nano","description":"Model identifier. The endpoint serves `chatterbox-nano`."},"top_k":{"type":"integer","default":1000,"maximum":10000,"minimum":0,"description":"Top-k sampling."},"top_p":{"type":"number","default":0.95,"maximum":1,"minimum":0,"description":"Nucleus sampling."},"voice":{"enum":["default","builtin","chatterbox","alloy","ash","ballad","cedar","coral","echo","fable","marin","nova","onyx","sage","shimmer","verse"],"type":"string","default":"default","example":"default","description":"OpenAI voice names are accepted and all map to the built-in voice."},"temperature":{"type":"number","default":0.8,"maximum":2,"minimum":0,"description":"Sampling temperature."},"response_format":{"enum":["mp3","opus","aac","flac","wav","pcm"],"type":"string","default":"mp3","example":"mp3","description":"`pcm` is raw 16-bit little-endian mono at 24 kHz."},"repetition_penalty":{"type":"number","default":1.2,"maximum":4,"minimum":1,"description":"Penalty on repeated speech tokens."}},"description":"JSON body, as the OpenAI SDKs send it."},"responseSchema":{"type":"string","format":"binary"},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unknown_unparsed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_lOK4zyNiqiSA5NdbVSjPf","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.zerogpu.ai","brandSlug":"agents-zerogpu-ai-x402","brandBaseUrl":"https://agents.zerogpu.ai","brandDocsUrl":null,"whatItDoes":"Converts text to spoken audio using the chatterbox-nano model, with optional voice cloning from a sample, returning a binary audio stream.","exampleAgentPrompt":"Read this aloud and give me an mp3: 'Welcome to our platform! We're thrilled to have you here.' — use the nova voice and keep the tone natural.","exampleUseCases":[{"title":"Voice-over narration for product demo","prompt":"Turn this script into a natural-sounding mp3 voice-over using the 'coral' voice: 'Introducing SmartTrack — the easiest way to manage your inventory in real time.'"},{"title":"Podcast intro with cloned host voice","prompt":"I'm attaching a short audio sample of my voice — use it to clone my voice and read this intro text aloud as a wav file: 'Hey everyone, welcome back to the show. Today we're diving into the future of AI.'"},{"title":"Accessibility audio for article","prompt":"Convert this article paragraph to speech so visually impaired users can listen to it — output as opus audio using the default voice: 'Scientists have discovered a new exoplanet orbiting a star 40 light-years away.'"}],"resultDescription":"A binary audio stream in the requested format (mp3, opus, aac, flac, wav, or pcm). PCM is raw 16-bit little-endian mono at 24 kHz. The response header x-audio-duration-seconds indicates the length, and billing is computed as max(1, ceil(duration)) audio seconds.","failureModes":["Invalid or missing zc-signature HMAC → 401 Unauthorized","Input text exceeds 2000 characters → 422 Validation Error","Insufficient credit balance for at least 1 audio second → 402 Payment Required","Malformed multipart voice_sample → 400 Bad Request","Model unavailable or overloaded → 503 Service Unavailable"],"whenToPreferThis":"Choose this endpoint when you need ZeroClick HMAC-authenticated text-to-speech using the chatterbox-nano model, especially when voice cloning from a sample is required or when operating within a ZeroGPU agent workflow that already manages zc-signature authentication. Prefer this over the unauthenticated /v1/audio/speech when acting as a ZeroClick-proxied agent. It supports OpenAI-compatible voice names and output formats, making it a drop-in for OpenAI TTS workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T17:02:25.948Z","isFirstParty":false,"canonicalSlug":"agents-zerogpu-ai-zeroclick-text-to-speech-chatterbox-nano-5d8887c9"}