Pular para o conteúdo principal

minimax/h3-edit/video-edit

A edição de vídeo do MiniMax H3 reescreve o clima, a luz, o estilo ou o cenário de um clipe que você envia, enquanto seu material continua definindo quem aparece nele, a composição e o movimento. As edições duram de 3 a 15 segundos em 480p, 540p ou 768p, com trilha sonora nova por padrão.

A partir de $0.03/s
Executar modelo

Playground

Enviar uma requisição

Início rápido

Os exemplos usam as definições públicas de parâmetros do endpoint selecionado. Troque a chave de API e as mídias de exemplo e envie a requisição a partir do seu servidor.

SDKs e integrações
POSThttps://api.spicyapi.ai/api/v1/jobs/createTask

Autenticação da API

Guarde a chave de API na variável de ambiente do servidor SPICY_API_KEY. Use autenticação Bearer e Content-Type: application/json nas requisições JSON.

Authorization: Bearer $SPICY_API_KEY
Resultado de exemploUsar este exemplo
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "minimax/h3-edit/video-edit",
  "input": {
    "duration_seconds": 5,
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "768p",
    "video_url": "https://example.com/reference.mp4"
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Gerado a partir do schema de entrada deste modelo — o mesmo que a API usa para validar cada requisição.

Parâmetros de entrada

Coloque estes campos no objeto input do corpo da requisição. Nomes e tipos são os mesmos da API. Quando nenhum valor padrão estiver indicado, não presuma que exista um.

video_urlstringObrigatórioAfeta o preço

O clipe a editar, em MP4. Pode ter até 15 segundos; um clipe mais longo é recusado antes de qualquer cobrança, então corte-o antes. Use material que você tenha autorização para editar.

Valor padrão
Não especificado
Restrições
format:"uri"
contentMediaType:["video/mp4","video/webm","video/quicktime"]
promptstringObrigatório

Escreva a edição como uma mudança: o que alterar e, depois, o que manter. Por exemplo, transforme a tarde em um crepúsculo tempestuoso e mantenha o rosto e o movimento dela. Chame as imagens de referência de <Picture 1>, <Picture 2> e o áudio de referência de <Audio 1>, <Audio 2>.

Valor padrão
Não especificado
Restrições
minLength:3
maxLength:5000
seedintegerOpcional

Número inteiro opcional. Envie um valor fixo enquanto muda uma coisa de cada vez, para que as tomadas sejam mais fáceis de comparar.

Valor padrão
Não especificado
Restrições
minimum:0
maximum:2147483647
generate_audiobooleanOpcional

Ligado por padrão, o que dá à edição uma trilha sonora nova. Desligue para manter a faixa de áudio original do clipe de origem. O som não altera o preço.

Valor padrão
true
duration_secondsintegerOpcionalAfeta o preço

Duração do clipe editado: de 3 a 15 segundos, padrão 5. Defina-a com a duração do seu clipe de origem para editar o clipe inteiro.

Valor padrão
5
Restrições
minimum:3
maximum:15
resolutionstringOpcionalAfeta o preço

480p, 540p ou 768p; o padrão é 768p, que é a resolução nativa do H3. As resoluções menores custam menos por segundo e terminam antes, mas o mesmo prompt pode ter outra aparência: no nosso teste de tempestade, o 480p mostrou chuva mais forte que o 768p.

Valor padrão
"768p"
Valores permitidos
"480p""540p""768p"
aspect_ratiostringOpcional

Opcional. Se omitir, a edição mantém o formato do clipe de origem. Caso contrário, use 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 ou 9:21.

Valor padrão
Não especificado
Valores permitidos
"16:9""9:16""1:1""4:3""3:4""21:9""9:21"
reference_audio_urlsarray<string>OpcionalAfeta o preço

Até três clipes de áudio que guiam o som. No prompt, eles são chamados de <Audio 1> a <Audio 3>, conforme a posição na lista. Cada um acrescenta uma cobrança pequena.

Valor padrão
Não especificado
Restrições
minItems:1
maxItems:3
reference_image_urlsarray<string>OpcionalAfeta o preço

Até nove imagens que guiam identidade ou estilo. No prompt, elas são chamadas de <Picture 1> a <Picture 9>, conforme a posição na lista. Cada uma acrescenta uma cobrança pequena.

Valor padrão
Não especificado
Restrições
minItems:1
maxItems:9

Acompanhar tarefa

HTTP 202 quer dizer que a tarefa foi aceita, não que terminou. Guarde o taskId devolvido e consulte essa tarefa. Não crie outra enquanto espera o resultado.

Requisição aceita
HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3

{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_create",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued",
    "estimatedCost": "0.750000"
  }
}

