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: meshy-v7-1

Makes a 3D model out of words or out of one to four photographs of the same object, with colour and surface on it. It can rig the model as a poseable character and play one of 697 built-in movements. The file it makes stands on the 3D Scene Composer.

model_typestring

standardlowpolysmart-topologysmart-topology-t2

topologystring

quadtriangle

target_polycountinteger100 to 300000

symmetry_modestring

offautoon

should_remeshboolean

truefalse

should_textureboolean

truefalse

enable_pbrboolean

truefalse

pose_modestring

a-poset-pose

texture_promptstring

enable_riggingboolean

truefalse

rigging_height_metersnumber

enable_animationboolean

truefalse

animation_action_idinteger

geometry_resolutionstring

standard2k4k

modestring

previewfull

enable_prompt_expansionboolean

Let the model add detail to a short prompt.

truefalse

image_urlstring, url

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

is_a_t_poseany

texture_image_urlstring, url

ultra_modeany

image_urlsarray of string, urls

Pictures to use as references.

promptstring

What to make, in plain words.

seedinteger

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

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