VidLabDocs
Copy for agent
llms.txtEvery page and model as links an agent can follow.Agent setup guideThe skill, your key and what to ask for.
StatusSupportGet API key

MiniMax Speech 2.8

MiniMaxminimax-speech-2.8

Text to speech you can direct. Pick one of over 300 voices, or send a recording of 10 seconds or more and it speaks in that voice. Set the emotion, speed, pitch and volume; write (laughs) or (sighs) in the words, and <#0.5#> for a pause. A new voice from a recording carries a one-time fee: the same recording sent again pays for its words alone.

Text to speech
POSThttps://vidlab.ai/v1/generations

Send "model": "minimax-speech-2.8" and the fields below. The call answers 202 at once with the generation's id; poll it for the file. Billed per 1,000 characters of text, only when it succeeds.

Request
curl -X POST https://vidlab.ai/v1/generations \
  -H "Authorization: Bearer $VIDLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "minimax-speech-2.8",
  "input": {
    "text": "Fresh coffee, delivered before you wake up.",
    "quality": "hd"
  }
}'
Response
{
  "data": {
    "id": "gen_4Fq9xT2mLr7Kd1sV8bN3pZ0c",
    "object": "generation",
    "status": "queued",
    "model": "minimax-speech-2.8",
    "variant": "hd",
    "units": 1,
    "price_usd": 0.15,
    "outputs": [],
    "created_at": "2026-11-01T18:04:11.000Z",
    "status_url": "/v1/generations/gen_4Fq9xT2mLr7Kd1sV8bN3pZ0c",
    "result_url": "/v1/jobs/gen_4Fq9xT2mLr7Kd1sV8bN3pZ0c/result"
  }
}

Headers

HeaderTypeRequiredValue
AuthorizationstringrequiredBearer vidlab_sk_..., your API key from the dashboard.
Content-Typestringrequiredapplication/json
Idempotency-Keystringoptional8 to 100 letters, digits or _ : . - (a UUID is fine). A retry with the same key never starts or charges twice.

No key yet? Make one under API keys. Keep it on your server, never in a browser or an app.

Body

FieldTypeRequiredDefaultAllowed
modelstringrequiredNone
Must be minimax-speech-2.8
inputobjectrequiredNone
The fields below.
max_cost_usdnumberoptionalNone
Dollars
The most you will pay. Over it, the call answers 422 and nothing is held. Submit a generation
max_wait_snumberoptionalNone
Seconds
The longest you will wait.

Input

The fields of input for text to speech. A field the model does not take is refused, never ignored. Files are https links or base64 data URLs; upload a file from your machine first.

FieldTypeRequiredDefaultAllowed
textstringrequiredNone
Up to 10,000 characters
Text to speak, for voice models that take it; your own lyrics, for music models.
voicestringoptionalNone
A voice id or name
A voice id or name, for voice models.
qualitystringoptionalhd
One of: hd, turbo
Quality tier.
audiofileoptionalNone
1 file
A source sound (lip sync, speech to video).

Pricing

Billed per 1,000 characters of text. A failed generation is free. The example costs $0.15 (hd, 1 1,000 characters). Check any request for free with POST /v1/generations/quote.

OptionPriceBilled
hd hd$0.15per 1,000 characters of text
turbo turbo$0.09per 1,000 characters of text

Response

202 with the generation (status: "queued"), its price, and where to poll it. The fields are on Generation object.

Get the result

GEThttps://vidlab.ai/v1/generations/{id}

Poll every few seconds until status is succeeded or failed. outputs[].url is the file, on our storage; download it with your key from GET /v1/generations/{id}/content. See Get the result.

curl https://vidlab.ai/v1/generations/gen_4Fq9xT2mLr7Kd1sV8bN3pZ0c?wait=60 \
  -H "Authorization: Bearer $VIDLAB_API_KEY"

Errors

Every error is { "error": { "message", "type", "code" } } and nothing is held. All codes are on Errors.

StatusCodeWhen
400invalid_inputA field this model does not take, a value that is not allowed, or a required field left out. The message names it.
401unauthorizedThe key is missing, unknown or revoked.
422max_cost_exceededNo route can run the call for max_cost_usd or less. Nothing is held.
429api_wallet_exhaustedThe balance has no room for this price. Add credit.
429rate_limitedThis account started 20 generations in the last 10 seconds. Not queued: wait for Retry-After, then send it again.
503api_wallet_reconciliation_requiredThe balance is held for a billing review. Contact support; do not retry until it is cleared.