Get Task Status
Retrieve the current status and result of a generation task.Request
GET /api/v1/tasks/{id}
Authorization: Bearer river_live_xxx
Response
{
"success": true,
"data": {
"id": "task_abc123",
"type": "video",
"status": "succeeded",
"provider": "vidu",
"model": "viduq3-turbo",
"result": [
{
"url": "https://cdn.modelhunter.ai/results/task_abc123.mp4?signature=xxx",
"duration": 4,
"format": "mp4",
"size_bytes": 12582912
}
],
"created_at": "2025-01-15T10:00:00Z",
"completed_at": "2025-01-15T10:00:45Z"
}
}
{
"success": true,
"data": {
"id": "task_abc123",
"type": "video",
"status": "running",
"provider": "vidu",
"model": "viduq3-turbo",
"created_at": "2025-01-15T10:00:00Z"
}
}
{
"success": true,
"data": {
"id": "task_abc123",
"type": "video",
"status": "failed",
"provider": "vidu",
"model": "viduq3-turbo",
"error": {
"code": "PROVIDER_ERROR",
"message": "Content moderation: prompt contains restricted content"
},
"created_at": "2025-01-15T10:00:00Z",
"completed_at": "2025-01-15T10:00:10Z"
}
}
Status Values
| Status | Description | result present? |
|---|---|---|
pending | Queued on ModelHunter.AI side | No |
queued | Sent to provider, waiting | No |
running | Actively generating | No |
succeeded | Complete | Yes |
failed | Error occurred | No (error present) |
cancelled | Cancelled by user | No |
expired | Result URL expired | Re-fetch for new URL |
Result Fields
When status issucceeded, the result field contains an array of output items. Each item has:
| Field | Type | Description |
|---|---|---|
url | string | Signed URL for the output file (valid 15 min) |
duration | number | Video/audio length in seconds (video/audio only) |
format | string | File format (mp4, png, jpg, mp3, etc.) |
size_bytes | number | File size in bytes |