Pular para o conteúdo principal

O Wan 2.6 Flash é a versão mais rápida e econômica do image-to-video Wan 2.6 da Alibaba. Entrega 5, 10 ou 15 segundos em 720p ou 1080p, em uma tomada ou em vários planos, sem som por padrão ou com trilha sonora gerada.

A partir de $0.022/s10% abaixo do preço oficial

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": "alibaba/wan-2.6-flash/image-to-video",
  "input": {
    "duration_seconds": 5,
    "generate_audio": false,
    "image_url": "https://example.com/reference.png",
    "resolution": "720p",
    "shot_type": "single"
  }
}'

# 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.

image_urlstringObrigatório

O quadro inicial. Assunto, figurino, cenário, direção da luz e proporções do clipe vêm dele, então recorte primeiro. Aceita JPEG, PNG sem transparência, BMP ou WEBP, de 240 a 8.000 pixels por lado e até 20 MB.

Valor padrão
Não especificado
Restrições
contentMediaType:["image/jpeg","image/png","image/webp","image/gif"]
seedintegerOpcional

De 0 a 2147483647. Fixe ao comparar single e multi a partir do mesmo quadro.

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

Desligada por padrão. Ligada, transforma uma ideia de uma linha em lista de planos para multi; deixe desligada se o prompt já for preciso. Com shot_type em multi, ela fica ligada independentemente desta configuração.

Valor padrão
false
shot_typestringOpcional

single mantém uma tomada contínua; multi deixa o modelo cortar entre planos, bom para histórias curtas, mas sem continuidade. Escolher multi também liga enable_prompt_expansion nessa requisição, porque os cortes são planejados enquanto o brief é expandido.

Valor padrão
"single"
Valores permitidos
"single""multi"
duration_secondsintegerOpcionalAfeta o preço

Exatamente 5, 10 ou 15. A edição multiplano precisa das durações maiores para funcionar bem.

Valor padrão
5
Valores permitidos
51015
resolutionstringOpcionalAfeta o preço

720p ou 1080p; padrão 720p. Define o preço por segundo e o tempo de processamento.

Valor padrão
"720p"
Valores permitidos
"720p""1080p"
generate_audiobooleanOpcionalAfeta o preço

Desligado por padrão, então o clipe volta só com imagem. Ligado, o clipe volta com uma trilha de áudio gerada, com vozes, efeitos e som ambiente, e a tarifa por segundo dobra em qualquer uma das duas resoluções.

Valor padrão
false
audio_urlstringOpcional

Uma fala ou uma deixa musical para o clipe seguir: o formato da boca e o ritmo do movimento se ajustam a este arquivo. WAV ou MP3, de 3 a 30 segundos, até 15 MB. Você só o ouve no resultado com generate_audio ativado; com generate_audio desligado, o clipe volta mudo e é cobrado como mudo. Opcional, e sozinho não altera o preço.

Valor padrão
Não especificado
Restrições
contentMediaType:["audio/mpeg","audio/wav"]
negative_promptstringOpcional

O que não pode aparecer: uma segunda pessoa, legendas, um objeto que a imagem insiste em trazer de volta. Até 500 caracteres.

Valor padrão
Não especificado
Restrições
maxLength:500
promptstringOpcional

Opcional. Uma ação para tomada contínua ou planos numerados para edição multiplano. Até 1.500 caracteres.

Valor padrão
Não especificado
Restrições
minLength:1
maxLength:1500

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": "alibaba/wan-2.6-flash/image-to-video",
    "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.

Use no ComfyUI

Instale os nós da SpicyAPI pelo ComfyUI Manager ou com o comando abaixo e procure por Wan 2.6 Flash · Image to Video 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