PopNowAPI
Pegue sua chave de API

da PixVerse

O topo da linha PixVerse: clipes em 1080p com som opcional

pixverse/v6-max/image-to-video
  • Até 1080p
  • Clipes de 1 a 15 s
  • Com som
  • 8 proporções
  • Criar vídeo
  • Imagem para vídeo

Chame com o nome de modelo pixverse/v6-max/image-to-video em POST /jobs/createTask, a partir de US$ 0,133.

Nome do modelopixverse/v6-max/image-to-video
EndpointPOST https://api.popnow.ai/api/v1/jobs/createTask
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "pixverse/v6-max/image-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "720p",
    "duration_seconds": 5
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

O input é montado a partir do schema abaixo, então passa na validação como está. Troque o prompt e os links pelos seus.

Preço

OpçãoUSD por segundo
generate_audio falseresolution 360pUS$ 0,0266
generate_audio falseresolution 540pUS$ 0,04
generate_audio trueresolution 360pUS$ 0,04
generate_audio falseresolution 720pUS$ 0,0488
generate_audio trueresolution 540pUS$ 0,0488
generate_audio trueresolution 720pUS$ 0,0666
generate_audio falseresolution 1080pUS$ 0,0977
generate_audio trueresolution 1080pUS$ 0,1244

Cobrança em USD · Todas as opções e preços: GET /models/pixverse/v6-max/image-to-video

Limites

Duração do clipe
1–15 s
Resoluções
360p · 540p · 720p · 1080p
Tamanho do prompt (caracteres)
5,000
Maior upload
20 MB

Parâmetros

Estes campos vêm do mesmo schema que usamos para validar cada requisição. Campos que não estão na lista são rejeitados.

  • promptstringObrigatório

    What happens after the first frame.

    Faixa
    1 – 5000 chars
  • image_urlstringObrigatório

    A imagem de partida.

    Faixa
    image/jpeg, image/png, image/webp, image/gif · ≤ 20 MB
  • resolutionstringOpcionalMuda o preço

    Tamanho de saída. Maior fica mais nítido e custa mais.

    Padrão
    "720p"
    Valores aceitos
    "360p""540p""720p""1080p"
  • duration_secondsintegerOpcionalMuda o preço

    Quanto tempo dura o clipe. Cobrado por segundo.

    Padrão
    5
    Faixa
    1 – 15
  • generate_audiobooleanOpcionalMuda o preço

    Adiciona som combinando com a imagem: vozes, ambiente e efeitos.

    Padrão
    false
  • seedintegerOpcional

    Repetir o mesmo número dá um resultado reproduzível.

    Faixa
    0 – 2147483647
JSON Schema bruto
{
  "additionalProperties": false,
  "properties": {
    "duration_seconds": {
      "default": 5,
      "description": "Clip length in whole seconds, 1 to 15. Billed per second.",
      "maximum": 15,
      "minimum": 1,
      "type": "integer"
    },
    "generate_audio": {
      "default": false,
      "description": "Generate sound with the picture. Costs more per second when on.",
      "type": "boolean"
    },
    "image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "First frame. JPG, PNG or WebP up to 20 MB, each side up to 10,000 px; the clip's aspect ratio follows this image.",
      "format": "uri",
      "type": "string"
    },
    "prompt": {
      "description": "What happens after the first frame.",
      "maxLength": 5000,
      "minLength": 1,
      "type": "string"
    },
    "resolution": {
      "default": "720p",
      "description": "Output resolution. Higher tiers cost more per second.",
      "enum": [
        "360p",
        "540p",
        "720p",
        "1080p"
      ],
      "type": "string"
    },
    "seed": {
      "description": "Random seed for controlled comparisons.",
      "maximum": 2147483647,
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "image_url",
    "prompt"
  ],
  "type": "object"
}

Um resultado real do PixVerse V6 Max

