Use MiniMax H3 with Comfy Router

Call minimax/minimax-h3 through Comfy Router: endpoint, request shape and the response Router returns.

API Reference for minimax/minimax-h3, served by Comfy Router from MiniMax.

Request setup

Create a key in your Comfy workspace and export it as COMFY_API_KEY. For Python, run pip install comfy-sdk. For TypeScript, run npm install @comfyorg/sdk. cURL uses raw HTTP.

Model ID: minimax/minimax-h3

Endpoint: POST https://api.comfy.org/v2/models/minimax/minimax-h3

This model has no runnable request example. Build the body from the input documentation below, then use it with the Router quickstart.

Schema

Input

Router has not published an authored input schema for this model yet: GET /v2/models/minimax/minimax-h3/openapi.json returns an open object with x-comfy-input-schema-authored: false. Router forwards the body to MiniMax unchanged, so MiniMax’s own API reference is authoritative for the request fields, and Router does not perform model-specific input validation. Provider validation still applies.

Output

task · object

A Minimax V2 video generation task.

task.content · object

Generated output; present when status is succeeded.

task.content.prompt · string

The enhanced video prompt produced by a succeeded h3_context_ir task.

task.content.url · string

Time-limited URL of the generated MP4. Query again for a refreshed URL.

task.duration · number

The duration of the generated video in seconds.

task.error · object

Error details when status is failed; carries code and message.

task.id · string

The task ID.

task.model · string

The model used for the task.

task.ratio · string

The actual aspect ratio of the generated video.

task.resolution · string

The resolution of the generated video.

task.status · string

Task status. Options: queued, running, succeeded, failed, cancelled, expired.

task.task_type · string

The type of the task.

task.usage · object

Usage recorded for the task.

task.usage.completion_tokens · integer

task.usage.input_image_count · integer

task.usage.input_seconds · number

task.usage.output_seconds · number

task.usage.prompt_tokens · integer

task.usage.total_seconds · number

task.usage.total_tokens · integer

Examples

Output

{
  "task": {
    "content": {
      "url": "https://example.invalid/minimax/minimax-h3/generated.mp4"
    },
    "duration": 6,
    "id": "3f7a1b28-5c0d-4e91-8a6f-1b2c3d4e5f60",
    "model": "MiniMax-H3",
    "ratio": "16:9",
    "resolution": "768P",
    "status": "succeeded",
    "usage": {
      "output_seconds": 6,
      "total_seconds": 6
    }
  }
}

Before you ship

The SDKs create an Idempotency-Key and reuse it for automatic retries. For manual retries, reuse the original key. Router can hold the connection for up to 10 minutes.

When a request fails, Router sends an X-Comfy-Error-Type response header explaining why. A 422 means Router rejected the input before calling the provider. Download generated assets promptly because result URLs can expire.

Headers

Authentication, idempotency, request IDs, error buckets, retry pacing, spend limits.

Using the Router API

Model discovery, validation errors, retries, and billing.

Limitations

What Router does not do today, and what to use instead.