GET/characters
Preset and workspace characters
Request
Send to https://app.makeaivideo.ai/api/v1/characters with a bearer API key. The key needs the read scope; a key without it gets 403 forbidden naming the scope it lacks.
Responses
Every v1 response is { data, error, meta }. On failure error carries a stable code and meta.request_id identifies the call, which is the thing to quote in a support mail.
| Status | Meaning |
|---|---|
| 200 | Characters |
Other characters endpoints
- POST
/charactersSave a character from generated or uploaded assets - GET
/characters/{id}Character detail with signed asset URLs - PATCH
/characters/{id}Update name, description or voice - DELETE
/characters/{id}Delete a workspace character - POST
/characters/variationsGenerate 1-4 portrait candidates (spends credits) - POST
/characters/voice-previewsCandidate voices reading a sample line
All characters · Full API reference · TypeScript SDK · Quickstart