API Minimax Minimax H3 Reference to Video | Preços e documentação

minimax/minimax-h3/reference-to-video

Minimax H3 Reference to Video gera vídeo 768p ou 2K a partir de referências de imagem, vídeo e áudio, além de um prompt, com clipes de 4 a 15 segundos.

Índice

1. Introdução

Use a API RunComfy para executar minimax/minimax-h3/reference-to-video. Para entradas e saídas aceitas, consulte o esquema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/minimax/minimax-h3/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "The woman from the reference steps out of the shadowed doorway into the low sun, dust lifting around her boots as she scans the street ahead. The camera tracks with her at shoulder height, warm light rakes across her face, and the background falls away into haze. Cinematic pacing, natural movement, anamorphic look.",
    "duration": 5
  }'

2. Autenticação

Defina a variável de ambiente YOUR_API_TOKEN com sua chave de API (gerenciamento no Perfil) e inclua em cada solicitação um token Bearer no cabeçalho Authorization : Authorization: Bearer $YOUR_API_TOKEN.

3. Referência da API

Enviar uma solicitação

Envie um trabalho de geração assíncrono e receba imediatamente um request_id e URLs para status, resultados e cancelamento.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/minimax/minimax-h3/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "The woman from the reference steps out of the shadowed doorway into the low sun, dust lifting around her boots as she scans the street ahead. The camera tracks with her at shoulder height, warm light rakes across her face, and the background falls away into haze. Cinematic pacing, natural movement, anamorphic look.",
    "duration": 5
  }'

Status da solicitação

Obtém o estado atual de um request_id ("in_queue", "in_progress", "completed" ou "cancelled").

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

Obter resultados

Obtém as saídas finais e metadados do request_id; se o trabalho não estiver concluído, a resposta retorna o estado atual para continuar o polling.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

Cancelar solicitação

Cancela um trabalho na fila por request_id; trabalhos em andamento não podem ser cancelados.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. Arquivos de entrada

Arquivo hospedado (URL)

Forneça uma URL HTTPS publicamente acessível. O host deve permitir buscas no servidor (sem login/cookies), sem limite de taxa agressivo ou bloqueio de bots. Recomendado: imagens ≤ 50 MB (~4K), vídeos ≤ 100 MB (~2–5 min em 720p). Para ativos privados, URLs estáveis ou pré-assinadas.

5. Esquema

Esquema de entrada

{
  "type": "object",
  "title": "Esquema de entrada",
  "required": [
    "prompt",
    "duration"
  ],
  "properties": {
    "prompt": {
      "title": "Incitar",
      "description": "Descrição da cena, interação, movimento e estilo visual. 1-7000 caracteres.",
      "type": "string",
      "default": "The woman from the reference steps out of the shadowed doorway into the low sun, dust lifting around her boots as she scans the street ahead. The camera tracks with her at shoulder height, warm light rakes across her face, and the background falls away into haze. Cinematic pacing, natural movement, anamorphic look."
    },
    "reference_images": {
      "title": "Imagens de referência",
      "description": "Imagens de referência orientando assunto, produto, estilo ou composição. Até 9. É necessária pelo menos uma imagem ou vídeo de referência.",
      "type": "array",
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7394/media-files/ref-promo.webp"
      ],
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "maxItems": 9
    },
    "reference_videos": {
      "title": "Vídeos de referência",
      "description": "Vídeos de referência orientando movimento, ritmo ou interação. Até 3. É necessária pelo menos uma imagem ou vídeo de referência.",
      "type": "array",
      "items": {
        "type": "string",
        "format": "video_uri"
      },
      "maxItems": 3
    },
    "reference_audios": {
      "title": "Áudios de referência",
      "description": "Áudio de referência opcional. Até 3. Não pode ser fornecido sem referência de imagem ou vídeo.",
      "type": "array",
      "items": {
        "type": "string",
        "format": "audio_uri"
      },
      "maxItems": 3
    },
    "aspect_ratio": {
      "title": "Proporção",
      "description": "Proporção de aspecto de saída.",
      "type": "string",
      "enum": [
        "adaptive",
        "21:9",
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16"
      ],
      "default": "adaptive"
    },
    "duration": {
      "title": "Duração",
      "description": "Duração do vídeo gerado em segundos.",
      "type": "integer",
      "minimum": 4,
      "maximum": 15,
      "default": 5,
      "enum": null
    },
    "resolution": {
      "title": "Resolução",
      "description": "Resolução de vídeo de saída. Escolha 768p ou 2k.",
      "type": "string",
      "enum": [
        "768p",
        "2k"
      ],
      "default": "768p"
    }
  }
}

