API · VEED Dubbing Pro API：价格、参数与代码

VEED 出品

专业级配音：口音、音色匹配与对口型

veed/dubbing-pro/video-translate

视频翻译

在 POST /jobs/createTask 里把模型名写成 veed/dubbing-pro/video-translate 即可调用，US$0.24 起。

调用名veed/dubbing-pro/video-translate

接口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": "veed/dubbing-pro/video-translate",
  "input": {
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "target_language": "af",
    "source_language": "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"

// 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": "veed/dubbing-pro/video-translate",
    "input": {
      "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
      "target_language": "af",
      "source_language": "auto"
    }
  }),
});

// 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": "veed/dubbing-pro/video-translate",
        "input": {
            "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
            "target_language": "af",
            "source_language": "auto"
        }
    },
)["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 按下面的 Schema 生成，原样就能通过校验。把提示词和链接换成你自己的即可。

价格

选项	USD /秒
标准	US$0.24

美元计费 · 全部选项及价格：GET /models/veed/dubbing-pro/video-translate

参数

这些字段与请求校验使用同一份 Schema。未列出的字段无法通过校验。

video_urlstring必填
要处理的视频。
范围
字符数: 1 – … · video/mp4, video/webm, video/quicktime, video/x-m4v
target_languagestring必填
要配成的语言，必须和视频里的语言不同。
可选值
"af""ak""am""ar""ar-EG""as""az""be""bg""bo""bs""ca""ceb""cmn""cs""cy""da""de""dgo""el""en""en-AU""en-CA""en-GB""en-US""es""es-AR""es-CL""es-ES""es-MX""et""eu""fa""fi""fil""fr""fr-CA""fr-FR""gl""gu"+68
source_languagestring可选
视频里说的语言。自动识别；有背景音乐、口音重或停顿长时手动选。
默认值
"auto"
可选值
"auto""af""ak""am""ar""as""az""be""bg""bo""bs""ca""ceb""cmn""cs""cy""da""de""dgo""el""en""es""et""eu""fa""fi""fil""fr""gl""gu""ha""he""hi""hr""hu""hy""id""is""it""ja"+55
voice_clone_strengthinteger可选
配音和原声的相似程度，0 到 10。越高越保留原声与口音，越低越像母语。
默认值
7
范围
0 – 10
keytermsarray<object>可选
填写姓名或术语，帮助模型在转写时采用你指定的拼写。
范围
条目数: 0 – 10
嵌套字段
- keyterms[].termstring必填
  用于辅助转写的词语或短语。
  范围
  字符数: 1 – 50

原始 JSON Schema

{
  "additionalProperties": false,
  "properties": {
    "keyterms": {
      "description": "Names and terms the speech recognition should catch exactly as written, up to 10.",
      "items": {
        "additionalProperties": false,
        "properties": {
          "term": {
            "description": "A name or short phrase: up to 50 characters and 5 words, without < > { } [ ] or backslashes.",
            "maxLength": 50,
            "minLength": 1,
            "pattern": "^[^<>{}\\[\\]\\\\]+$",
            "type": "string"
          }
        },
        "required": [
          "term"
        ],
        "type": "object"
      },
      "maxItems": 10,
      "type": "array"
    },
    "source_language": {
      "default": "auto",
      "description": "Language spoken in the clip. auto detects it; set it if detection picks the wrong language.",
      "enum": [
        "auto",
        "af",
        "ak",
        "am",
        "ar",
        "as",
        "az",
        "be",
        "bg",
        "bo",
        "bs",
        "ca",
        "ceb",
        "cmn",
        "cs",
        "cy",
        "da",
        "de",
        "dgo",
        "el",
        "en",
        "es",
        "et",
        "eu",
        "fa",
        "fi",
        "fil",
        "fr",
        "gl",
        "gu",
        "ha",
        "he",
        "hi",
        "hr",
        "hu",
        "hy",
        "id",
        "is",
        "it",
        "ja",
        "jv",
        "ka",
        "ki",
        "kk",
        "kn",
        "ko",
        "ky",
        "lg",
        "lt",
        "lv",
        "mk",
        "ml",
        "mn",
        "mr",
        "ms",
        "my",
        "ne",
        "nl",
        "no",
        "nso",
        "pa",
        "pl",
        "pt",
        "rn",
        "ro",
        "ru",
        "rw",
        "sd",
        "sk",
        "sl",
        "sq",
        "ss",
        "st",
        "su",
        "sv",
        "sw",
        "ta",
        "te",
        "tg",
        "th",
        "tn",
        "tr",
        "ts",
        "ug",
        "uk",
        "ur",
        "uz",
        "ve",
        "vi",
        "war",
        "wo",
        "yo",
        "yue",
        "zh",
        "zu"
      ],
      "type": "string"
    },
    "target_language": {
      "description": "Language to dub into. Regional variants such as es-MX or pt-BR pick the accent.",
      "enum": [
        "af",
        "ak",
        "am",
        "ar",
        "ar-EG",
        "as",
        "az",
        "be",
        "bg",
        "bo",
        "bs",
        "ca",
        "ceb",
        "cmn",
        "cs",
        "cy",
        "da",
        "de",
        "dgo",
        "el",
        "en",
        "en-AU",
        "en-CA",
        "en-GB",
        "en-US",
        "es",
        "es-AR",
        "es-CL",
        "es-ES",
        "es-MX",
        "et",
        "eu",
        "fa",
        "fi",
        "fil",
        "fr",
        "fr-CA",
        "fr-FR",
        "gl",
        "gu",
        "ha",
        "he",
        "hi",
        "hr",
        "hu",
        "hy",
        "id",
        "is",
        "it",
        "ja",
        "jv",
        "ka",
        "ki",
        "kk",
        "kn",
        "ko",
        "ky",
        "lg",
        "lt",
        "lv",
        "mk",
        "ml",
        "mn",
        "mr",
        "ms",
        "my",
        "ne",
        "nl",
        "no",
        "nso",
        "pa",
        "pl",
        "pt",
        "pt-BR",
        "pt-PT",
        "rn",
        "ro",
        "ru",
        "rw",
        "sd",
        "sk",
        "sl",
        "sq",
        "ss",
        "st",
        "su",
        "sv",
        "sw",
        "ta",
        "te",
        "tg",
        "th",
        "tn",
        "tr",
        "ts",
        "ug",
        "uk",
        "ur",
        "uz",
        "ve",
        "vi",
        "war",
        "wo",
        "yo",
        "yue",
        "zh",
        "zh-TW",
        "zu"
      ],
      "type": "string"
    },
    "video_url": {
      "contentMediaType": [
        "video/mp4",
        "video/webm",
        "video/quicktime",
        "video/x-m4v"
      ],
      "minLength": 1,
      "type": "string"
    },
    "voice_clone_strength": {
      "default": 7,
      "description": "How closely the dubbed voices follow the original speakers, 0 to 10. Higher keeps more of each voice and accent; lower sounds more native in the target language.",
      "maximum": 10,
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "video_url",
    "target_language"
  ],
  "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": "veed/dubbing-pro/video-translate",
  "input": {
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "target_language": "af",
    "source_language": "auto"
  }
}'

运行前，将相同请求体发送到 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": "veed/dubbing-pro/video-translate",
    "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。