P-Video 2 Pro API

Pruna AI

텍스트, 프레임, 레퍼런스 클립으로 만드는 소리 있는 5~15초 영상

pruna-ai/p-video-2-pro/reference-to-video
  • 최대 768p
  • 5–15초
  • 시작·끝 프레임
  • 화면비 7종
  • 동영상 만들기
  • 이미지로 영상 만들기
  • 레퍼런스로 영상 만들기

POST /jobs/createTask에서 모델 이름을 pruna-ai/p-video-2-pro/reference-to-video(으)로 지정하면 호출할 수 있습니다. US$0.09부터.

모델 이름pruna-ai/p-video-2-pro/reference-to-video
엔드포인트POST 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"

input은 아래 스키마로 만들었기 때문에 그대로 검증을 통과합니다. 프롬프트와 링크만 내 것으로 바꾸세요.

가격

옵션USD /초
generation_mode costresolution 480pUS$0.018
generation_mode speedresolution 480pUS$0.024
generation_mode costresolution 768pUS$0.03
generation_mode speedresolution 768pUS$0.042

미국 달러 기준 요금 · 모든 옵션과 가격: GET /models/pruna-ai/p-video-2-pro/reference-to-video

제한

영상 길이
5–15 s
해상도
480p · 768p
화면 비율
auto · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +2
참조 오디오
3
참조 영상
3

파라미터

이 필드들은 모든 요청을 검사할 때 쓰는 것과 같은 스키마에서 나옵니다. 목록에 없는 필드는 거부됩니다.

  • promptstring필수

    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.

    범위
    1 – … chars
  • image_urlstring선택가격이 달라짐

    출발점이 되는 이미지.

    범위
    image/jpeg, image/png, image/webp, image/gif
  • last_image_urlstring선택가격이 달라짐

    선택 사항인 마지막 프레임. 원하는 장면에서 클립을 끝냅니다.

    범위
    image/jpeg, image/png, image/webp, image/gif
  • reference_video_urlsarray<string>선택가격이 달라짐

    움직임, 카메라, 스타일을 따라 할 참조 영상.

    범위
    1 – 3 items · video/mp4, video/webm, video/quicktime, video/x-m4v
  • reference_audio_urlsarray<string>선택가격이 달라짐

    맞출 소리: 목소리, 음악, 리듬.

    범위
    1 – 3 items · audio/mpeg, audio/wav, audio/mp4, audio/aac +3
  • aspect_ratiostring선택

    화면 모양: 가로, 정사각형, 세로.

    기본값
    "auto"
    허용 값
    "auto""16:9""9:16""4:3""3:4""3:2""2:3""1:1"
  • resolutionstring선택가격이 달라짐

    출력 크기. 클수록 선명하고 가격도 올라갑니다.

    기본값
    "768p"
    허용 값
    "480p""768p"
  • generation_modestring선택가격이 달라짐

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

    기본값
    "speed"
    허용 값
    "cost""speed"
  • keep_reference_audioboolean선택

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

    기본값
    false
  • duration_secondsinteger선택가격이 달라짐

    클립 길이. 초 단위로 요금이 붙습니다.

    기본값
    5
    범위
    5 – 15
  • prompt_optimization_modestring선택

    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.

    기본값
    "off"
    허용 값
    "off""turbo""max"
  • seedinteger선택

    같은 숫자를 쓰면 같은 결과를 다시 얻을 수 있습니다.

    범위
    0 – 2147483647
원본 JSON 스키마
{
  "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"
}

응답, 폴링, 콜백

모든 모델은 같은 방식으로 동작합니다. 작업을 만들고, 폴링하거나 콜백을 기다리세요.

먼저 견적 받기

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
  }
}'

실행 전에 같은 요청 본문을 POST /jobs/quote로 보내면 예상 요금과 최대 요금을 미국 달러로 확인할 수 있습니다. 견적만으로는 작업이 실행되거나 요금이 청구되지 않습니다.

접수됨

HTTP
HTTP/1.1 202 Accepted

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

HTTP 202는 접수 완료를 뜻하며 최대 달러 금액이 정산까지 예약됩니다. 작업이 접수되면 견적의 최대 금액을 API 잔액에서 예약합니다. 완료 후 실제 사용량으로 정산하고 남은 예약 금액을 해제합니다. 청구액은 예약 금액을 넘지 않으며, 작업이 실패하면 예약 금액을 해제합니다.

상태 확인

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

간격을 조금씩 늘리며 몇 초마다 확인하고, state가 succeeded, failed, canceled, expired 중 하나가 되면 멈추세요.

완료된 작업

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

expiresAt 전에 url에서 내려받으세요. 나중에 새 링크가 필요하면 POST /common/download-url을 호출하세요.

