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.0

Sound and picture made together in one pass, with the mouth already in time with the words. Goes to 4K.

promptstringrequired

What to make, in plain words.

resolutionstring

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

480p720p1080p4k

durationstring

Length in seconds. The price changes with it.

456789101112131415

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

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.

audio_urlsarray of string, urls

Sounds to use.

image_urlsarray of string, urls

Pictures to use as references.

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.0" \
  -H "Authorization: Key $MINIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"a red fox runs through snow at dawn","resolution":"720p","duration":"5"}'

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.0/requests/0192f3a4-5b6c-7d8e-9f01-23456789abcd/status",
  "response_url": "https://api.minicut.ai/v1/queue/seedance-2.0/requests/0192f3a4-5b6c-7d8e-9f01-23456789abcd",
  "cancel_url": "https://api.minicut.ai/v1/queue/seedance-2.0/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