简体中文

English

简体中文

English

主题

查询任务 ​

查询 MiniMax-H3 官方格式视频生成、再生成或 H3-Context-IR 任务的状态与结果。

http
GET /v2/query/video_generation/video_abc123

请求头 ​

名称类型必填说明
string是请求身份认证。使用 Bearer Token，示例值：。
string否响应内容类型，可设为 。

请求参数 ​

名称类型必填说明
string是任务 ID，与创建接口返回的 一致。

请求示例 ​

bash
curl https://octopusx.ai/v2/query/video_generation/426586401755526 \
  -H "Authorization: Bearer <token>" \
  -H "Accept: application/json"
bash
import requests

resp = requests.get(
    "https://octopusx.ai/v2/query/video_generation/426586401755526",
    headers={
        "Authorization": "Bearer <token>",
        "Accept": "application/json",
    },
    timeout=30,
)
print(resp.json())

响应示例 ​

json
{
  "task": {
    "id": "426586401755526",
    "model": "MiniMax-H3",
    "status": "succeeded",
    "created_at": 1785702855,
    "updated_at": 1785702884,
    "content": {
      "prompt": "integrated_multimodal_description: [Shot 1] Cinematic, wide shot with a slow push in on a female captain standing alone at a massive observation window. The last fleet is assembling and jumping away, with bright light flashes and bridge shaking, leaving her behind."
    },
    "duration": 5,
    "usage": {
      "total_tokens": 9090,
      "prompt_tokens": 5664,
      "completion_tokens": 3426
    },
    "ratio": "16:9",
    "task_type": "h3_context_ir",
    "modality": "text"
  }
}
json
{
  "task": {
    "id": "426586401755527",
    "model": "MiniMax-H3",
    "status": "succeeded",
    "created_at": 1785702855,
    "updated_at": 1785702920,
    "content": {
      "url": "https://example.com/video.mp4"
    },
    "duration": 5,
    "usage": {
      "total_seconds": 5,
      "input_seconds": 0,
      "output_seconds": 5,
      "input_image_count": 1
    },
    "resolution": "2K",
    "task_type": "generation",
    "modality": "video"
  }
}
json
{
  "task": {
    "id": "426586401755526",
    "model": "MiniMax-H3",
    "status": "processing",
    "created_at": 1785702855,
    "updated_at": 1785702870
  }
}
json
{
  "task": {
    "id": "426586401755526",
    "model": "MiniMax-H3",
    "status": "failed",
    "created_at": 1785702855,
    "updated_at": 1785702865,
    "error": {
      "message": "Task failed due to content moderation",
      "code": "content_moderation_failed"
    }
  }
}

响应字段 ​

名称类型说明
object任务数据，子字段见下方各行。
string任务 ID。
string模型名称，如 。
string任务状态：（处理中）、（成功）、（失败）。
integer任务创建时间，Unix 时间戳（秒）。
integer任务更新时间，Unix 时间戳（秒）。
object任务结果内容，按任务类型不同： - 任务： 为增强后的多模态描述文本 - 视频生成/再生成任务： 为生成视频的临时签名链接（限时有效，请及时下载或转存）
integer目标视频时长（秒）。
object用量统计，按任务类型不同： - 任务：、、 - 视频生成/再生成任务：（总时长）、（输入时长）、（输出时长）、（输入图片数）
string画面比例，如 ；H3-Context-IR 任务返回。
string输出分辨率，如 ；视频生成/再生成任务返回。
string任务类型：（H3-Context-IR 提示词增强）、（视频生成）。
string任务模态：（文本）、（视频）。
object错误对象（仅 时返回），包含 与 。

相关接口 ​