Overview

What the API does

The Wonda API lets you generate images, videos, text, music, and speech; transcribe or analyze media; upload files; inspect jobs; estimate costs; and publish finished media to connected social accounts.

Use REST endpoints for generation, media, pricing, publishing, analytics, scraping, and account-connected workflows. Use the Wonda CLI for editing operations such as trim, crop, merge, overlays, captions, audio mixing, and silence removal. CLI editing runs locally with ffmpeg or hyperframes, then uploads the result back to your media library.

Base URL

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

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

Request and response format

• All JSON request bodies must include Content-Type: application/json.
• All responses are JSON.
• Dates are ISO 8601 strings.
• IDs in path parameters are UUIDs unless the endpoint states otherwise.

Async pattern

Generation and publishing operations are asynchronous. When you submit work, the API returns a job ID immediately. Poll the matching job endpoint until the job reaches a terminal status.

1. Submit a request, such as POST /image/generate or POST /publish/instagram.
2. Poll GET /jobs/inference/{inferenceJobId} or GET /jobs/publish/{outputJobId} until status is "succeeded" or "failed".
3. Read output media or publish details from the completed job response.

Local CLI editing is different: wonda edit video, wonda edit image, and wonda edit audio render on your machine and return the uploaded mediaId directly. The REST editing endpoints are retired and return 410 Gone with CLI migration hints.

Main surfaces