MagiCoal Video API
Async video generation from images or text using the Wan2.2 model. Submit a generation job and receive a UUID immediately — then poll the status endpoint until your video is ready. Videos are stored and accessible via a permanent URL.
Base URL
https://coals.ai/api/v1/magicoal
All endpoints require an Authorization: Bearer <token> header. Obtain a token from your dashboard API settings.
Video generation is asynchronous.
Generation endpoints return 202 Accepted immediately with a UUID. The actual video renders in the background — use GET /status/{uuid} to poll for completion. Do not re-submit while a job is already running.
Async Workflow
or POST /generate/t2v
every 3–5 seconds
video_url ready
Endpoints
| Method | Endpoint | Description | Scope Required |
|---|---|---|---|
| POST | /generate/i2v | Animate an image into a video | magicoal:generate |
| POST | /generate/t2v | Generate a video from a text prompt | magicoal:generate |
| GET | /status/{uuid} | Poll generation status and retrieve video URL | magicoal:read |
| GET | /videos | List all completed videos with pagination | magicoal:read |
| GET | /quota | Check video quota and credit balance | magicoal:read |
Required Scopes
magicoal:generate
Submit image-to-video and text-to-video generation jobs.
magicoal:read
Poll status, list completed videos, and check quota and credit balance.
Credit Costs
| Operation | Credits | USD Equivalent |
|---|---|---|
| Image-to-Video (I2V) | 50 cr | $0.50 |
| Text-to-Video (T2V) — FLUX image + animation | 52 cr | $0.52 |
Credits are charged upfront when a job is submitted. If generation fails, credits are automatically refunded to your account.