---
title: "Get a content generation task"
method: GET
path: "/api/v3/contents/generations/tasks/{task_id}"
tags: ["Official Native API"]
---

# Get a content generation task

`GET /api/v3/contents/generations/tasks/{task_id}`

## Request

- Base URL: `https://api.sandbase.ai`
- URL: `https://api.sandbase.ai/api/v3/contents/generations/tasks/{task_id}`
- Auth: HTTP bearer

## Response `200`

Current task state

- VolcengineTask
  - `id` string, required
  - `model` string, required
  - `status` 'queued' | 'running' | 'cancelled' | 'succeeded' | 'failed' | 'expired', required
  - `created_at` integer, required: Unix timestamp in seconds.
  - `updated_at` integer, required: Unix timestamp in seconds.
  - `content` object, required
    - `video_url` string
    - `last_frame_url` string
    - `file_url` string
  - `usage` object, required
    - `prompt_tokens` integer, required
    - `completion_tokens` integer, required
    - `total_tokens` integer, required
    - `prompt_tokens_details` object, required
    - `completion_tokens_details` object, required
  - `error` VolcengineTaskFailure
    - `code` string, required
    - `message` string, required
  - `failure_reason` VolcengineTaskFailure
    - `code` string, required
    - `message` string, required

## Other responses

- `401`: Missing, invalid, revoked, or expired API key
- `402`: Organization balance and credit are exhausted
- `403`: API Key spending limit reached or organization disabled
- `404`: Task is unknown, deleted, not native, or not owned by the current API key
- `500`: Task lookup failed

---

[API](https://skmtc.dev/sandbase/apis/sandbase-api.md) · [All operations](https://skmtc.dev/sandbase/apis/sandbase-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sandbase/apis/sandbase-api/revisions/d40df2467ba2?raw)