Esquema de saída

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL de imagem única"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL de vídeo único"
      },
      "images": {
        "type": "array",
        "description": "várias URLs de imagem",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "várias URLs de vídeo",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

RunComfy

RunComfy é a principal ComfyUI plataforma, oferecendo ComfyUI online ambiente e serviços, juntamente com fluxos de trabalho do ComfyUI apresentando visuais impressionantes. RunComfy também oferece AI Models, permitindo que artistas utilizem as mais recentes ferramentas de AI para criar arte incrível.

1. Introdução

Use a API RunComfy para executar minimax/minimax-h3/reference-to-video. Para entradas e saídas aceitas, consulte o esquema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/minimax/minimax-h3/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "The woman from the reference steps out of the shadowed doorway into the low sun, dust lifting around her boots as she scans the street ahead. The camera tracks with her at shoulder height, warm light rakes across her face, and the background falls away into haze. Cinematic pacing, natural movement, anamorphic look.",
    "duration": 5
  }'

3. Referência da API

Enviar uma solicitação

Envie um trabalho de geração assíncrono e receba imediatamente um request_id e URLs para status, resultados e cancelamento.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/minimax/minimax-h3/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "The woman from the reference steps out of the shadowed doorway into the low sun, dust lifting around her boots as she scans the street ahead. The camera tracks with her at shoulder height, warm light rakes across her face, and the background falls away into haze. Cinematic pacing, natural movement, anamorphic look.",
    "duration": 5
  }'

Status da solicitação

Obtém o estado atual de um request_id ("in_queue", "in_progress", "completed" ou "cancelled").

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

Obter resultados

Obtém as saídas finais e metadados do request_id; se o trabalho não estiver concluído, a resposta retorna o estado atual para continuar o polling.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

Cancelar solicitação

Cancela um trabalho na fila por request_id; trabalhos em andamento não podem ser cancelados.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. Arquivos de entrada

Arquivo hospedado (URL)

5. Esquema

Esquema de entrada

{
  "type": "object",
  "title": "Esquema de entrada",
  "required": [
    "prompt",
    "duration"
  ],
  "properties": {
    "prompt": {
      "title": "Incitar",
      "description": "Descrição da cena, interação, movimento e estilo visual. 1-7000 caracteres.",
      "type": "string",
      "default": "The woman from the reference steps out of the shadowed doorway into the low sun, dust lifting around her boots as she scans the street ahead. The camera tracks with her at shoulder height, warm light rakes across her face, and the background falls away into haze. Cinematic pacing, natural movement, anamorphic look."
    },
    "reference_images": {
      "title": "Imagens de referência",
      "description": "Imagens de referência orientando assunto, produto, estilo ou composição. Até 9. É necessária pelo menos uma imagem ou vídeo de referência.",
      "type": "array",
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7394/media-files/ref-promo.webp"
      ],
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "maxItems": 9
    },
    "reference_videos": {
      "title": "Vídeos de referência",
      "description": "Vídeos de referência orientando movimento, ritmo ou interação. Até 3. É necessária pelo menos uma imagem ou vídeo de referência.",
      "type": "array",
      "items": {
        "type": "string",
        "format": "video_uri"
      },
      "maxItems": 3
    },
    "reference_audios": {
      "title": "Áudios de referência",
      "description": "Áudio de referência opcional. Até 3. Não pode ser fornecido sem referência de imagem ou vídeo.",
      "type": "array",
      "items": {
        "type": "string",
        "format": "audio_uri"
      },
      "maxItems": 3
    },
    "aspect_ratio": {
      "title": "Proporção",
      "description": "Proporção de aspecto de saída.",
      "type": "string",
      "enum": [
        "adaptive",
        "21:9",
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16"
      ],
      "default": "adaptive"
    },
    "duration": {
      "title": "Duração",
      "description": "Duração do vídeo gerado em segundos.",
      "type": "integer",
      "minimum": 4,
      "maximum": 15,
      "default": 5,
      "enum": null
    },
    "resolution": {
      "title": "Resolução",
      "description": "Resolução de vídeo de saída. Escolha 768p ou 2k.",
      "type": "string",
      "enum": [
        "768p",
        "2k"
      ],
      "default": "768p"
    }
  }
}

Esquema de saída

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL de imagem única"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL de vídeo único"
      },
      "images": {
        "type": "array",
        "description": "várias URLs de imagem",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "várias URLs de vídeo",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

Referência Minimax H3 para vídeo: geração de vídeo guiada por referência em 768p e 2K em modelos e API | Models and API | RunComfy

Minimax H3 Reference to Video gera vídeo 768p ou 2K a partir de referências de imagem, vídeo e áudio, além de um prompt, com clipes de 4 a 15 segundos.

Índice

1. Introdução

2. Autenticação

3. Referência da API

Enviar uma solicitação

Status da solicitação

Obter resultados

Cancelar solicitação

4. Arquivos de entrada

Arquivo hospedado (URL)

5. Esquema

Esquema de entrada

Esquema de saída

Referência Minimax H3 para vídeo: geração de vídeo guiada por referência em 768p e 2K em modelos e API | Models and API | RunComfy

Minimax H3 Reference to Video gera vídeo 768p ou 2K a partir de referências de imagem, vídeo e áudio, além de um prompt, com clipes de 4 a 15 segundos.

Índice

1. Introdução

2. Autenticação

3. Referência da API

Enviar uma solicitação

Status da solicitação

Obter resultados

Cancelar solicitação

4. Arquivos de entrada

Arquivo hospedado (URL)

5. Esquema

Esquema de entrada

Esquema de saída