Skip to main content

​
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": "viduq2-pro-fast",
    "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"
  }
}

​
Status Values

StatusDescriptionresult present?
pendingQueued on ModelHunter.AI sideNo
queuedSent to provider, waitingNo
runningActively generatingNo
succeededCompleteYes
failedError occurredNo (error present)
cancelledCancelled by userNo
expiredResult URL expiredRe-fetch for new URL

​
Result Fields

When status is succeeded, the result field contains an array of output items. Each item has:
FieldTypeDescription
urlstringSigned URL for the output file (valid 15 min)
durationnumberVideo/audio length in seconds (video/audio only)
formatstringFile format (mp4, png, jpg, mp3, etc.)
size_bytesnumberFile size in bytes

​
Cancel Task

Cancel a task that is still in progress.

​
Request

DELETE /api/v1/tasks/{id}
Authorization: Bearer river_live_xxx

​
Response

{
  "success": true,
  "data": {
    "id": "task_abc123",
    "status": "cancelled",
    "cancelled_at": "2025-01-15T10:00:30Z"
  }
}
Returns 409 Conflict if the task has already completed.