Console
Docs / Get started

Quickstart

Three steps from no account to your first video.

Get an API key

Sign in at api.minicut.ai and open Keys. Press Create key. The key is shown once, so copy it into your environment.

Create API key
.env
MINIAPI_KEY=mapi_live_...

Add funds

Every account is prepaid. Add $10, $25, $50, $100, or any whole amount up to $10,000. A request needs your balance to cover its price. You are not charged for a job that fails.

Add $10See prices

Send your first request

Submit a job to a model id, then read its status until it finishes. This one is 5 seconds of Seedance 2.5 at 720p, which costs $1.75.

# 1. Submit
curl -X POST "https://api.minicut.ai/v1/queue/seedance-2.5" \
  -H "Authorization: Key $MINIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"a red fox runs through snow at dawn","resolution":"720p","duration":"5"}'

# 2. Status, until it says COMPLETED
curl "https://api.minicut.ai/v1/queue/seedance-2.5/requests/$REQUEST_ID/status" \
  -H "Authorization: Key $MINIAPI_KEY"

# 3. Result
curl "https://api.minicut.ai/v1/queue/seedance-2.5/requests/$REQUEST_ID" \
  -H "Authorization: Key $MINIAPI_KEY"

The submit answers at once with a request id and three addresses:

200 OK
{
  "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-.../status",
  "response_url": "https://api.minicut.ai/v1/queue/seedance-2.5/requests/0192f3a4-...",
  "cancel_url": "https://api.minicut.ai/v1/queue/seedance-2.5/requests/0192f3a4-.../cancel",
  "price": "1.750000",
  "currency": "USD"
}

Skip the polling. Add ?webhook_url=https://... to the submit and we POST the result to you when the job ends, signed with your account's webhook secret. See Webhooks.

Next