PopNowAPI
Prendi la chiave API

di PixVerse

Clip da 1 a 15 secondi fino a 1080p, con riferimenti e transizioni

pixverse/v6/reference-to-video
  • Fino a 1080p
  • Clip da 1 a 15 s
  • Audio incluso
  • Fotogramma iniziale e finale
  • 8 formati
  • Crea video
  • Da immagine a video
  • Da riferimenti a video
  • Allunga video

Lo chiami con il nome di modello pixverse/v6/reference-to-video su POST /jobs/createTask, da 0,111 USD.

Nome del modellopixverse/v6/reference-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/reference-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "elements": [
      {
        "name": "example",
        "image_url": "https://media.popnow.ai/influencer/examples/marco.webp"
      }
    ],
    "aspect_ratio": "16:9",
    "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"

L’input è costruito dallo schema qui sotto, quindi supera la verifica così com’è. Sostituisci prompt e link con i tuoi.

Prezzo

OpzioneUSD al secondo
generate_audio falseresolution 360p0,0222 USD
generate_audio falseresolution 540p0,0311 USD
generate_audio trueresolution 360p0,0311 USD
generate_audio falseresolution 720p0,04 USD
generate_audio trueresolution 540p0,04 USD
generate_audio trueresolution 720p0,0533 USD
generate_audio falseresolution 1080p0,08 USD
generate_audio trueresolution 1080p0,1022 USD

Addebiti in USD · Tutte le opzioni e i prezzi: GET /models/pixverse/v6/reference-to-video

Limiti

Durata della clip
1–15 s
Risoluzioni
360p · 540p · 720p · 1080p
Proporzioni
16:9 · 4:3 · 1:1 · 3:4 · 9:16 · 2:3 +2
Lunghezza del prompt (caratteri)
5,000

Parametri

Questi campi vengono dallo stesso schema con cui verifichiamo ogni richiesta. I campi non elencati vengono rifiutati.

  • promptstringObbligatorio

    Describe the shot and place each reference with @name.

    Intervallo
    3 – 5000 chars
  • elementsarray<object>Obbligatorio

    One to seven named references. Write @name in the prompt, followed by a space, where each should appear.

    Intervallo
    1 – 7 items
    Campi interni
    • elements[].namestringObbligatorio

      Name to write as @name in the prompt, up to 30 characters.

      Intervallo
      1 – 30 chars
    • elements[].image_urlstringObbligatorio

      One picture of this subject or place.

    • elements[].rolestringFacoltativo

      subject for a person, animal, object or product; background for a place.

      Predefinito
      "subject"
      Valori ammessi
      "subject""background"
  • aspect_ratiostringFacoltativo

    La forma dell'inquadratura: larga, quadrata o verticale.

    Predefinito
    "16:9"
    Valori ammessi
    "16:9""4:3""1:1""3:4""9:16""2:3""3:2""21:9"
  • resolutionstringFacoltativoCambia il prezzo

    Dimensione dell'output. Più grande è più nitido e costa di più.

    Predefinito
    "720p"
    Valori ammessi
    "360p""540p""720p""1080p"
  • duration_secondsintegerFacoltativoCambia il prezzo

    Quanto dura la clip. Si paga al secondo.

    Predefinito
    5
    Intervallo
    1 – 15
  • generate_audiobooleanFacoltativoCambia il prezzo

    Aggiunge un audio adatto all'immagine: voci, ambiente ed effetti.

    Predefinito
    false
  • seedintegerFacoltativo

    Lo stesso numero dà un risultato ripetibile.

    Intervallo
    0 – 2147483647
JSON Schema grezzo
{
  "type": "object",
  "required": [
    "elements",
    "prompt"
  ],
  "properties": {
    "seed": {
      "type": "integer",
      "maximum": 2147483647,
      "minimum": 0,
      "description": "Random seed for controlled comparisons."
    },
    "prompt": {
      "type": "string",
      "maxLength": 5000,
      "minLength": 3,
      "description": "Describe the shot and place each reference with @name."
    },
    "elements": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "image_url"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 30,
            "minLength": 1,
            "description": "Name to write as @name in the prompt, up to 30 characters."
          },
          "role": {
            "enum": [
              "subject",
              "background"
            ],
            "type": "string",
            "default": "subject",
            "description": "subject for a person, animal, object or product; background for a place."
          },
          "image_url": {
            "type": "string",
            "format": "uri",
            "description": "One picture of this subject or place."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 7,
      "minItems": 1,
      "description": "One to seven named references. Write @name in the prompt, followed by a space, where each should appear."
    },
    "resolution": {
      "enum": [
        "360p",
        "540p",
        "720p",
        "1080p"
      ],
      "type": "string",
      "default": "720p",
      "description": "Output resolution. Higher tiers cost more per second."
    },
    "aspect_ratio": {
      "enum": [
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16",
        "2:3",
        "3:2",
        "21:9"
      ],
      "type": "string",
      "default": "16:9",
      "description": "Output aspect ratio."
    },
    "generate_audio": {
      "type": "boolean",
      "default": false,
      "description": "Generate sound with the picture. Costs more per second when on."
    },
    "duration_seconds": {
      "type": "integer",
      "default": 5,
      "maximum": 15,
      "minimum": 1,
      "description": "Clip length in whole seconds, 1 to 15. Billed per second."
    }
  },
  "additionalProperties": false
}

Un risultato reale di PixVerse V6

Prompt@kai plays a DJ set on @beach at blue hour, nodding to the beat with headphones on as glowing bubbles float up around the decks and the waves roll in behind him. Slow orbiting camera, cinematic.
La stessa richiesta tramite API
{
  "model": "pixverse/v6/reference-to-video",
  "input": {
    "prompt": "@kai plays a DJ set on @beach at blue hour, nodding to the beat with headphones on as glowing bubbles float up around the decks and the waves roll in behind him. Slow orbiting camera, cinematic.",
    "elements": [
      {
        "name": "example",
        "image_url": "https://media.popnow.ai/influencer/examples/marco.webp"
      }
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration_seconds": 5,
    "generate_audio": false
  }
}

Risposte, polling e callback

Tutti i modelli funzionano allo stesso modo: crei un task, poi lo interroghi o aspetti la callback.

Prima il prezzo

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/reference-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "elements": [
      {
        "name": "example",
        "image_url": "https://media.popnow.ai/influencer/examples/marco.webp"
      }
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration_seconds": 5
  }
}'

Prima di eseguire, invia lo stesso corpo della richiesta a POST /jobs/quote per vedere il costo stimato e quello massimo in USD. Il preventivo non esegue alcuna richiesta né addebita il saldo.

Accettata

HTTP
HTTP/1.1 202 Accepted

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

HTTP 202 indica che la richiesta è stata accettata: il massimo in USD resta riservato fino al conteggio finale. Quando una richiesta viene accettata, riserviamo l’importo massimo del preventivo sul tuo saldo API. Al termine addebitiamo l’uso effettivo, senza superare la riserva, e liberiamo il resto. Se la richiesta fallisce, l’importo riservato viene sbloccato.

Controlla lo stato

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

Controlla ogni pochi secondi allungando via via l’intervallo e fermati quando state è succeeded, failed, canceled o expired.

Task completato

JSON
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "pixverse/v6/reference-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"
}

Scarica dall’url prima di expiresAt. Ti serve un link nuovo più tardi? Chiedilo con POST /common/download-url.

Verifica una 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
});

Con callBackUrl impostata ti inviamo il task completato. Verifica la firma sul corpo grezzo prima di fidarti.

Invia un file locale

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.

I link https pubblici funzionano così come sono. I file locali passano prima da upload-url e commit.