> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# MiniMax H3 동영상 조회
> 상태, 진행률, 타임스탬프, 결과 URL 또는 실패 세부 정보를 포함하여 작업 ID로 MiniMax H3 동영상 작업을 조회합니다.
MiniMax H3 동영상 작업을 생성한 후 이 엔드포인트를 사용하세요. 작업이 완료되면 응답에 `video_url`이 포함됩니다.
## 다음 필드를 확인하세요
* `status` 값은 `queued`, `in_progress`, `completed` 또는 `failed` 중 하나입니다.
* `progress` 값은 `0`부터 `100`까지의 대략적인 완료율입니다.
* `video_url` 값은 작업이 완료되면 표시됩니다.
* `error` 값은 작업이 실패하면 표시됩니다.
## 작업 폴링
먼저 [MiniMax H3 동영상 생성](./create) 를 수행하고 반환된 `id`을 저장합니다.
`status` 값이 `completed` 또는 `failed` 중 하나가 될 때까지 작업 ID를 이 엔드포인트에 전송하세요.
`status` 값이 `completed`이면 다음을 호출하세요: [MiniMax H3 동영상 콘텐츠 다운로드](./retrieve-content).
## OpenAPI
````yaml api/openapi/video/minimax-h3/get-retrieve.openapi.json GET /v1/videos/{task_id}
openapi: 3.1.0
info:
title: MiniMax H3 Video Retrieve API
version: 1.0.0
description: >-
Retrieve a MiniMax H3 video task by task ID. Poll this endpoint until the
status is completed or failed.
servers:
- url: https://api.cometapi.com
security:
- bearerAuth: []
paths:
/v1/videos/{task_id}:
get:
summary: Retrieve a MiniMax H3 video task
description: >-
Read the state of a MiniMax H3 video task that was created through POST
/v1/videos.
operationId: minimax_h3_retrieve_video
parameters:
- name: task_id
in: path
required: true
description: Task ID returned by POST /v1/videos.
schema:
type: string
example:
responses:
'200':
description: Current MiniMax H3 video task state.
content:
application/json:
schema:
$ref: '#/components/schemas/MiniMaxH3VideoTask'
examples:
queued:
summary: Task queued
value:
id:
task_id:
object: video
model: minimax-h3
status: queued
progress: 0
created_at: 1779938152
in_progress:
summary: Task in progress
value:
id:
object: video
model: minimax-h3
status: in_progress
progress: 30
created_at: 1779938152
completed:
summary: Task completed
value:
id:
object: video
model: minimax-h3
status: completed
progress: 100
created_at: 1779938152
completed_at: 1779938219
expires_at: 1780543019
video_url: https:///.mp4
failed:
summary: Task failed
value:
id:
object: video
model: minimax-h3
status: failed
progress: 100
created_at: 1779938152
completed_at: 1779938219
error:
message: The video task could not be completed.
code: generation_failed
security:
- bearerAuth: []
x-codeSamples:
- lang: Shell
label: Retrieve task status
source: |-
curl "https://api.cometapi.com/v1/videos/" \
-H "Authorization: Bearer $COMETAPI_KEY"
- lang: Python
label: Retrieve task status
source: |
import os
import requests
task_id = ""
response = requests.get(
f"https://api.cometapi.com/v1/videos/{task_id}",
headers={
"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]
},
timeout=60,
)
response.raise_for_status()
print(response.json())
- lang: JavaScript
label: Retrieve task status
source: |
const taskId = "";
const response = await fetch(
`https://api.cometapi.com/v1/videos/${taskId}`,
{ headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` } },
);
if (!response.ok) {
throw new Error(await response.text());
}
console.log(await response.json());
components:
schemas:
MiniMaxH3VideoTask:
type: object
required:
- id
- object
- model
- status
- progress
- created_at
properties:
id:
type: string
description: Task ID. Use this value as task_id in retrieve and content requests.
example:
task_id:
type: string
description: >-
Compatibility alias for id. This field can be omitted from retrieve
responses.
example:
object:
type: string
const: video
description: Object type for the asynchronous video task.
model:
type: string
description: Model ID that the task uses.
enum:
- minimax-h3
- minimax-h3-max
status:
type: string
enum:
- queued
- in_progress
- completed
- failed
description: Task lifecycle status. Poll until the value is completed or failed.
progress:
type: integer
minimum: 0
maximum: 100
description: Task progress as a coarse percentage.
created_at:
type: integer
format: int64
description: Task creation time as a Unix timestamp in seconds.
completed_at:
type: integer
format: int64
description: >-
Unix timestamp returned by the platform. Use status, not this field,
to decide when polling can stop.
expires_at:
type: integer
format: int64
description: >-
Result expiration time as a Unix timestamp in seconds when the task
provides one.
video_url:
type: string
format: uri
description: Video delivery URL. This field appears on completed tasks.
example: https:///.mp4
error:
type: object
description: Failure details. This field appears when the task fails.
properties:
message:
type: string
description: Human-readable failure description.
code:
type: string
description: Failure code when the task provides one.
additionalProperties: true
additionalProperties: true
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Bearer authentication. Use your CometAPI API key.
````