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: seedance-2.5

Thirty seconds in one unbroken take, and up to fifty references at once, so a face and an outfit hold across a whole scene.

resolutionstring

Output size. Higher is sharper, slower and costs more.

480p720p1080p

durationstring

Length in seconds. The price changes with it.

4to30

aspect_ratiostring

Shape of the result, for example 16:9 or 9:16.

auto21:916:94:31:13:49:16

generate_audioboolean

Add sound effects, background sound and speech.

truefalse

bitrate_modestring

Output bitrate.

standardhigh

codecstring

Video codec. auto keeps the default.

autoH264H265

taskstring

The kind of job.

referenceeditingextension

draftany

end_image_urlstring, url

A picture for the last frame.

image_urlstring, url

A picture to start from. We fetch it and keep a copy for the job.

promptstring

What to make, in plain words.

audio_urlsarray of string, urls

Sounds to use.

image_urlsarray of string, urls

Pictures to use as references.

seedinteger

The same seed with the same settings gives a similar result. Leave it out for a random one.

video_urlsarray of string, urls

Clips to work on or reference.

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/seedance-2.5" \
  -H "Authorization: Key $MINIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"resolution":"720p","duration":"5","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/seedance-2.5/requests/0192f3a4-5b6c-7d8e-9f01-23456789abcd/status",
  "response_url": "https://api.minicut.ai/v1/queue/seedance-2.5/requests/0192f3a4-5b6c-7d8e-9f01-23456789abcd",
  "cancel_url": "https://api.minicut.ai/v1/queue/seedance-2.5/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