# 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": "alibaba/wan-2.7-plus/video-extend",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"duration_seconds": 5,
"resolution": "720p",
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4"
}
}'
# 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": "alibaba/wan-2.7-plus/video-extend",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"duration_seconds": 5,
"resolution": "720p",
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4"
}
}),
});
// 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": "alibaba/wan-2.7-plus/video-extend",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"duration_seconds": 5,
"resolution": "720p",
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4"
}
},
)["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"])
input은 아래 스키마로 만들었기 때문에 그대로 검증을 통과합니다. 프롬프트와 링크만 내 것으로 바꾸세요.
가격
옵션
USD /초
resolution 720p
US$0.1235
resolution 1080p
US$0.19
미국 달러 기준 요금 · 모든 옵션과 가격: GET /models/alibaba/wan-2.7-plus/video-extend
제한
영상 길이
2–15 s
해상도
720p · 1080p
입력 클립 최대 길이
60 s
파라미터
이 필드들은 모든 요청을 검사할 때 쓰는 것과 같은 스키마에서 나옵니다. 목록에 없는 필드는 거부됩니다.
promptstring필수
Describe what happens next: the action that follows, the camera move and the mood.
{
"additionalProperties": false,
"properties": {
"audio_url": {
"contentMediaType": [
"audio/mpeg",
"audio/wav",
"audio/mp4",
"audio/aac",
"audio/ogg",
"audio/opus",
"audio/flac"
],
"type": "string"
},
"duration_seconds": {
"default": 5,
"description": "Length of the new segment in seconds. The source clip is added on top and is not billed.",
"maximum": 15,
"minimum": 2,
"type": "integer"
},
"enable_prompt_expansion": {
"default": true,
"description": "Expand the prompt before generation.",
"type": "boolean"
},
"generate_audio": {
"default": true,
"description": "Generate sound for the new segment. The source keeps its own sound either way. When false, supplied audio is not used.",
"type": "boolean"
},
"negative_prompt": {
"description": "List what must not appear in the new segment.",
"maxLength": 500,
"type": "string"
},
"prompt": {
"description": "Describe what happens next: the action that follows, the camera move and the mood.",
"minLength": 1,
"type": "string"
},
"resolution": {
"default": "720p",
"description": "Sharpness of the new segment. Match your source to avoid a visible step in sharpness at the seam.",
"enum": [
"720p",
"1080p"
],
"type": "string"
},
"seed": {
"description": "Random seed. Keep it fixed only for controlled comparisons, not as a frame-identical guarantee.",
"maximum": 2147483647,
"minimum": 0,
"type": "integer"
},
"video_url": {
"contentMediaType": [
"video/mp4",
"video/webm",
"video/quicktime",
"video/x-m4v"
],
"format": "uri",
"minLength": 1,
"type": "string"
}
},
"required": [
"prompt",
"video_url"
],
"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": "alibaba/wan-2.7-plus/video-extend",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"duration_seconds": 5,
"resolution": "720p",
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4"
}
}'
실행 전에 같은 요청 본문을 POST /jobs/quote로 보내면 예상 요금과 최대 요금을 미국 달러로 확인할 수 있습니다. 견적만으로는 작업이 실행되거나 요금이 청구되지 않습니다.
HTTP 202는 접수 완료를 뜻하며 최대 달러 금액이 정산까지 예약됩니다. 작업이 접수되면 견적의 최대 금액을 API 잔액에서 예약합니다. 완료 후 실제 사용량으로 정산하고 남은 예약 금액을 해제합니다. 청구액은 예약 금액을 넘지 않으며, 작업이 실패하면 예약 금액을 해제합니다.
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을 거칩니다.
Wan 2.7 Plus 소개
내 오디오 트랙에 맞출 수 있는 Wan 2.7 이미지 영상화.
POST /jobs/createTask에서 모델 이름을 alibaba/wan-2.7-plus/video-extend(으)로 지정하면 호출할 수 있습니다. US$0.6175부터.
요청 파라미터
파라미터
필수
설명
audio_url
아니요
사용할 목소리나 음악.
duration_seconds
아니요
클립 길이. 초 단위로 요금이 붙습니다. ≥ 2 · ≤ 15 · 기본값: 5
enable_prompt_expansion
아니요
짧은 프롬프트에 모델이 디테일을 덧붙입니다. 기본값: true
generate_audio
아니요
화면에 맞는 소리(목소리, 주변음, 효과음)를 더합니다. 기본값: true
negative_prompt
아니요
나오지 않았으면 하는 것.
prompt
예
Describe what happens next: the action that follows, the camera move and the mood.
요금은 미국 달러 기준입니다. API는 별도의 미국 달러 잔액을 사용합니다. 웹사이트 크레딧은 API에 사용할 수 없으며, API 잔액과 웹사이트 크레딧 간 전환도 지원하지 않습니다. 작업이 접수되면 견적의 최대 금액을 API 잔액에서 예약합니다. 완료 후 실제 사용량으로 정산하고 남은 예약 금액을 해제합니다. 청구액은 예약 금액을 넘지 않으며, 작업이 실패하면 예약 금액을 해제합니다.
옵션
USD /초
resolution 720p
US$0.1235
resolution 1080p
US$0.19
실행 전에 같은 요청 본문을 POST /jobs/quote로 보내면 예상 요금과 최대 요금을 미국 달러로 확인할 수 있습니다. 견적만으로는 작업이 실행되거나 요금이 청구되지 않습니다.
API 빠른 시작
Wan 2.7 Plus API를 3단계로 호출하기
API 키 만들기. PopNow에 로그인하고 API 콘솔에서 키를 만드세요. 키는 sk-popnow-로 시작하며 API 호출은 별도의 달러 잔액을 사용합니다.
요청 보내기. POST /jobs/createTask에 model은 alibaba/wan-2.7-plus/video-extend, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
결과 받기. 작업 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": "alibaba/wan-2.7-plus/video-extend",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"duration_seconds": 5,
"resolution": "720p",
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4"
}
}'
# 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 탭에 있어요.
Wan 2.7 Plus API 질문
Wan 2.7 Plus API 요금은 얼마인가요?
Wan 2.7 Plus 가격은 가장 저렴한 영상 이어 만들기 기준 US$0.6175 / 5초 영상부터입니다. 옵션별 가격: 720p US$0.1235/초, 1080p US$0.19/초. API는 별도의 미국 달러 잔액을 사용합니다. 웹사이트 크레딧은 API에 사용할 수 없으며, API 잔액과 웹사이트 크레딧 간 전환도 지원하지 않습니다. 작업이 접수되면 견적의 최대 금액을 API 잔액에서 예약합니다. 완료 후 실제 사용량으로 정산하고 남은 예약 금액을 해제합니다. 청구액은 예약 금액을 넘지 않으며, 작업이 실패하면 예약 금액을 해제합니다.
Wan 2.7 Plus · 영상 이어 만들기 API의 제한은 무엇인가요?
영상 길이: 2–15 s; 해상도: 720p · 1080p; 입력 클립 최대 길이: 60 s. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.