API
API overview
Endpoints, authentication and model catalog for the TUIWO API.
Model catalog
Documentation is organized as model vendor → series → API. Additional vendors and series follow the same structure.
- ByteDance
Authentication
All endpoints use a Bearer token:
Authorization: Bearer <TUIWO_API_TOKEN>The token must be bound to a concrete group; the auto group returns 403 AccessDenied.
Endpoints
| Method | Path | Description |
|---|---|---|
| POST | /ai/api/v3/contents/generations/tasks | Create a video task |
| GET | /ai/api/v3/contents/generations/tasks | List tasks |
| GET | /ai/api/v3/contents/generations/tasks/{id} | Get a task |
| DELETE | /ai/api/v3/contents/generations/tasks/{id} | Cancel/delete a task |
| POST | /ai?Action=<Action>&Version=2024-01-01 | Assets |
Task IDs
id: compatible task ID, possibly empty.task_id: TUIWO platform task ID.- Query and cancel endpoints accept either.
Error shape
{
"error": {
"code": "InvalidParameter",
"message": "model is required"
}
}See errors.
Last updated on