API reference / Queue

Submit

llms-full.txt

POSThttps://api.minicut.ai/v1/queue/{model_id}

Starts a job and answers at once with a request id. Unknown fields are refused with 422.

Path

model_idstringrequired

Model id, for example seedance-2.5

Query

webhook_urlstring, url

Where we POST the result when the job ends. https, and public addresses only.

Headers

Idempotency-Keystring

Send the same key again and you get the same request back, with no second charge. The same key with a different body is 409.

X-Quote-Idstring

Pay the price from POST /v1/quote for this body. Expires after 15 minutes.

Body: minimax-speech-2.8-hd

The best-sounding of the lot, with feelings you pick rather than describe.

promptstringrequired

What to make, in plain words.

language_booststring

Chinesetoauto

output_formatstring

File type of the result.

urlhex

voice_settingobject

voice_setting.voice_idstring

voice_setting.speednumber0.5 to 2

voice_setting.volnumber0.01 to 10

voice_setting.pitchinteger-12 to 12

voice_setting.emotionstring

happysadangryfearfuldisgustedsurprisedneutral

voice_setting.english_normalizationboolean

truefalse

audio_settingobject

audio_setting.sample_ratenumber

80001600022050240003200044100

audio_setting.bitratenumber

3200064000128000256000

audio_setting.formatstring

mp3pcmflac

audio_setting.channelnumber

12

pronunciation_dictobject

pronunciation_dict.tone_listarray of strings

normalization_settingobject

normalization_setting.enabledboolean

truefalse

normalization_setting.target_loudnessnumber-70 to -10

normalization_setting.target_rangenumber0 to 20

normalization_setting.target_peaknumber-3 to 0

voice_modifyobject

voice_modify.pitchinteger-100 to 100

voice_modify.intensityinteger-100 to 100

voice_modify.timbreinteger-100 to 100

audio_setting.bitratenumber

3200064000128000256000

audio_setting.channelnumber

12

audio_setting.formatstring

mp3pcmflac

audio_setting.sample_ratenumber

80001600022050240003200044100

normalization_setting.enabledany

normalization_setting.target_loudnessnumber-70 to -10

normalization_setting.target_peaknumber-3 to 0

normalization_setting.target_rangenumber0 to 20

pronunciation_dict.tone_listany

voice_modify.intensitynumber-100 to 100

voice_modify.pitchnumber-100 to 100

voice_modify.timbrenumber-100 to 100

voice_setting.emotionstring

happysadangryfearfuldisgustedsurprisedneutral

voice_setting.english_normalizationany

voice_setting.pitchnumber-12 to 12

voice_setting.speednumber0.5 to 2

voice_setting.voice_idany

voice_setting.volnumber0.01 to 10

Response 200

request_idstring

statusstring

queue_positioninteger

Your jobs ahead of this one in line. 0 is next to start

status_urlstring, url

response_urlstring, url

cancel_urlstring, url

pricestring

The price of this request, 6 decimal places, in the currency named by the `currency` field

currencystring

The currency of every amount on this object and the items inside it. Always USD

curl -X POST "https://api.minicut.ai/v1/queue/minimax-speech-2.8-hd" \
  -H "Authorization: Key $MINIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"a red fox runs through snow at dawn"}'

Response 200

{
  "request_id": "0192f3a4-5b6c-7d8e-9f01-23456789abcd",
  "status": "IN_QUEUE",
  "queue_position": 0,
  "status_url": "https://api.minicut.ai/v1/queue/minimax-speech-2.8-hd/requests/0192f3a4-5b6c-7d8e-9f01-23456789abcd/status",
  "response_url": "https://api.minicut.ai/v1/queue/minimax-speech-2.8-hd/requests/0192f3a4-5b6c-7d8e-9f01-23456789abcd",
  "cancel_url": "https://api.minicut.ai/v1/queue/minimax-speech-2.8-hd/requests/0192f3a4-5b6c-7d8e-9f01-23456789abcd/cancel",
  "price": "1.750000",
  "currency": "USD"
}

400invalid_json The body is not JSON

400invalid_webhook_url webhook_url is not https, or points at a private address

401missing_api_key No Authorization header

401invalid_api_key Wrong, unknown or revoked key

402insufficient_balance Your balance is under the price

403account_frozen The account is frozen

409idempotency_conflict Same Idempotency-Key, different body

410quote_expired The quote is older than 15 minutes or for another body

422validation_error A field fails the model's settings

422input_fetch_failed An input URL could not be fetched

422content_refused The content check refused it

429rate_limited Too many requests; wait for Retry-After

500internal_error Our side; try again

503model_unavailable Cannot take jobs right now; try again in 60 s