promptstringObrigatórioDiga o que tirar de cada referência. Escreva video 1, video 2 para vídeos de referência e audio 1, audio 2 para clipes de áudio, numerados na ordem do upload.
- Valor padrão
- Não especificado
- Restrições
- minLength:1
pruna-ai/p-video-2-pro/reference-to-videoO referência para vídeo do P-Video 2 Pro monta um clipe de 5 a 15 segundos em 480p ou 768p a partir de até 3 vídeos e 3 clipes de áudio de referência, citados no prompt como video 1 e audio 1, além de um quadro inicial e final opcionais. Sem filtro de conteúdo.
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çõeshttps://api.spicyapi.ai/api/v1/jobs/createTaskGuarde 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# 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": "pruna-ai/p-video-2-pro/reference-to-video",
"input": {
"aspect_ratio": "auto",
"duration_seconds": 5,
"generation_mode": "speed",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"prompt_optimization_mode": "off",
"resolution": "768p"
}
}'
# 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.
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.
promptstringObrigatórioDiga o que tirar de cada referência. Escreva video 1, video 2 para vídeos de referência e audio 1, audio 2 para clipes de áudio, numerados na ordem do upload.
seedintegerOpcionalMantém as execuções comparáveis enquanto você muda o prompt. Não garante um clipe idêntico quadro a quadro.
prompt_optimization_modestringOpcionaloff (padrão) envia o seu prompt palavra por palavra; turbo e max deixam o serviço reescrevê-lo antes. Não altera o preço.
"off""turbo""max"duration_secondsintegerOpcionalAfeta o preçoSegundos inteiros, de 5 a 15 (padrão 5). Define o preço.
keep_reference_audiobooleanOpcionalDesligado por padrão. Ligado usa o seu clipe de áudio como trilha sonora no lugar de gerar um som novo; exige exatamente um clipe de áudio.
generation_modestringOpcionalAfeta o preçocost (mais barato, um pouco mais lento) ou speed (padrão, mais rápido com a mesma qualidade).
"cost""speed"resolutionstringOpcionalAfeta o preço480p ou 768p (padrão 768p). 768p custa mais por segundo.
"480p""768p"aspect_ratiostringOpcionalauto (padrão) se adapta às referências; ou escolha 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 ou 1:1. Não altera o preço.
"auto""16:9""9:16""4:3""3:4""3:2""2:3""1:1"reference_audio_urlsarray<string>OpcionalAfeta o preçoAté 3 clipes de áudio, 15 segundos no total, para uma voz, diálogo ou música. Exige também um quadro inicial ou um vídeo de referência. Adiciona uma taxa fixa.
reference_video_urlsarray<string>OpcionalAfeta o preçoAté 3 vídeos, de 2 segundos ou mais cada e 15 segundos no total, para movimento, câmera e ritmo. Os segundos deles são cobrados, mais um segundo para arredondamento.
last_image_urlstringOpcionalAfeta o preçoQuadro final opcional em que o clipe termina. Adiciona uma pequena cobrança.
image_urlstringOpcionalAfeta o preçoQuadro inicial opcional: quem e onde o plano começa. Adiciona uma pequena cobrança.
{
"additionalProperties": false,
"properties": {
"aspect_ratio": {
"default": "auto",
"description": "Output aspect ratio; auto adapts to the references.",
"enum": [
"auto",
"16:9",
"9:16",
"4:3",
"3:4",
"3:2",
"2:3",
"1:1"
],
"type": "string",
"x-ui": {
"order": 80,
"widget": "select"
}
},
"duration_seconds": {
"default": 5,
"description": "Output length in whole seconds, from 5 to 15. Billed per second.",
"maximum": 15,
"minimum": 5,
"type": "integer",
"x-ui": {
"affects_price": true,
"order": 60,
"step": 1,
"unit": "s",
"widget": "slider"
}
},
"generation_mode": {
"default": "speed",
"description": "cost is cheaper and slower, speed (the default) is faster at the same quality.",
"enum": [
"cost",
"speed"
],
"type": "string",
"x-ui": {
"affects_price": true,
"order": 65,
"widget": "radio"
}
},
"image_url": {
"contentMediaType": [
"image/jpeg",
"image/png",
"image/webp",
"image/gif"
],
"description": "Optional opening frame. Adds a small per-image charge.",
"format": "uri",
"type": "string",
"x-ui": {
"affects_price": true,
"order": 92,
"widget": "upload"
}
},
"keep_reference_audio": {
"default": false,
"description": "Use the reference audio as the soundtrack instead of generating new sound. Needs exactly one audio clip.",
"type": "boolean",
"x-ui": {
"order": 63,
"widget": "switch"
}
},
"last_image_url": {
"contentMediaType": [
"image/jpeg",
"image/png",
"image/webp",
"image/gif"
],
"description": "Optional closing frame. Adds a small per-image charge.",
"format": "uri",
"type": "string",
"x-ui": {
"affects_price": true,
"order": 91,
"widget": "upload"
}
},
"prompt": {
"description": "Say what the shot should take from each reference. Refer to reference videos as video 1, video 2 and to audio clips as audio 1, audio 2, numbered in upload order.",
"minLength": 1,
"type": "string",
"x-ui": {
"order": 100,
"primary": true,
"reference_tokens": {
"reference_audio_urls": "audio {index}",
"reference_video_urls": "video {index}"
},
"widget": "textarea"
}
},
"prompt_optimization_mode": {
"default": "off",
"description": "Let the service rewrite and expand the prompt first: off follows it word for word, turbo is a quick rewrite, max a fuller one. Does not change the price.",
"enum": [
"off",
"turbo",
"max"
],
"type": "string",
"x-ui": {
"advanced": true,
"affects_price": false,
"order": 30,
"widget": "radio"
}
},
"reference_audio_urls": {
"description": "Reference audio for a voice, dialogue or music: up to 3 clips, 15 seconds in total. Needs an opening frame or a reference video as well. Refer to them as audio 1, audio 2.",
"items": {
"contentMediaType": [
"audio/mpeg",
"audio/wav"
],
"format": "uri",
"type": "string"
},
"maxItems": 3,
"minItems": 1,
"type": "array",
"x-ui": {
"accept": [
"audio/mpeg",
"audio/wav"
],
"affects_price": true,
"max_total_duration_seconds": 15,
"order": 88,
"widget": "multi-upload"
}
},
"reference_video_urls": {
"description": "Reference videos for motion, camera and pacing: up to 3, 2 seconds or longer each and 15 seconds in total. Refer to them as video 1, video 2. Their seconds are billed too.",
"items": {
"contentMediaType": [
"video/mp4",
"video/webm",
"video/quicktime"
],
"format": "uri",
"type": "string"
},
"maxItems": 3,
"minItems": 1,
"type": "array",
"x-ui": {
"accept": [
"video/mp4",
"video/webm"
],
"affects_price": true,
"max_total_duration_seconds": 15,
"order": 90,
"widget": "multi-upload"
}
},
"resolution": {
"default": "768p",
"description": "Output resolution. 768p costs more per second than 480p.",
"enum": [
"480p",
"768p"
],
"type": "string",
"x-ui": {
"affects_price": true,
"order": 70,
"widget": "radio"
}
},
"seed": {
"description": "Random seed for controlled comparisons, not a frame-identical guarantee.",
"maximum": 2147483647,
"minimum": 0,
"type": "integer",
"x-ui": {
"order": 10,
"widget": "number"
}
}
},
"required": [
"prompt"
],
"type": "object",
"x-pricing": {
"billingMode": "formula",
"variantFields": [
"generation_mode",
"resolution"
]
}
}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.
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.
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.
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.
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.
{
"code": 200,
"msg": "success",
"request_id": "req_example_record",
"data": {
"taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
"model": "pruna-ai/p-video-2-pro/reference-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.
Use a SpicyAPI no seu app, terminal, assistente de IA ou fluxo visual. Escolha um guia de configuração.
Você não precisa escrever nada do código acima. Conecte o servidor MCP uma vez e qualquer agente que fale MCP — Claude Code, Codex, Cursor, Windsurf, VS Code, Gemini CLI, Cline, LibreChat — chama este modelo pelo nome. Ou rode direto do terminal, em um comando só.
Com pruna-ai/p-video-2-pro/reference-to-video, faça um plano de cinco segundos: terraço em luz de neon ao anoitecer, aproximação lenta, e salve em ./out/.
O agente procura o modelo no catálogo atual e envia o arquivo local por você. Em seguida, mostra a estimativa exata de preço e o valor máximo de cobrança e espera sua confirmação. Nada é cobrado até você autorizar.
claude mcp add spicyapi -e SPICY_API_KEY=$SPICY_API_KEY \
-- npx --yes --package=@spicyapi/mcp spicyapi-mcp
npx skills add spicyapi-ai/spicy-skillA primeira linha entrega as ferramentas ao agente; a segunda, a Skill com as regras de uso: mostrar a estimativa antes de cobrar, enviar arquivos locais em vez de colar bytes e ler a URL do arquivo concluído em vez de adivinhá-la. Os demais clientes usam o mesmo servidor pelo próprio arquivo de configuração: veja a área do desenvolvedor.
npx @spicyapi/cli tasks create --model pruna-ai/p-video-2-pro/reference-to-video \
--input-json '{"aspect_ratio":"auto","duration_seconds":5,"generation_mode":"speed","prompt":"A slow aerial shot drifting over a misty pine forest at sunrise","prompt_optimization_mode":"off","resolution":"768p"}' \
--waitA entrada vem do schema deste endpoint, igual aos exemplos acima. --wait acompanha a tarefa até o fim e imprime o resultado; use --yes para pular a confirmação na CI. Defina antes o SPICY_API_KEY — a mesma chave serve para a API, a CLI e o servidor MCP.
npx @spicyapi/cli tasks create --model pruna-ai/p-video-2-pro/reference-to-video \
--input-json '{…}' --retention 1h --wait
npx @spicyapi/cli tasks get $TASK_ID # read back the retention that appliedO --retention só encurta o prazo — 30m, 1h, 7d, ou 0 para apagar assim que a tarefa chega a um estado final. O valor que realmente vale é o menor entre a sua requisição, as configurações da conta e o limite da plataforma; então releia do registro da tarefa em vez de supor que o número pedido valeu. Pedir um prazo maior do que a conta permite não faz nada.
Instale os nós da SpicyAPI pelo ComfyUI Manager ou com o comando abaixo e procure por P-Video 2 Pro · Reference 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-spicyapiO painel incorporado lê o mesmo schema desta página, então não tem como sair de sincronia com a API. Se a sua documentação precisar de conteúdo indexável, pegue o JSON em /api/embed/models/ e renderize por conta própria.
<iframe src="https://spicyapi.ai/embed/pt-BR/models/p-video-2-pro/api?model=pruna-ai%2Fp-video-2-pro%2Freference-to-video" width="100%" height="560" loading="lazy" title="Exemplo de requisição" style="border:1px solid rgba(0,0,0,.12)"></iframe>