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: gpt-image-2

Cheap and quick at low, and it climbs with the quality you ask for.

promptstringrequired

What to make, in plain words.

backgroundstring

What to do with the background.

autotransparentopaque

qualitystring

Detail level. Higher costs more.

autolowmediumhigh

num_imagesinteger1 to 4

How many images to make. Each one is charged.

output_formatstring

File type of the result.

jpegpngwebp

image_sizestring

Width and height in pixels, or a named size.

square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9auto

image_size.heightnumber

image_size.widthnumber

image_urlsarray of string, urls

Pictures to use as references.

mask_urlstring, url

A black and white picture: white is the part to change.

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