aiiqq.com Docs
VideosMiniMax Video

查询 MiniMax H3 原生任务

GET
/v2/query/video_generation/{task_id}

查询视频生成、Context-IR 或再生成任务。必须使用网关返回的公开 task_ ID及创建时的同一 aiiqq.com 令牌，网关绑定原渠道与密钥；平台格式任务不能使用此路径。建议每10–15秒轮询，查询不重复收费。视频成功结果在 task.content.url，Context-IR 文本在 task.content.prompt；原始计量在 task.usage。任务列表路径（不带 task_id）未提供。

Authorization

bearerAuth
AuthorizationBearer <token>

使用 Authorization Bearer API Key 进行鉴权。

In: header

Path Parameters

task_id*string

aiiqq.com返回的公开任务 ID；使用创建任务的同一令牌，不能使用供应商内部 ID。

Match^task_.+
Length6 <= length

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/query/video_generation/task_H3_GENERATION_EXAMPLE"

{
  "task": {
    "id": "task_H3_GENERATION_EXAMPLE",
    "model": "MiniMax-H3",
    "status": "succeeded",
    "resolution": "768P",
    "duration": 4,
    "ratio": "16:9",
    "content": {
      "url": "https://example.com/h3-output.mp4"
    },
    "usage": {
      "total_seconds": 4,
      "input_seconds": 0,
      "output_seconds": 4,
      "input_image_count": 0
    },
    "task_type": "generation",
    "modality": "video"
  }
}

{
  "type": "error",
  "error": {
    "type": "string",
    "message": "string",
    "http_code": "string"
  },
  "request_id": "string"
}
{
  "type": "error",
  "error": {
    "type": "string",
    "message": "string",
    "http_code": "string"
  },
  "request_id": "string"
}
{
  "type": "error",
  "error": {
    "type": "string",
    "message": "string",
    "http_code": "string"
  },
  "request_id": "string"
}
{
  "type": "error",
  "error": {
    "type": "string",
    "message": "string",
    "http_code": "string"
  },
  "request_id": "string"
}
{
  "type": "error",
  "error": {
    "type": "string",
    "message": "string",
    "http_code": "string"
  },
  "request_id": "string"
}

768P to 2K Regeneration

将合规 MiniMax H3 768P 源视频重新生成至 2K，独立于原视频计费。使用 source_task_id 或 content/base_video 两种方式之一，不同时提交。请求正文 model 固定 MiniMax-H3；本操作使用 minimax-h3-regeneration 权限与价格。 source_task_id必须为同一 aiiqq.com 令牌创建、最近7天内成功的视频生成公开 ID；须来自相同原生协议和创建时的渠道密钥。平台 /v1/video/generate 任务不能用于此引用。通过 base_video提交时，必须同时提供生成源视频的最终提示词及相同参考素材；源视频须为 MiniMax-H3 768P 输出，含音轨，24fps，宽高均可被32整除，107–362帧。上游可能对任务ID引用额外要求白名单。再生成不使用统一视频生成入口。字段参考[官方再生成文档](https://platform.minimax.cn/docs/api-reference/video-generation-v2-regeneration)。

Cancel or Delete H3 Task

使用公开任务 ID及创建时同一 aiiqq.com 令牌。queued 任务可取消且按任务流程退款，取消后仍可查询 cancelled；running 任务不能取消或删除，返回400。succeeded/failed 任务可删除，删除后公开 ID失效；删除成功结果不退还已完成生成费用。网关删除前会查询并结算完成任务。 409需要区分两种情况：尚在结算的任务可先查询，再稍后重试；若删除与上游完成竞态导致最终用量不可恢复，网关进入 RECONCILING并保留预扣等待人工对账，此时不自动退款，也不应盲目反复删除。平台格式尚无取消/删除代理。