Get Task

Retrieve the status and result of an asynchronous MiniMax task using the task_id returned by POST /api/v1/task. Authenticate with your PiAPI API key in the X-API-Key header.

Supported task results

Model	Task type	Completed result
`Qubico/minimax-h3` or `Qubico/minimax-h3-nsfw`	`txt2video` or `img2video`	`data.output.video`
`minimax`	`speech-2.8-turbo`	`data.output.audio_url` and `data.output.format`
`minimax`	`image-01`	`data.output.images[].url`

Speech and image generation use the unified asynchronous task API: submit to POST /api/v1/task, save data.task_id, then query this endpoint. A successful query returns the code, message, and data envelope.

Reading the result

Status values are lowercase. Continue polling while a task is pending, staged, processing, or retry.

completed, failed, and canceled are terminal states. For completed, read the result field matching the task type above. For failed, inspect data.error.message.

HTTP 200 and code: 200 mean the query succeeded; they do not mean generation completed successfully. Always check data.status.

data.output can be null before successful completion. A completed image task returns an array of image URLs; an audio task returns a URL in the selected audio format.

data.meta.usage describes task usage. Querying a task does not create another generation or charge a second generation fee. A failed status alone does not determine whether a charge was incurred; inspect final usage and your billing records.

Query tasks belonging to your own account. Speech and image task records remain available for approximately three days after their last status update. Download results you want to keep promptly.

The examples show video, speech, image, pending, and failed tasks. Task IDs, media URLs, timestamps, and usage values are illustrative placeholders; use the values returned for your own tasks.

application/json

Bodyapplication/json

Illustrative response. IDs, URLs, timestamps and usage are placeholders.

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "00000000-0000-4000-8000-000000000001",
    "model": "Qubico/minimax-h3",
    "task_type": "txt2video",
    "status": "completed",
    "config": {
      "service_mode": "public",
      "webhook_config": {
        "endpoint": "",
        "secret": ""
      }
    },
    "input": {
      "prompt": "A golden retriever puppy running across a sunny grass lawn toward the camera, cinematic",
      "resolution": "480p",
      "duration": 5,
      "aspect_ratio": "16:9",
      "seed": 0
    },
    "output": {
      "video": "https://example.com/generated-video.mp4"
    },
    "meta": {
      "created_at": "2026-10-13T08:00:00Z",
      "started_at": "2026-10-13T08:00:01Z",
      "ended_at": "2026-10-13T08:00:10Z",
      "usage": {
        "type": "point",
        "frozen": 0,
        "consume": 1500000
      },
      "is_using_private_pool": false
    },
    "detail": null,
    "logs": [],
    "error": {
      "code": 0,
      "message": "",
      "detail": null
    }
  }
}

Get Task

Supported task results

Reading the result

Request

Request Code Samples

Responses

Get Task

Supported task results#

Reading the result#

Request

Request Code Samples

Responses

Supported task results

Reading the result