Tarefas assíncronas

Live
Envie, persista, consulte e concilie predictions de mídia.
Abrir no ChatGPT
(opens in new tab)
Última verificação: 2026-09-08

Ciclo de vida de uma Prediction

Requisições de imagem, vídeo e áudio compartilham um registro interno de Prediction. Os estados canônicos são queued, processing, succeeded, failed, cancelled e expired. Antes de começar a consultar, guarde o ID de geração ou de Prediction devolvido, o modelo, a região, o horário de envio e o seu ID interno de tarefa.

Estratégia de backoff

Consulte GET /predictions/:id com backoff exponencial e jitter. Clientes de vídeo existentes podem continuar usando GET /videos/generations/:id. Pare em qualquer estado terminal e continue a conciliação em um worker se a pessoa usuária sair da página.

Expiração e cancelamento

As predictions expiram sete dias após o ciclo de vida do registro delas. DELETE /predictions/:id devolve a Prediction terminal inalterada, ou 409 cancellation_not_supported quando a operação do provedor escolhida não consegue cancelar com segurança uma tarefa em andamento.

Fronteira de retentativas

Repita as leituras de status à vontade dentro dos limites de uso. Não reenvie cegamente requisições de geração após um tempo limite ambíguo: isso pode criar uma tarefa cobrável a mais. Concilie primeiro a requisição original.

Referências das APIs dos modelos Spicy

Abra a página do modelo para consultar parâmetros e preços atuais. As quatro páginas Wan 3 incluem uma seção de API abaixo do Playground. GET /v1/models fornece esquemas e acesso permitido à chave; GET /api/model-pricing retorna os preços atuais para o cliente.
Modelo e referência da APIID do modeloEndpoint
Wan 3 Spicymodelrush/wan3-spicyPOST /v1/videos/generations
Wan 3 Pro Spicymodelrush/wan3-pro-spicyPOST /v1/videos/generations
Wan 3 Prime Spicymodelrush/wan3-prime-spicyPOST /v1/videos/generations
Wan 3 Prime Pro Spicymodelrush/wan3-prime-pro-spicyPOST /v1/videos/generations
Wan 2.7 I2V Spicymodelrush/wan2.7-i2v-spicyPOST /v1/videos/generations
Wan 2.2 I2V Spicymodelrush/wan2.2-i2v-spicyPOST /v1/videos/generations
Wan 2.2 I2V LoRA Spicymodelrush/wan2.2-i2v-lora-spicyPOST /v1/videos/generations
Z-Image Spicymodelrush/z-image-spicyPOST /v1/images/generations
Z-Image Pro Spicymodelrush/z-image-spicy-proPOST /v1/images/generations
Qwen Image Edit Spicymodelrush/qwen-image-edit-spicyPOST /v1/images/edits
Face Swap Spicymodelrush/face-swapPOST /v1/images/edits
Head Swap Spicymodelrush/head-swapPOST /v1/images/edits
Wan Animate Spicymodelrush/wan-animatePOST /v1/videos/generations
FlashVSR Spicymodelrush/flashvsrPOST /v1/videos/generations
Solicitações de imagem do MuleRouter podem retornar HTTP 202, id e poll_url. Consulte essa URL com a mesma chave; GET /v1/predictions/:id termina com succeeded e outputs. Z-Image Pro Spicy aceita width e height de 256 a 2560 (padrão 1024), n = 1 e prompt_extend = false por padrão. Z-Image Spicy também gera uma imagem por solicitação. Não copie os limites de tamanho ou quantidade de outro modelo.
GET /v1/videos/generations/:id termina com completed ou failed e retorna video_url em caso de sucesso. GET /v1/predictions/:id usa succeeded e outputs. Siga o contrato do poll_url usado. Os vídeos de referência e de saída do Wan 3 não podem exceder 30 segundos no total. Somente Prime e Prime Pro aceitam prompt_extend atualmente. LoRA aceita três listas opcionais de pesos, 480P/720P e 5/8 segundos. Wan Animate e FlashVSR usam o endpoint de vídeo com mídia de origem.
Todos os modelos Spicy exigem confirmação de acesso para adultos na conta e uma chave com permissão para o modelo e a capacidade. Guarde as chaves no servidor e reutilize Idempotency-Key ao repetir o mesmo envio.