Overview

What the API does

The Wondercat API lets you generate images, videos, music, and speech; edit media with trims, crops, overlays, and more; and manage blueprints through deterministic lifecycle endpoints or chat-first authoring flows.

Use the REST blueprint endpoints when you want explicit create, clone, inspect, or run behavior. Use chat when you want AI-assisted blueprint edits or graph changes.

Base URL

https://api.wondercat.ai/api/v1

All endpoints are served under this base URL. The current API version is v1.

Request & response format

• All request bodies must be JSON (Content-Type: application/json).
• All responses are JSON.
• Dates are ISO 8601 strings. IDs are UUIDs unless otherwise noted.

Async pattern

Generation and editing operations are asynchronous. When you submit a job, the API returns a job ID immediately. You then poll the status endpoint until the job completes. This keeps request latencies low while heavy processing happens in the background.

1. Submit a request (e.g. POST /image/generate) and receive a job ID.
2. Poll GET /jobs/:id until status is "completed" or "failed".
3. Retrieve the output URL from the completed job response.

Two API surfaces