GET/characters/{id}
Character detail with signed asset URLs
Request
Send to https://app.makeaivideo.ai/api/v1/characters/{id} with a bearer API key. The key needs the read scope; a key without it gets 403 forbidden naming the scope it lacks.
Parameters
| Name | In | Required | Description |
|---|---|---|---|
| id | path | yes | Numeric character id |
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 | Character |
| 404 | Unknown character |
Other characters endpoints
- GET
/charactersPreset and workspace characters - POST
/charactersSave a character from generated or uploaded assets - 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