PopNowAPI
Prendi la chiave API

P-Video 2 Pro API

di Pruna AI

Clip da 5 a 15 secondi con audio, da testo, fotogrammi o clip di riferimento

pruna-ai/p-video-2-pro/reference-to-video
  • Fino a 768p
  • Clip da 5 a 15 s
  • Fotogramma iniziale e finale
  • 7 formati
  • Crea video
  • Da immagine a video
  • Da riferimenti a video

Lo chiami con il nome di modello pruna-ai/p-video-2-pro/reference-to-video su POST /jobs/createTask, da 0,09 USD.

Nome del modellopruna-ai/p-video-2-pro/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": "pruna-ai/p-video-2-pro/reference-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "aspect_ratio": "auto",
    "resolution": "768p",
    "generation_mode": "speed",
    "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
generation_mode costresolution 480p0,018 USD
generation_mode speedresolution 480p0,024 USD
generation_mode costresolution 768p0,03 USD
generation_mode speedresolution 768p0,042 USD

Addebiti in USD · Tutte le opzioni e i prezzi: GET /models/pruna-ai/p-video-2-pro/reference-to-video

Limiti

Durata della clip
5–15 s
Risoluzioni
480p · 768p
Proporzioni
auto · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +2
Audio di riferimento
3
Video di riferimento
3

Parametri

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

  • promptstringObbligatorio

    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.

    Intervallo
    1 – … chars
  • image_urlstringFacoltativoCambia il prezzo

    L'immagine di partenza.

    Intervallo
    image/jpeg, image/png, image/webp, image/gif
  • last_image_urlstringFacoltativoCambia il prezzo

    Fotogramma finale facoltativo, perché la clip finisca esattamente dove vuoi.

    Intervallo
    image/jpeg, image/png, image/webp, image/gif
  • reference_video_urlsarray<string>FacoltativoCambia il prezzo

    Clip di cui seguire il movimento, la camera o lo stile.

    Intervallo
    1 – 3 items · video/mp4, video/webm, video/quicktime, video/x-m4v
  • reference_audio_urlsarray<string>FacoltativoCambia il prezzo

    Audio da riprendere: una voce, una musica o un ritmo.

    Intervallo
    1 – 3 items · audio/mpeg, audio/wav, audio/mp4, audio/aac +3
  • aspect_ratiostringFacoltativo

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

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

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

    Predefinito
    "768p"
    Valori ammessi
    "480p""768p"
  • generation_modestringFacoltativoCambia il prezzo

    cost is cheaper and slower, speed (the default) is faster at the same quality.

    Predefinito
    "speed"
    Valori ammessi
    "cost""speed"
  • keep_reference_audiobooleanFacoltativo

    Use the reference audio as the soundtrack instead of generating new sound. Needs exactly one audio clip.

    Predefinito
    false
  • duration_secondsintegerFacoltativoCambia il prezzo

    Quanto dura la clip. Si paga al secondo.

    Predefinito
    5
    Intervallo
    5 – 15
  • prompt_optimization_modestringFacoltativo

    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.

    Predefinito
    "off"
    Valori ammessi
    "off""turbo""max"
  • seedintegerFacoltativo

    Lo stesso numero dà un risultato ripetibile.

    Intervallo
    0 – 2147483647
JSON Schema grezzo
{
  "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"
    },
    "duration_seconds": {
      "default": 5,
      "description": "Output length in whole seconds, from 5 to 15. Billed per second.",
      "maximum": 15,
      "minimum": 5,
      "type": "integer"
    },
    "generation_mode": {
      "default": "speed",
      "description": "cost is cheaper and slower, speed (the default) is faster at the same quality.",
      "enum": [
        "cost",
        "speed"
      ],
      "type": "string"
    },
    "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"
    },
    "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"
    },
    "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"
    },
    "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"
    },
    "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"
    },
    "reference_audio_urls": {
      "items": {
        "contentMediaType": [
          "audio/mpeg",
          "audio/wav",
          "audio/mp4",
          "audio/aac",
          "audio/ogg",
          "audio/opus",
          "audio/flac"
        ],
        "format": "uri",
        "type": "string"
      },
      "maxItems": 3,
      "minItems": 1,
      "type": "array"
    },
    "reference_video_urls": {
      "items": {
        "contentMediaType": [
          "video/mp4",
          "video/webm",
          "video/quicktime",
          "video/x-m4v"
        ],
        "format": "uri",
        "type": "string"
      },
      "maxItems": 3,
      "minItems": 1,
      "type": "array"
    },
    "resolution": {
      "default": "768p",
      "description": "Output resolution. 768p costs more per second than 480p.",
      "enum": [
        "480p",
        "768p"
      ],
      "type": "string"
    },
    "seed": {
      "description": "Random seed for controlled comparisons, not a frame-identical guarantee.",
      "maximum": 2147483647,
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "prompt"
  ],
  "type": "object"
}

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": "pruna-ai/p-video-2-pro/reference-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "aspect_ratio": "auto",
    "resolution": "768p",
    "generation_mode": "speed",
    "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": "pruna-ai/p-video-2-pro/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.

