API · API do VEED Dubbing Pro

da VEED

Dublagem de nível de estúdio com sotaques, correspondência de voz e sincronia labial

veed/dubbing-pro/video-translate

Tradutor de vídeo

Chame com o nome de modelo veed/dubbing-pro/video-translate em POST /jobs/createTask, a partir de US$ 0,24.

Nome do modeloveed/dubbing-pro/video-translate

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": "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"])

O input é montado a partir do schema abaixo, então passa na validação como está. Troque o prompt e os links pelos seus.

Preço

Opção	USD por segundo
Padrão	US$ 0,24

Cobrança em USD · Todas as opções e preços: GET /models/veed/dubbing-pro/video-translate

Parâmetros

Estes campos vêm do mesmo schema que usamos para validar cada requisição. Campos que não estão na lista são rejeitados.

video_urlstringObrigatório
O clipe a ser trabalhado.
Faixa
Número de caracteres: 1 – … · video/mp4, video/webm, video/quicktime, video/x-m4v
target_languagestringObrigatório
O idioma da dublagem. Precisa ser diferente do idioma do clipe.
Valores aceitos
"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_languagestringOpcional
O idioma falado no clipe. Detectado automaticamente; escolha quando houver música, sotaque forte ou pausas longas.
Padrão
"auto"
Valores aceitos
"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_strengthintegerOpcional
O quanto a dublagem se parece com cada voz original, de 0 a 10. Mais alto mantém voz e sotaque; mais baixo soa mais nativo.
Padrão
7
Faixa
0 – 10
keytermsarray<object>Opcional
Nomes e termos que ajudam o modelo a usar a grafia desejada na transcrição.
Faixa
Número de itens: 0 – 10
Campos internos
- keyterms[].termstringObrigatório
  Uma palavra ou expressão curta para ajudar na transcrição.
  Faixa
  Número de caracteres: 1 – 50

JSON Schema original

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

Respostas, consultas e callbacks

Todos os modelos funcionam do mesmo jeito: crie uma tarefa e depois consulte ou espere o callback.

Veja o preço antes

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

Antes de executar, envie o mesmo corpo de requisição para POST /jobs/quote para ver o custo estimado e o máximo em USD. A cotação não executa tarefas nem debita seu saldo.

Aceita

HTTP

HTTP/1.1 202 Accepted

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

HTTP 202 significa que a tarefa foi aceita: o máximo em USD fica reservado até o acerto final. Ao aceitar uma tarefa, reservamos o valor máximo da cotação no seu saldo de API. Ao concluir, cobramos o uso real sem ultrapassar a reserva e liberamos o restante. Se a tarefa falhar, o valor reservado é liberado.

Consultar status

cURL

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

Consulte a cada poucos segundos, espaçando cada vez mais, e pare quando state for succeeded, failed, canceled ou expired.

Tarefa pronta

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

Baixe pela url antes de expiresAt. Precisa de um link novo depois? Peça com POST /common/download-url.

Verificar um callback

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

Com callBackUrl definida, enviamos a tarefa pronta para você. Confira a assinatura no corpo bruto antes de confiar nela.

Enviar um arquivo local

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.

Links https públicos funcionam como estão. Arquivos locais passam antes por upload-url e commit.