API

Base URL https://aimodels.cheap/v1. JSON in, JSON out. Authenticate with Authorization: Bearer <api_key>. Prices are in USD, billed from a prepaid USDT balance and locked at submission.

1. Create an account

POST/v1/signup — no auth. Returns your API key once, and your personal USDT deposit address.

curl -X POST https://aimodels.cheap/v1/signup \
  -H 'content-type: application/json' \
  -d '{"email":"you@company.com"}'

{
  "api_key": "amc_…",
  "deposit": {
    "address": "0x…",
    "network": "BNB Smart Chain (BEP-20)",
    "token": "USDT",
    "min_usd": 10
  }
}

Send USDT on BNB Smart Chain (BEP-20) only. USDT on Ethereum, Tron, Polygon or any other token cannot be recovered. The balance is credited after 5 confirmations, usually under a minute.

2. Check balance

GET/v1/account

curl https://aimodels.cheap/v1/account -H 'Authorization: Bearer amc_…'

{ "email": "…", "balance_usd": 24.98, "deposit": { "address": "0x…", … }, "ledger": [ … ] }

3. Get a quote

GET/v1/quote?product=h3_768p&tier=24h&seconds=10 — no auth. Same formula the job will use; the price is only locked when you submit.

product	what
`h3_768p`	MiniMax H3, 1344×768, 24 fps, stereo audio, 20 steps (full quality)
`h3_2k`	Same, upscaled locally to 2K
`h3_turbo`	MiniMax H3 with the 8-step turbo LoRA (draft quality)
tier	delivery
`24h` / `4h` / `1h`	Deadline from submission. Missed deadlines are rerun on on-demand GPUs at our cost.

4. Submit a job

POST/v1/jobs — debits the price immediately, refunded if the job fails or you cancel while it is still queued.

curl -X POST https://aimodels.cheap/v1/jobs \
  -H 'Authorization: Bearer amc_…' -H 'content-type: application/json' \
  -d '{
    "product": "h3_768p",
    "tier": "24h",
    "seconds": 10,
    "mode": "i2v",
    "prompt": "handheld phone footage, a woman laughs on a ferry deck, wind in her hair, natural light",
    "image_url": "https://example.com/frame.jpg",
    "aspect": "9:16",
    "webhook": "https://example.com/hooks/aimodels"
  }'

{ "id": "job_…", "status": "queued", "price_usd": 0.07, "deadline": 1788630000, … }

field	notes
`mode`	`t2v` (default), `i2v` with `image_url`, `r2v` with `reference_url`
`seconds`	1 to 15
`aspect`	`16:9` (default), `9:16`, `1:1`, `4:3`, `3:4`
`audio_url`, `seed`	optional
`webhook`	https URL, receives the job object as JSON when it finishes or fails

5. Poll or cancel

GET/v1/jobs/:id · GET/v1/jobs · DELETE/v1/jobs/:id (queued jobs only, full refund)

Statuses: queued → running → done (with output_url, valid 7 days) or failed (refunded).

Limits during early access

Onboarding is manual: sign up, top up, submit. Jobs are rendered in batches as GPU capacity is booked. Questions: hello@aimodels.cheap.