Informazioni su P-Video 2 Pro

Clip da 5 a 15 secondi con audio, da testo, fotogrammi o clip di riferimento.

Lo chiami con il nome di modello pruna-ai/p-video-2-pro/reference-to-video su POST /jobs/createTask, da 0,09 USD.

Parametri della richiesta

ParametroObbligatorioDescrizione
aspect_ratioNoLa forma dell'inquadratura: larga, quadrata o verticale. auto · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 1:1 · Predefinito: auto
duration_secondsNoQuanto dura la clip. Si paga al secondo. ≥ 5 · ≤ 15 · Predefinito: 5
generation_modeNocost is cheaper and slower, speed (the default) is faster at the same quality. cost · speed · Predefinito: speed
image_urlNoL'immagine di partenza.
keep_reference_audioNoUse the reference audio as the soundtrack instead of generating new sound. Needs exactly one audio clip. Predefinito: false
last_image_urlNoFotogramma finale facoltativo, perché la clip finisca esattamente dove vuoi.
promptSì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.
prompt_optimization_modeNoLet 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. off · turbo · max · Predefinito: off
reference_audio_urlsNoAudio da riprendere: una voce, una musica o un ritmo.
reference_video_urlsNoClip di cui seguire il movimento, la camera o lo stile.
resolutionNoDimensione dell'output. Più grande è più nitido e costa di più. 480p · 768p · Predefinito: 768p
seedNoLo stesso numero dà un risultato ripetibile. ≥ 0 · ≤ 2147483647

Prezzi

I prezzi sono in USD. L’API usa un saldo separato in dollari statunitensi. I crediti del sito non si possono usare per l’API né convertire in saldo API; il saldo API non si può convertire in crediti del sito. 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.

OpzioneUSD al secondo
generation_mode cost · resolution 480p0,018 USD
generation_mode speed · resolution 480p0,024 USD
generation_mode cost · resolution 768p0,03 USD
generation_mode speed · resolution 768p0,042 USD

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.

Guida rapida all'API

Chiama l'API di P-Video 2 Pro in tre passaggi

  1. Crea una chiave API. Accedi a PopNow e crea una chiave nella console API. Le chiavi iniziano con sk-popnow-. Le chiamate usano il tuo saldo separato in dollari statunitensi.
  2. Invia la richiesta. Invia POST /jobs/createTask con model pruna-ai/p-video-2-pro/reference-to-video e un oggetto input secondo la tabella dei parametri. La risposta restituisce subito un ID attività.
  3. Recupera il risultato. Interroga GET /jobs/recordInfo con l'ID attività, oppure passa una callBackUrl e ti inviamo lì il risultato. Scarica i link di output quando l'attività riesce.
# 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": "pruna-ai/p-video-2-pro/reference-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "aspect_ratio": "auto",
    "resolution": "768p",
    "generation_mode": "speed",
    "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"

Sostituisci il prompt e gli eventuali link con i tuoi. La scheda API contiene il riferimento per risposta, polling e callback.

Domande sull’API di P-Video 2 Pro

Quanto costa l’API di P-Video 2 Pro?

P-Video 2 Pro costa da 0,09 USD per una clip di 5 secondi con Da riferimenti a video, il suo task più economico. Prezzi per opzione: cost · 480p 0,018 USD al secondo, speed · 480p 0,024 USD al secondo, cost · 768p 0,03 USD al secondo, speed · 768p 0,042 USD al secondo. L’API usa un saldo separato in dollari statunitensi. I crediti del sito non si possono usare per l’API né convertire in saldo API; il saldo API non si può convertire in crediti del sito. 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.

Quali sono i limiti dell’API di P-Video 2 Pro · Da riferimenti a video?

Durata della clip: 5–15 s; Risoluzioni: 480p · 768p; Proporzioni: auto · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +2; Audio di riferimento: 3; Video di riferimento: 3. Le richieste fuori da questi limiti vengono rifiutate prima di qualsiasi addebito.

Altro su P-Video 2 Pro