Miragic

Miragic Speed Painting API transforms static images into hand-drawn whiteboard animation videos. Upload an image and get a video of a hand drawing it stroke by stroke, with customizable hand styles, drawing sequences, and frame rates.

Data Model

• Job is the unit of work. Submit an image → receive a job_id → poll status until complete.
• Status endpoint returns job state (pending, processing, completed, failed). Use it to poll for completion.
• Video output is delivered when the job completes. No separate download tool in test workflow — status check validates connectivity.

Gotchas

• Rate limit: 30 calls/minute, 2 second delay between calls. Use exponential backoff when polling job status.
• Job ID format: UUID. The test uses a zero UUID; real jobs return actual IDs from the create/submit endpoint.
• Async processing: Video generation takes time. Poll status rather than assuming immediate completion.