콜백 검증하기

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

callBackUrl을 설정하면 완료된 작업을 보내 드립니다. 믿기 전에 원본 요청 본문으로 서명을 확인하세요.

로컬 파일 보내기

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.

공개 https 링크는 그대로 쓸 수 있습니다. 로컬 파일은 먼저 upload-url과 commit을 거칩니다.

P-Video 2 Pro 소개

텍스트, 프레임, 레퍼런스 클립으로 만드는 소리 있는 5~15초 영상.

POST /jobs/createTask에서 모델 이름을 pruna-ai/p-video-2-pro/reference-to-video(으)로 지정하면 호출할 수 있습니다. US$0.09부터.

요청 파라미터

파라미터필수설명
aspect_ratio아니요화면 모양: 가로, 정사각형, 세로. auto · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 1:1 · 기본값: auto
duration_seconds아니요클립 길이. 초 단위로 요금이 붙습니다. ≥ 5 · ≤ 15 · 기본값: 5
generation_mode아니요cost is cheaper and slower, speed (the default) is faster at the same quality. cost · speed · 기본값: speed
image_url아니요출발점이 되는 이미지.
keep_reference_audio아니요Use the reference audio as the soundtrack instead of generating new sound. Needs exactly one audio clip. 기본값: false
last_image_url아니요선택 사항인 마지막 프레임. 원하는 장면에서 클립을 끝냅니다.
prompt예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_mode아니요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. off · turbo · max · 기본값: off
reference_audio_urls아니요맞출 소리: 목소리, 음악, 리듬.
reference_video_urls아니요움직임, 카메라, 스타일을 따라 할 참조 영상.
resolution아니요출력 크기. 클수록 선명하고 가격도 올라갑니다. 480p · 768p · 기본값: 768p
seed아니요같은 숫자를 쓰면 같은 결과를 다시 얻을 수 있습니다. ≥ 0 · ≤ 2147483647

가격

요금은 미국 달러 기준입니다. API는 별도의 미국 달러 잔액을 사용합니다. 웹사이트 크레딧은 API에 사용할 수 없으며, API 잔액과 웹사이트 크레딧 간 전환도 지원하지 않습니다. 작업이 접수되면 견적의 최대 금액을 API 잔액에서 예약합니다. 완료 후 실제 사용량으로 정산하고 남은 예약 금액을 해제합니다. 청구액은 예약 금액을 넘지 않으며, 작업이 실패하면 예약 금액을 해제합니다.

옵션USD /초
generation_mode cost · resolution 480pUS$0.018
generation_mode speed · resolution 480pUS$0.024
generation_mode cost · resolution 768pUS$0.03
generation_mode speed · resolution 768pUS$0.042

실행 전에 같은 요청 본문을 POST /jobs/quote로 보내면 예상 요금과 최대 요금을 미국 달러로 확인할 수 있습니다. 견적만으로는 작업이 실행되거나 요금이 청구되지 않습니다.

API 빠른 시작

P-Video 2 Pro API를 3단계로 호출하기

  1. API 키 만들기. PopNow에 로그인하고 API 콘솔에서 키를 만드세요. 키는 sk-popnow-로 시작하며 API 호출은 별도의 달러 잔액을 사용합니다.
  2. 요청 보내기. POST /jobs/createTask에 model은 pruna-ai/p-video-2-pro/reference-to-video, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
  3. 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 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"

프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.

P-Video 2 Pro API 질문

P-Video 2 Pro API 요금은 얼마인가요?

P-Video 2 Pro 가격은 가장 저렴한 레퍼런스로 영상 만들기 기준 US$0.09 / 5초 영상부터입니다. 옵션별 가격: cost · 480p US$0.018/초, speed · 480p US$0.024/초, cost · 768p US$0.03/초, speed · 768p US$0.042/초. API는 별도의 미국 달러 잔액을 사용합니다. 웹사이트 크레딧은 API에 사용할 수 없으며, API 잔액과 웹사이트 크레딧 간 전환도 지원하지 않습니다. 작업이 접수되면 견적의 최대 금액을 API 잔액에서 예약합니다. 완료 후 실제 사용량으로 정산하고 남은 예약 금액을 해제합니다. 청구액은 예약 금액을 넘지 않으며, 작업이 실패하면 예약 금액을 해제합니다.

P-Video 2 Pro · 레퍼런스로 영상 만들기 API의 제한은 무엇인가요?

영상 길이: 5–15 s; 해상도: 480p · 768p; 화면 비율: auto · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +2; 참조 오디오: 3; 참조 영상: 3. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.

P-Video 2 Pro 더 알아보기