PromptHe springs off the pile of giant balloons and soars across the rooftop at golden hour, arms wide, laughing, as the balloons bounce and wobble below him. Dynamic slow-motion camera follows the jump.
A mesma requisição pela API
{
  "model": "pixverse/v6-max/image-to-video",
  "input": {
    "prompt": "He springs off the pile of giant balloons and soars across the rooftop at golden hour, arms wide, laughing, as the balloons bounce and wobble below him. Dynamic slow-motion camera follows the jump.",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "720p",
    "duration_seconds": 5,
    "generate_audio": false
  }
}

Este resultado partiu de um arquivo enviado: coloque o seu link no lugar do link de exemplo.

Respostas, consultas e callbacks

Todos os modelos funcionam do mesmo jeito: crie uma tarefa e depois consulte ou espere o callback.

Veja o preço antes

cURL
curl -X POST https://api.popnow.ai/api/v1/jobs/quote \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "pixverse/v6-max/image-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "720p",
    "duration_seconds": 5
  }
}'

Antes de executar, envie o mesmo corpo de requisição para POST /jobs/quote para ver o custo estimado e o máximo em USD. O orçamento não executa tarefas nem debita seu saldo.

Aceita

HTTP
HTTP/1.1 202 Accepted

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued"
  },
  "request_id": "req_example_create"
}

HTTP 202 significa que a tarefa foi aceita: o máximo em USD fica reservado até o acerto final. Ao aceitar uma tarefa, reservamos o valor máximo do orçamento no seu saldo de API. Ao concluir, cobramos o uso real sem ultrapassar a reserva e liberamos o restante. Se a tarefa falhar, o valor reservado é liberado.

Consultar status

cURL
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Consulte a cada poucos segundos, espaçando cada vez mais, e pare quando state for succeeded, failed, canceled ou expired.

Tarefa pronta

JSON
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "pixverse/v6-max/image-to-video",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "url": "https://cdn.popnow.ai/tasks/task_01k3m8x9q2z4v7n5p6r8s0t1w3/output.mp4?signature=FROM_RESPONSE",
          "expiresAt": "2026-10-17T12:20:00Z",
          "mime": "video/mp4",
          "width": 1280,
          "height": 720,
          "durationSeconds": 5
        }
      ]
    },
    "settled": true
  },
  "request_id": "req_example_record"
}

Baixe pela url antes de expiresAt. Precisa de um link novo depois? Peça com POST /common/download-url.

Verificar um callback

Node.js
import { createHash, createHmac, timingSafeEqual } from "node:crypto";
import express from "express";

const app = express();
// express.raw keeps the exact bytes that were signed; express.json would not match.
app.post("/hooks/popnow", express.raw({ type: "application/json" }), (req, res) => {
  const timestamp = req.header("X-Webhook-Timestamp");
  const signature = req.header("X-Webhook-Signature") ?? "";
  const body = JSON.parse(req.body.toString("utf8"));
  const taskId = body.data?.taskId ?? body.task_id;
  const digest = createHash("sha256").update(req.body).digest("hex");
  const expected = createHmac("sha256", process.env.POPNOW_WEBHOOK_SECRET)
    .update(`${taskId}.${timestamp}.${digest}`)
    .digest("base64");
  const ok = expected.length === signature.length && timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
  // Check the signature first, then reject anything older than five minutes.
  if (!ok || Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return res.status(401).end();
  res.status(200).end(); // answer fast, then fetch the task and store its files
});

Com callBackUrl definida, enviamos a tarefa pronta para você. Confira a assinatura no corpo bruto antes de confiar nela.

Enviar um arquivo local

cURL
curl -X POST https://api.popnow.ai/api/v1/common/upload-url \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contentType": "image/png", "bytes": 482113}'

# PUT the file bytes to data.uploadUrl with every header in data.headers, then commit it:
curl -X POST https://api.popnow.ai/api/v1/files/$FILE_ID/commit \
  -H "Authorization: Bearer $POPNOW_API_KEY"
# The commit returns a popnow://f/... reference. Put it in any image, video or
# audio field of the task input instead of a public https URL.

Links https públicos funcionam como estão. Arquivos locais passam antes por upload-url e commit.