PopNowAPI
Odbierz klucz API

Vidu Q3 Plus API

od Vidu

Vidu Q3: wideo z obrazu, do 16 sekund z dźwiękiem

vidu/q3-plus/video-extend
  • Do 1080p
  • Klipy 1–16 s
  • Z dźwiękiem
  • Obraz w wideo
  • Wydłuż wideo

Wywołujesz go nazwą modelu vidu/q3-plus/video-extend w POST /jobs/createTask, od 0,3325 USD.

Nazwa modeluvidu/q3-plus/video-extend
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": "vidu/q3-plus/video-extend",
  "input": {
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "duration_seconds": 5,
    "resolution": "720p",
    "movement_amplitude": "auto"
  }
}'

# 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"

input jest zbudowany ze schematu poniżej, więc przechodzi walidację bez zmian. Zamień prompt i linki na własne.

Cena

OpcjaUSD za sekundę
resolution 540p0,0665 USD
resolution 720p0,1425 USD
resolution 1080p0,152 USD

Rozliczenie w USD · Wszystkie opcje i ceny: GET /models/vidu/q3-plus/video-extend

Limity

Długość klipu
1–16 s
Rozdzielczości
540p · 720p · 1080p
Najdłuższy klip wejściowy
60 s

Parametry

Te pola pochodzą z tego samego schematu, którym sprawdzamy każde żądanie. Pola spoza listy są odrzucane.

  • video_urlstringWymagane

    Klip do obróbki.

    Zakres
    1 – … chars · video/mp4, video/webm, video/quicktime, video/x-m4v
  • promptstringOpcjonalne

    Optional. Describe what happens next: the action that follows, the camera move and the sound.

  • duration_secondsintegerOpcjonalneZmienia cenę

    Długość klipu. Płacisz za każdą sekundę.

    Domyślnie
    5
    Zakres
    1 – 16
  • resolutionstringOpcjonalneZmienia cenę

    Rozmiar wyniku. Większy jest ostrzejszy i droższy.

    Domyślnie
    "720p"
    Dozwolone wartości
    "540p""720p""1080p"
  • movement_amplitudestringOpcjonalne

    Jak mocno ruszają się obiekt i kamera.

    Domyślnie
    "auto"
    Dozwolone wartości
    "auto""small""medium""large"
  • generate_audiobooleanOpcjonalne

    Dodaje dźwięk pasujący do obrazu: głosy, tło i efekty.

    Domyślnie
    true
  • bgmbooleanOpcjonalne

    Add a background music bed to the new segment. The source keeps its own sound.

    Domyślnie
    true
Surowy JSON Schema
{
  "additionalProperties": false,
  "properties": {
    "bgm": {
      "default": true,
      "description": "Add a background music bed to the new segment. The source keeps its own sound.",
      "type": "boolean"
    },
    "duration_seconds": {
      "default": 5,
      "description": "Length of the new segment in seconds, from 1 to 16. The source clip is added on top and is not billed.",
      "maximum": 16,
      "minimum": 1,
      "type": "integer"
    },
    "generate_audio": {
      "default": true,
      "description": "Generate sound for the new segment. The source keeps its own sound either way.",
      "type": "boolean"
    },
    "movement_amplitude": {
      "default": "auto",
      "description": "How much things in the new segment move.",
      "enum": [
        "auto",
        "small",
        "medium",
        "large"
      ],
      "type": "string"
    },
    "prompt": {
      "description": "Optional. Describe what happens next: the action that follows, the camera move and the sound.",
      "type": "string"
    },
    "resolution": {
      "default": "720p",
      "description": "Resolution of the generated new segment. It sets how sharp the new part is; match your source clip.",
      "enum": [
        "540p",
        "720p",
        "1080p"
      ],
      "type": "string"
    },
    "video_url": {
      "contentMediaType": [
        "video/mp4",
        "video/webm",
        "video/quicktime",
        "video/x-m4v"
      ],
      "format": "uri",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "video_url"
  ],
  "type": "object"
}

Odpowiedzi, odpytywanie i callbacki

Wszystkie modele działają tak samo: utwórz zadanie, a potem odpytuj je albo poczekaj na callback.

Najpierw cena

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": "vidu/q3-plus/video-extend",
  "input": {
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "duration_seconds": 5,
    "resolution": "720p",
    "movement_amplitude": "auto"
  }
}'

Przed uruchomieniem wyślij tę samą treść żądania do POST /jobs/quote, aby zobaczyć szacowaną i maksymalną opłatę w USD. Wycena nie uruchamia zadania ani nie obciąża salda.

Przyjęte

HTTP
HTTP/1.1 202 Accepted

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

HTTP 202 oznacza przyjęcie zadania: maksymalna kwota w USD pozostaje zarezerwowana do rozliczenia. Po przyjęciu zadania rezerwujemy maksymalną kwotę wyceny na saldzie API. Po zakończeniu naliczamy opłatę za rzeczywiste użycie, nie wyższą niż rezerwacja, i zwalniamy resztę. Jeśli zadanie się nie powiedzie, rezerwacja zostaje zwolniona.

