Generate speech
The successful response is binary audio, not JSON.
On this page
https://api.shareai.now/api/v1/audio/speechGenerate speech
- Base URL
https://api.shareai.now- Authentication
- Bearer API key or approved OAuth access token
- Required scope
inferenceormonetization_gateway
The successful response is binary audio, not JSON. Save it using curl --output speech.mp3 or read response bytes in your SDK. Choose a supported model voice and output format; speed is bounded from 0.25 to 4. The input limit is 256 KiB and the synchronous response limit is 2 MiB.
Before you start#
Set SHAREAI_API_KEY on your server and replace the model placeholder with a currently enabled model. Never expose the API key in browser code. The model, account, credential and provider must all permit this operation. Optional settings below require model support; the API safety bounds are not a promise that every model supports every value.
Send a request#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/audio/speech" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_SPEECH_MODEL",
"input": "Hello from ShareAI.",
"response_format": "mp3"
}' --output speech.mp3Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_SPEECH_MODEL',
'input': 'Hello from ShareAI.',
'response_format': 'mp3'}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/speech', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
with open("speech.mp3", "wb") as output:
output.write(response.read())TypeScript
import { writeFile } from "node:fs/promises";
const response = await fetch("https://api.shareai.now/api/v1/audio/speech", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_SPEECH_MODEL",
"input": "Hello from ShareAI.",
"response_format": "mp3"
}),
});
if (!response.ok) throw new Error(await response.text());
await writeFile("speech.mp3", Buffer.from(await response.arrayBuffer()));Request fields#
| Field | Type | Meaning and limits |
|---|---|---|
model required | string | Exact enabled public model identifier. Must declare this operation and be allowed by your credential. |
input required | string | Required nonempty speech text, at most 256 KiB of UTF-8. Character tariffs count Unicode characters, not encoded bytes. |
voice | string | Optional voice supported by the selected speech model, at most 100 characters. |
response_format | string | Optional supported audio encoding such as mp3. A successful response is binary, not JSON. Duration-priced routes need self-describing MP3, WAV or FLAC. |
speed | number | Optional speech speed from 0.25 to 4; the model may impose narrower limits. |
provider | object | Optional provider routing preferences. Use provider.only for accepted provider tags, not a prefix in the model ID. Account and credential restrictions still apply. |
Read the result#
Success returns HTTP 200 with binary audio. The successful response is binary audio, not JSON. Save it using curl --output speech.mp3 or read response bytes in your SDK. Choose a supported model voice and output format; speed is bounded from 0.25 to 4. The input limit is 256 KiB and the synchronous response limit is 2 MiB.
Billing units#
Speech can be priced per input character, provider-reported token or generated second, depending on the model. Character counts use Unicode characters. Duration pricing requires a supported self-describing MP3, WAV or FLAC result. A raw PCM result has no guessed sample rate. Token-priced routes need a trusted usage receipt.
Choose the exact enabled model identifier from Console. Its declared operation and input/output capabilities must match this endpoint; a text chat model cannot be substituted for another operation. Your credential, provider and account restrictions still apply.
Pricing and usage#
Rates are published in EUR AI credits for the selected model, provider, units and variants. Only the dimensions in its active tariff are charged. An estimate reserves credits before execution; final charges use measured usage. Prices can depend on resolution, output format or a usage band. Check Console Usage for the final ShareAI debit. Upstream cost fields and media bytes are not converted into invented token counts.
Access and errors#
Use inference for approved network-cost inference or monetization_gateway for an approved Builder markup and accepted billing terms. Identity-only access does not authorize spending. Validation, model authorization, insufficient credits, rate limits and execution failures return a structured error. After a timeout or uncertain submission, inspect Usage or the video job before creating another potentially paid request.
Last updated November 3, 2026