Clip da 1 a 15 secondi fino a 1080p, con riferimenti e transizioni
- 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.
pixverse/v6/reference-to-videoPOST 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"// Node 18+ (or any runtime with fetch). Keep the API key on your server.
const BASE = "https://api.popnow.ai/api/v1";
const headers = { Authorization: `Bearer ${process.env.POPNOW_API_KEY}` };
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
async function call(path, init = {}) {
const res = await fetch(BASE + path, { ...init, headers: { ...headers, ...init.headers } });
const body = await res.json();
if (body.code !== 200) throw new Error(`${body.code} ${body.msg}`);
return body.data;
}
const { taskId } = await call("/jobs/createTask", {
method: "POST",
headers: { "Content-Type": "application/json", "Idempotency-Key": crypto.randomUUID() },
body: JSON.stringify({
"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
}
}),
});
// Poll with backoff. A finished task may still be copying files: wait while an asset is pending.
let task;
for (let delay = 2000; ; delay = Math.min(delay * 1.5, 15000)) {
await sleep(delay);
task = await call(`/jobs/recordInfo?taskId=${taskId}`);
const copying = (task.output?.assets ?? []).some((a) => a.pending && !a.unavailable);
if (["succeeded", "failed", "canceled", "expired"].includes(task.state) && !copying) break;
}
if (task.state !== "succeeded") throw new Error(`${task.state}: ${task.errorMessage ?? "no detail"}`);
// Each asset has a signed url (no API key needed) that expires at expiresAt: save the file.
for (const asset of task.output.assets) console.log(asset.url);import os, time, uuid, requests
BASE = "https://api.popnow.ai/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['POPNOW_API_KEY']}"}
def call(method, path, **kwargs):
body = requests.request(method, BASE + path, headers={**HEADERS, **kwargs.pop("headers", {})}, timeout=30, **kwargs).json()
if body["code"] != 200:
raise RuntimeError(f'{body["code"]} {body["msg"]}')
return body["data"]
task_id = call(
"POST",
"/jobs/createTask",
headers={"Idempotency-Key": str(uuid.uuid4())}, # reuse it if you retry
json={
"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
}
},
)["taskId"]
# Poll with backoff. A finished task may still be copying files: wait while an asset is pending.
delay = 2.0
while True:
time.sleep(delay)
task = call("GET", "/jobs/recordInfo", params={"taskId": task_id})
assets = (task.get("output") or {}).get("assets") or []
copying = any(a.get("pending") and not a.get("unavailable") for a in assets)
if task["state"] in ("succeeded", "failed", "canceled", "expired") and not copying:
break
delay = min(delay * 1.5, 15.0)
if task["state"] != "succeeded":
raise RuntimeError(f'{task["state"]}: {task.get("errorMessage", "no detail")}')
# Each asset has a signed url (no API key needed) that expires at expiresAt: save the file.
for asset in assets:
print(asset["url"])L’input è costruito dallo schema qui sotto, quindi supera la verifica così com’è. Sostituisci prompt e link con i tuoi.
Prezzo
| Opzione | USD al secondo |
|---|---|
generate_audio falseresolution 360p | 0,0222 USD |
generate_audio falseresolution 540p | 0,0311 USD |
generate_audio trueresolution 360p | 0,0311 USD |
generate_audio falseresolution 720p | 0,04 USD |
generate_audio trueresolution 540p | 0,04 USD |
generate_audio trueresolution 720p | 0,0533 USD |
generate_audio falseresolution 1080p | 0,08 USD |
generate_audio trueresolution 1080p | 0,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.
promptstringObbligatorioDescribe the shot and place each reference with @name.
elementsarray<object>ObbligatorioOne to seven named references. Write @name in the prompt, followed by a space, where each should appear.
Campi interni
elements[].namestringObbligatorioName to write as @name in the prompt, up to 30 characters.
elements[].image_urlstringObbligatorioOne picture of this subject or place.
elements[].rolestringFacoltativosubject for a person, animal, object or product; background for a place.
aspect_ratiostringFacoltativoLa forma dell'inquadratura: larga, quadrata o verticale.
resolutionstringFacoltativoCambia il prezzoDimensione dell'output. Più grande è più nitido e costa di più.
duration_secondsintegerFacoltativoCambia il prezzoQuanto dura la clip. Si paga al secondo.
generate_audiobooleanFacoltativoCambia il prezzoAggiunge un audio adatto all'immagine: voci, ambiente ed effetti.
seedintegerFacoltativoLo stesso numero dà un risultato ripetibile.
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
@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.
{
"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 -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/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 "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
{
"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
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 -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.