Sprawdź status

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

Odpytuj co kilka sekund, stopniowo wydłużając odstęp, i przestań, gdy state ma wartość succeeded, failed, canceled lub expired.

Gotowe zadanie

JSON
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "vidu/q3-plus/video-extend",
    "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"
}

Pobierz plik z url przed expiresAt. Potrzebujesz później nowego linku? Poproś o niego przez POST /common/download-url.

Weryfikacja callbacku

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

Gdy ustawisz callBackUrl, wyślemy ci gotowe zadanie. Zanim mu zaufasz, sprawdź podpis na surowym ciele żądania.

Wysyłanie pliku lokalnego

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.

Publiczne linki https działają bez zmian. Pliki lokalne przechodzą najpierw przez upload-url i commit.

O modelu Vidu Q3 Plus

Vidu Q3: wideo z obrazu, do 16 sekund z dźwiękiem.

Wywołujesz go nazwą modelu vidu/q3-plus/video-extend w POST /jobs/createTask, od 0,3325 USD.

Parametry żądania

ParametrWymaganyOpis
bgmNieAdd a background music bed to the new segment. The source keeps its own sound. Domyślnie: true
duration_secondsNieDługość klipu. Płacisz za każdą sekundę. ≥ 1 · ≤ 16 · Domyślnie: 5
generate_audioNieDodaje dźwięk pasujący do obrazu: głosy, tło i efekty. Domyślnie: true
movement_amplitudeNieJak mocno ruszają się obiekt i kamera. auto · small · medium · large · Domyślnie: auto
promptNieOptional. Describe what happens next: the action that follows, the camera move and the sound.
resolutionNieRozmiar wyniku. Większy jest ostrzejszy i droższy. 540p · 720p · 1080p · Domyślnie: 720p
video_urlTakKlip do obróbki.

Ceny

Ceny podano w USD. API korzysta z oddzielnego salda w dolarach amerykańskich. Kredytów strony nie można używać w API ani zamieniać na saldo API. Nie można też zamieniać salda API na kredyty strony. Po przyjęciu zadania rezerwujemy maksymalną kwotę wyceny na saldzie API. Po zakończeniu naliczamy opłatę za rzeczywiste użycie, nie wyższą niż rezerwacja, i zwalniamy resztę. Jeśli zadanie się nie powiedzie, rezerwacja zostaje zwolniona.

OpcjaUSD za sekundę
resolution 540p0,0665 USD
resolution 720p0,1425 USD
resolution 1080p0,152 USD

Przed uruchomieniem wyślij tę samą treść żądania do POST /jobs/quote, aby zobaczyć szacowaną i maksymalną opłatę w USD. Wycena nie uruchamia zadania ani nie obciąża salda.

Szybki start z API

Wywołaj API Vidu Q3 Plus w trzech krokach

  1. Utwórz klucz API. Zaloguj się do PopNow i utwórz klucz w konsoli API. Klucze zaczynają się od sk-popnow-. Wywołania korzystają z oddzielnego salda w dolarach amerykańskich.
  2. Wyślij żądanie. Wyślij POST /jobs/createTask z model vidu/q3-plus/video-extend i obiektem input zgodnym z tabelą parametrów. Odpowiedź od razu zwraca ID zadania.
  3. Odbierz wynik. Odpytuj GET /jobs/recordInfo po ID zadania albo podaj callBackUrl, a wyślemy tam wynik. Gdy zadanie się powiedzie, pobierz pliki z linków wyjściowych.
# 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": "vidu/q3-plus/video-extend",
  "input": {
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "duration_seconds": 5,
    "resolution": "720p",
    "movement_amplitude": "auto"
  }
}'

# 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"

Podmień prompt i linki na własne. Odniesienie do odpowiedzi, odpytywania i callbacku znajdziesz na karcie API.

Pytania o API Vidu Q3 Plus

Ile kosztuje API Vidu Q3 Plus?

Vidu Q3 Plus kosztuje od 0,3325 USD za klip 5-sekundowy – najtańsze zadanie to „Wydłuż wideo”. Ceny według opcji: 540p 0,0665 USD za sekundę, 720p 0,1425 USD za sekundę, 1080p 0,152 USD za sekundę. API korzysta z oddzielnego salda w dolarach amerykańskich. Kredytów strony nie można używać w API ani zamieniać na saldo API. Nie można też zamieniać salda API na kredyty strony. Po przyjęciu zadania rezerwujemy maksymalną kwotę wyceny na saldzie API. Po zakończeniu naliczamy opłatę za rzeczywiste użycie, nie wyższą niż rezerwacja, i zwalniamy resztę. Jeśli zadanie się nie powiedzie, rezerwacja zostaje zwolniona.

Jakie limity ma API Vidu Q3 Plus · Wydłuż wideo?

Długość klipu: 1–16 s; Rozdzielczości: 540p · 720p · 1080p; Najdłuższy klip wejściowy: 60 s. Żądania poza tymi limitami są odrzucane, zanim cokolwiek zostanie pobrane.

Więcej o Vidu Q3 Plus