A resposta de aceitação já traz a estimativa, para que o seu aplicativo mostre o mesmo valor no histórico de tarefas e na cobrança.

Consultar a tarefa
curl --get "https://api.spicyapi.ai/api/v1/jobs/recordInfo" \
  --data-urlencode "taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Comece consultando a cada 2 segundos, mais ou menos, e vá espaçando. Pare em um estado final. Se a conexão cair, consulte o taskId original. Só recrie a tarefa com a chave de idempotência e o corpo originais.

Ou receba o resultado por callback
import { verifyWebhook } from "@spicyapi/sdk";

// express.raw keeps the bytes we signed; express.json never matches.
app.post("/hooks/spicy", express.raw({ type: "application/json" }), (req, res) => {
  const { payload } = verifyWebhook({
    rawBody: req.body,
    timestamp: req.header("X-Webhook-Timestamp"),
    signature: req.header("X-Webhook-Signature"),
    payloadVersion: Number(req.header("X-Webhook-Payload-Version")),
    secret: process.env.SPICY_WEBHOOK_SECRET,
  });
  res.status(200).end();
  void handleFinishedTask(payload);
});

Passe callBackUrl ao criar a tarefa e o registro concluído chega até você via POST — sem nenhum laço de polling. Toda entrega traz X-Webhook-Timestamp, X-Webhook-Signature e X-Webhook-Payload-Version. A assinatura é um HMAC-SHA256 em base64 sobre taskId.timestamp.sha256(body), então confira contra os bytes brutos: se você analisar o JSON e serializar de novo, os bytes mudam e a verificação falha. Entregas com erro são repetidas, ou seja, o mesmo taskId pode chegar duas vezes — deixe seu handler idempotente. Responda 2xx primeiro e faça o trabalho depois; um handler lento conta como entrega falha.

Ler resultado

Só consuma output quando state for succeeded. Em caso de falha, use errorCode, errorMessage e request_id para investigar. Os custos e estados de exemplo não representam uma cobrança real.

Exemplo de resposta concluída
{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_record",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "minimax/h3-edit/video-edit",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "key": "tasks/2026/08/28/job_01k3m8x9q2z4v7n5p6r8s0t1w3/3f7a1c9e5b2d48f0a6c1e3d5b7f9a1c3.mp4",
          "mime": "video/mp4",
          "url": "https://example.r2.cloudflarestorage.com/results/job_01k3m8x9q2z4v7n5p6r8s0t1w3/result.mp4?X-Amz-Signature=SIGNATURE_FROM_RESPONSE",
          "expiresAt": "2026-08-28T12:20:08.000Z"
        }
      ]
    },
    "cost": "0.750000",
    "settled": true,
    "createdAt": "2026-08-28T12:00:00Z",
    "completedAt": "2026-08-28T12:00:30Z"
  }
}

Para cada arquivo disponível, abra ou baixe assets[].url direto, sem o cabeçalho Authorization da API. O link assinado expira em expiresAt: consulte a tarefa de novo para renovar enquanto o arquivo estiver dentro do prazo de retenção. Arquivo pendente ou indisponível não tem URL. Trate os links assinados como dado privado.

SDKs e integrações

Use a SpicyAPI no seu app, terminal, assistente de IA ou fluxo visual. Escolha um guia de configuração.

SDKs
TypeScript · Python · Go · PHP · Java
CLI
Comandos de terminal e scripts de automação.
MCP
Claude Code · Cursor · Codex
Agent Skill
Instruções reutilizáveis para seu assistente de IA.
n8n
Nós comunitários para instalações próprias e modelos importáveis com HTTP Request para n8n Cloud.
ComfyUI
Fluxos de imagem, vídeo e áudio em um canvas de nós.

Mais integrações

SillyTavernTelegram / DiscordApp proxyOpenAI SDKLangChainVercel AI SDK
Explorar fluxos prontos para usar

Use no ComfyUI

Instale os nós da SpicyAPI pelo ComfyUI Manager ou com o comando abaixo e procure por MiniMax H3 Edit · Video Edit no canvas. O nó tem as mesmas opções desta página e mostra o preço antes da execução.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi
Exemplos de fluxos de trabalhoGuia de configuraçãoCódigo-fonte no GitHub