API | API VEED Dubbing — Dubbing z synchronizacją ust w 86 językach

veed/dubbing/video-translate

VEED Dubbing tłumaczy mowę w filmie na jeden z 86 języków, odtwarza ją sklonowanym głosem każdej osoby i przerysowuje usta, aby pasowały do nowych kwestii. Opłata za sekundę filmu źródłowego.

Od $0.144/s

Uruchom model Zobacz API

Wyślij żądanie

Przykłady korzystają z publicznych definicji parametrów wybranego endpointu. Podmień klucz API i przykładowe media, a potem wyślij żądanie ze swojego serwera.

SDK i integracje

POSThttps://api.spicyapi.ai/api/v1/jobs/createTask

Uwierzytelnianie API

Klucz API trzymaj w zmiennej środowiskowej serwera SPICY_API_KEY. Dla żądań JSON używaj uwierzytelniania Bearer i Content-Type: application/json.

Authorization: Bearer $SPICY_API_KEY

Przykładowy wynik

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "veed/dubbing/video-translate",
  "input": {
    "source_language": "auto",
    "target_language": "af",
    "video_url": "https://example.com/reference.mp4"
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Wygenerowane ze schematu wejścia tego modelu – tego samego, względem którego API waliduje każde żądanie.

Parametry wejściowe

Te pola umieść w obiekcie input w ciele żądania. Nazwy i typy odpowiadają API. Gdy wartości domyślnej nie podano, nie zakładaj żadnej.

target_languagestringWymagane

Wymagane. Jeden z 86 podstawowych języków dubbingu. Ten wariant nie przyjmuje kodów regionalnych. Nie zmienia ceny.

Domyślnie: Nie określono
Dozwolone wartości: "af""ar""as""ast""az""be""bg""bn""bs""ca""ceb""cs""cy""da""de""el""en""es""et""fa""fi""fil""fr""ga""gl""gu""ha""he""hi""hr""hu""hy""id""is""it""ja""jv""ka""kk""kn""ko""ky""lb""ln""lt""lv""mi""mk""ml""mn""mr""ms""mt""my""ne""nl""no""ny""oc""or""pa""pl""ps""pt""ro""ru""sd""sk""sl""so""sr""sv""sw""ta""te""tg""th""tl""tr""uk""ur""uz""vi""yo""yue""zh"

video_urlstringWymagane

Film do dubbingu, do 10 minut, z mową w ścieżce dźwiękowej. Prześlij go lub podaj bezpośredni link do pliku wideo; nieczytelny link zostanie odrzucony przy wysyłaniu bez opłat. Długość określa cenę, za sekundę z zaokrągleniem w górę.

Domyślnie: Nie określono
Ograniczenia: minLength:1
contentMediaType:["video/mp4","video/webm","video/quicktime"]

keytermsarray<object>Opcjonalne

Do 10 nazw lub krótkich fraz do zapisania dokładnie w podanej postaci, każda do 50 znaków i 5 słów, bez < > { } [ ] ani ukośników odwrotnych. Ukierunkowują transkrypcję; nie są parami tłumaczeń. Nie zmieniają ceny.

Domyślnie: Nie określono
Ograniczenia: maxItems:10

source_languagestringOpcjonalne

Język mówiony w filmie. Domyślnie auto, czyli automatyczne wykrywanie. Ustaw tylko wtedy, gdy wykrywanie wybiera niewłaściwy język. Nie zmienia ceny.

Domyślnie: "auto"
Dozwolone wartości: "auto""af""ar""as""ast""az""be""bg""bn""bs""ca""ceb""cs""cy""da""de""el""en""es""et""fa""fi""fil""fr""ga""gl""gu""ha""he""hi""hr""hu""hy""id""is""it""ja""jv""ka""kk""kn""ko""ky""lb""ln""lt""lv""mi""mk""ml""mn""mr""ms""mt""my""ne""nl""no""ny""oc""or""pa""pl""ps""pt""ro""ru""sd""sk""sl""so""sr""sv""sw""ta""te""tg""th""tl""tr""uk""ur""uz""vi""yo""yue""zh"

{
  "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",
      "x-ui": {
        "order": 70,
        "widget": "object-list"
      }
    },
    "source_language": {
      "default": "auto",
      "description": "Language spoken in the clip. auto detects it; set it if detection picks the wrong language.",
      "enum": [
        "auto",
        "af",
        "ar",
        "as",
        "ast",
        "az",
        "be",
        "bg",
        "bn",
        "bs",
        "ca",
        "ceb",
        "cs",
        "cy",
        "da",
        "de",
        "el",
        "en",
        "es",
        "et",
        "fa",
        "fi",
        "fil",
        "fr",
        "ga",
        "gl",
        "gu",
        "ha",
        "he",
        "hi",
        "hr",
        "hu",
        "hy",
        "id",
        "is",
        "it",
        "ja",
        "jv",
        "ka",
        "kk",
        "kn",
        "ko",
        "ky",
        "lb",
        "ln",
        "lt",
        "lv",
        "mi",
        "mk",
        "ml",
        "mn",
        "mr",
        "ms",
        "mt",
        "my",
        "ne",
        "nl",
        "no",
        "ny",
        "oc",
        "or",
        "pa",
        "pl",
        "ps",
        "pt",
        "ro",
        "ru",
        "sd",
        "sk",
        "sl",
        "so",
        "sr",
        "sv",
        "sw",
        "ta",
        "te",
        "tg",
        "th",
        "tl",
        "tr",
        "uk",
        "ur",
        "uz",
        "vi",
        "yo",
        "yue",
        "zh"
      ],
      "type": "string",
      "x-ui": {
        "enum_labels": {
          "af": "Afrikaans",
          "ar": "Arabic",
          "as": "Assamese",
          "ast": "Asturian",
          "auto": "Detect automatically",
          "az": "Azerbaijani",
          "be": "Belarusian",
          "bg": "Bulgarian",
          "bn": "Bengali",
          "bs": "Bosnian",
          "ca": "Catalan",
          "ceb": "Cebuano",
          "cs": "Czech",
          "cy": "Welsh",
          "da": "Danish",
          "de": "German",
          "el": "Greek",
          "en": "English",
          "es": "Spanish",
          "et": "Estonian",
          "fa": "Persian",
          "fi": "Finnish",
          "fil": "Filipino",
          "fr": "French",
          "ga": "Irish",
          "gl": "Galician",
          "gu": "Gujarati",
          "ha": "Hausa",
          "he": "Hebrew",
          "hi": "Hindi",
          "hr": "Croatian",
          "hu": "Hungarian",
          "hy": "Armenian",
          "id": "Indonesian",
          "is": "Icelandic",
          "it": "Italian",
          "ja": "Japanese",
          "jv": "Javanese",
          "ka": "Georgian",
          "kk": "Kazakh",
          "kn": "Kannada",
          "ko": "Korean",
          "ky": "Kyrgyz",
          "lb": "Luxembourgish",
          "ln": "Lingala",
          "lt": "Lithuanian",
          "lv": "Latvian",
          "mi": "Maori",
          "mk": "Macedonian",
          "ml": "Malayalam",
          "mn": "Mongolian",
          "mr": "Marathi",
          "ms": "Malay",
          "mt": "Maltese",
          "my": "Burmese",
          "ne": "Nepali",
          "nl": "Dutch",
          "no": "Norwegian",
          "ny": "Chichewa",
          "oc": "Occitan",
          "or": "Odia",
          "pa": "Punjabi",
          "pl": "Polish",
          "ps": "Pashto",
          "pt": "Portuguese",
          "ro": "Romanian",
          "ru": "Russian",
          "sd": "Sindhi",
          "sk": "Slovak",
          "sl": "Slovenian",
          "so": "Somali",
          "sr": "Serbian",
          "sv": "Swedish",
          "sw": "Swahili",
          "ta": "Tamil",
          "te": "Telugu",
          "tg": "Tajik",
          "th": "Thai",
          "tl": "Tagalog",
          "tr": "Turkish",
          "uk": "Ukrainian",
          "ur": "Urdu",
          "uz": "Uzbek",
          "vi": "Vietnamese",
          "yo": "Yoruba",
          "yue": "Cantonese",
          "zh": "Chinese"
        },
        "order": 80,
        "widget": "select"
      }
    },
    "target_language": {
      "description": "Language to dub into. Base languages only, no regional accents.",
      "enum": [
        "af",
        "ar",
        "as",
        "ast",
        "az",
        "be",
        "bg",
        "bn",
        "bs",
        "ca",
        "ceb",
        "cs",
        "cy",
        "da",
        "de",
        "el",
        "en",
        "es",
        "et",
        "fa",
        "fi",
        "fil",
        "fr",
        "ga",
        "gl",
        "gu",
        "ha",
        "he",
        "hi",
        "hr",
        "hu",
        "hy",
        "id",
        "is",
        "it",
        "ja",
        "jv",
        "ka",
        "kk",
        "kn",
        "ko",
        "ky",
        "lb",
        "ln",
        "lt",
        "lv",
        "mi",
        "mk",
        "ml",
        "mn",
        "mr",
        "ms",
        "mt",
        "my",
        "ne",
        "nl",
        "no",
        "ny",
        "oc",
        "or",
        "pa",
        "pl",
        "ps",
        "pt",
        "ro",
        "ru",
        "sd",
        "sk",
        "sl",
        "so",
        "sr",
        "sv",
        "sw",
        "ta",
        "te",
        "tg",
        "th",
        "tl",
        "tr",
        "uk",
        "ur",
        "uz",
        "vi",
        "yo",
        "yue",
        "zh"
      ],
      "type": "string",
      "x-ui": {
        "enum_labels": {
          "af": "Afrikaans",
          "ar": "Arabic",
          "as": "Assamese",
          "ast": "Asturian",
          "az": "Azerbaijani",
          "be": "Belarusian",
          "bg": "Bulgarian",
          "bn": "Bengali",
          "bs": "Bosnian",
          "ca": "Catalan",
          "ceb": "Cebuano",
          "cs": "Czech",
          "cy": "Welsh",
          "da": "Danish",
          "de": "German",
          "el": "Greek",
          "en": "English",
          "es": "Spanish",
          "et": "Estonian",
          "fa": "Persian",
          "fi": "Finnish",
          "fil": "Filipino",
          "fr": "French",
          "ga": "Irish",
          "gl": "Galician",
          "gu": "Gujarati",
          "ha": "Hausa",
          "he": "Hebrew",
          "hi": "Hindi",
          "hr": "Croatian",
          "hu": "Hungarian",
          "hy": "Armenian",
          "id": "Indonesian",
          "is": "Icelandic",
          "it": "Italian",
          "ja": "Japanese",
          "jv": "Javanese",
          "ka": "Georgian",
          "kk": "Kazakh",
          "kn": "Kannada",
          "ko": "Korean",
          "ky": "Kyrgyz",
          "lb": "Luxembourgish",
          "ln": "Lingala",
          "lt": "Lithuanian",
          "lv": "Latvian",
          "mi": "Maori",
          "mk": "Macedonian",
          "ml": "Malayalam",
          "mn": "Mongolian",
          "mr": "Marathi",
          "ms": "Malay",
          "mt": "Maltese",
          "my": "Burmese",
          "ne": "Nepali",
          "nl": "Dutch",
          "no": "Norwegian",
          "ny": "Chichewa",
          "oc": "Occitan",
          "or": "Odia",
          "pa": "Punjabi",
          "pl": "Polish",
          "ps": "Pashto",
          "pt": "Portuguese",
          "ro": "Romanian",
          "ru": "Russian",
          "sd": "Sindhi",
          "sk": "Slovak",
          "sl": "Slovenian",
          "so": "Somali",
          "sr": "Serbian",
          "sv": "Swedish",
          "sw": "Swahili",
          "ta": "Tamil",
          "te": "Telugu",
          "tg": "Tajik",
          "th": "Thai",
          "tl": "Tagalog",
          "tr": "Turkish",
          "uk": "Ukrainian",
          "ur": "Urdu",
          "uz": "Uzbek",
          "vi": "Vietnamese",
          "yo": "Yoruba",
          "yue": "Cantonese",
          "zh": "Chinese"
        },
        "order": 90,
        "widget": "select"
      }
    },
    "video_url": {
      "contentMediaType": [
        "video/mp4",
        "video/webm",
        "video/quicktime"
      ],
      "description": "Talking clip to dub, up to 10 minutes, with audible speech. Billed per second of this clip, rounded up.",
      "minLength": 1,
      "type": "string",
      "x-ui": {
        "accept": [
          "video/mp4",
          "video/webm"
        ],
        "order": 100,
        "primary": true,
        "widget": "upload"
      }
    }
  },
  "required": [
    "video_url",
    "target_language"
  ],
  "type": "object",
  "x-pricing": {
    "billingMode": "duration_capped",
    "variantFields": []
  }
}

Śledź zadanie

HTTP 202 oznacza, że zadanie zostało przyjęte, a nie ukończone. Zapisz zwrócone taskId i odpytuj właśnie to zadanie. Nie twórz kolejnego zadania, czekając na jego wynik.

Odpowiedź o przyjęciu

HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3

{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_create",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued",
    "estimatedCost": "0.750000"
  }
}

Odpowiedź o przyjęciu zawiera szacunek, dzięki czemu twoja aplikacja pokaże tę samą kwotę w historii zadań i w rozliczeniach.

Odczytaj zadanie

curl --get "https://api.spicyapi.ai/api/v1/jobs/recordInfo" \
  --data-urlencode "taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Zacznij odpytywać mniej więcej co 2 sekundy i stopniowo wydłużaj odstęp. Zatrzymaj się na stanie końcowym. Po zerwaniu połączenia odpytaj pierwotne taskId. Tworzenie ponawiaj wyłącznie z pierwotnym kluczem idempotentności i pierwotnym ciałem żądania.

Albo odbierz wynik przez callback

import { verifyWebhook } from "@spicyapi/sdk";

// express.raw keeps the bytes we signed; express.json never matches.
app.post("/hooks/spicy", express.raw({ type: "application/json" }), (req, res) => {
  const { payload } = verifyWebhook({
    rawBody: req.body,
    timestamp: req.header("X-Webhook-Timestamp"),
    signature: req.header("X-Webhook-Signature"),
    payloadVersion: Number(req.header("X-Webhook-Payload-Version")),
    secret: process.env.SPICY_WEBHOOK_SECRET,
  });
  res.status(200).end();
  void handleFinishedTask(payload);
});

Podaj callBackUrl przy tworzeniu zadania, a gotowy rekord przyjdzie do ciebie metodą POST – bez żadnej pętli odpytywania. Każda dostawa niesie X-Webhook-Timestamp, X-Webhook-Signature i X-Webhook-Payload-Version. Podpis to HMAC-SHA256 w base64 z taskId.timestamp.sha256(body), więc trzeba go sprawdzać na surowych bajtach: sparsowanie JSON-a i ponowne zserializowanie zmienia je i weryfikacja się nie powiedzie. Nieudane dostawy są ponawiane, więc to samo taskId może przyjść dwa razy – zrób obsługę idempotentną. Najpierw odpowiedz kodem 2xx, a pracę wykonaj potem; wolna obsługa jest traktowana jak nieudana dostawa.

Odczytaj wynik

Wynik wykorzystuj dopiero przy stanie succeeded. Przy niepowodzeniu skorzystaj z errorCode, errorMessage i request_id. Przykładowe koszty i stany nie odpowiadają rzeczywistemu rozliczeniu.

Przykład odpowiedzi po zakończeniu

{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_record",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "veed/dubbing/video-translate",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "key": "tasks/2026/08/28/job_01k3m8x9q2z4v7n5p6r8s0t1w3/3f7a1c9e5b2d48f0a6c1e3d5b7f9a1c3.mp4",
          "mime": "video/mp4",
          "url": "https://example.r2.cloudflarestorage.com/results/job_01k3m8x9q2z4v7n5p6r8s0t1w3/result.mp4?X-Amz-Signature=SIGNATURE_FROM_RESPONSE",
          "expiresAt": "2026-08-28T12:20:08.000Z"
        }
      ]
    },
    "cost": "0.750000",
    "settled": true,
    "createdAt": "2026-08-28T12:00:00Z",
    "completedAt": "2026-08-28T12:00:30Z"
  }
}

Każdy dostępny materiał otwieraj lub pobieraj bezpośrednio spod assets[].url, bez nagłówka Authorization. Podpisany adres wygasa o expiresAt; odpytaj zadanie ponownie, żeby go odświeżyć, dopóki materiał mieści się w okresie przechowywania. Materiał oczekujący lub niedostępny nie ma adresu. Podpisane adresy traktuj jako prywatne.

SDK i integracje

Korzystaj ze SpicyAPI w aplikacji, terminalu, asystencie AI lub wizualnym przepływie pracy. Wybierz instrukcję konfiguracji.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Polecenia terminala i skrypty automatyzacji.

MCP

Claude Code · Cursor · Codex

Agent Skill

Instrukcje wielokrotnego użytku dla asystenta AI.

n8n

Węzły społecznościowe dla instalacji self-hosted i szablony HTTP Request do importu w n8n Cloud.

ComfyUI

Przepływy obrazów, wideo i dźwięku na płótnie węzłów.

Więcej integracji

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

Przeglądaj gotowe przepływy pracy

Nie musisz pisać żadnego z powyższych fragmentów kodu. Wystarczy raz podłączyć serwer MCP, a każdy agent obsługujący MCP — Claude Code, Codex, Cursor, Windsurf, VS Code, Gemini CLI, Cline, LibreChat — może uruchomić ten model po nazwie. Można go też wywołać z powłoki jednym poleceniem.

Powiedz to swojemu agentowi

Użyj veed/dubbing/video-translate, żeby zrobić pięciosekundowe ujęcie dachu w neonach o zmierzchu, z powolnym najazdem, i zapisz je do ./out/.

Agent znajduje model w aktualnym katalogu, sam wysyła plik lokalny, a potem pokazuje dokładną wycenę wraz z maksymalną opłatą i czeka na twoje potwierdzenie. Nic nie zostaje naliczone, dopóki nie zgodzisz się wprost.

Podłącz raz

claude mcp add spicyapi -e SPICY_API_KEY=$SPICY_API_KEY \
  -- npx --yes --package=@spicyapi/mcp spicyapi-mcp
npx skills add spicyapi-ai/spicy-skill

Pierwsza linia daje agentowi narzędzia; druga daje mu Skill, czyli reguły ich używania: najpierw wycena, potem opłata, wysyłanie plików lokalnych zamiast wklejania bajtów i odczyt gotowego adresu materiału zamiast zgadywania. Każdy inny klient podłącza ten sam serwer przez własny plik konfiguracyjny – zobacz centrum dla deweloperów.

Albo jedno polecenie w powłoce

npx @spicyapi/cli tasks create --model veed/dubbing/video-translate \
  --input-json '{"source_language":"auto","target_language":"af","video_url":"https://example.com/reference.mp4"}' \
  --wait

Wejściem jest własny schemat tego endpointu, ten sam co w przykładach powyżej. --wait odpytuje aż do zakończenia zadania i wypisuje wynik; dodaj --yes, żeby pominąć pytanie o potwierdzenie w CI. Najpierw ustaw SPICY_API_KEY – jeden klucz działa w API, w CLI i na serwerze MCP.

Pliki lokalne

npx @spicyapi/cli files upload ./poster.png
# -> spicy://uploads/01k3m8x9q2z4v7n5p6r8s0t1w3

npx @spicyapi/cli tasks create --model veed/dubbing/video-translate \
  --input-json '{"video_url":"spicy://uploads/01k3m8x9q2z4v7n5p6r8s0t1w3"}' \
  --wait

Ciało żądania przyjmuje adresy, a nie bajty. Najpierw wyślij plik i podaj wypisany identyfikator spicy:// – nazwa pola powyżej pochodzi wprost ze schematu tego endpointu. Agent na MCP robi ten krok za ciebie, dlatego zdanie wyżej może wskazać ./poster.png bezpośrednio. Media dostępne już publicznie po HTTPS nie wymagają wysyłania.

Jak długo przechowujemy wyniki

npx @spicyapi/cli tasks create --model veed/dubbing/video-translate \
  --input-json '{…}' --retention 1h --wait

npx @spicyapi/cli tasks get $TASK_ID   # read back the retention that applied

--retention potrafi wyłącznie skrócić okno – 30m, 1h, 7d albo 0, żeby usunąć zaraz po osiągnięciu przez zadanie stanu końcowego. Obowiązuje najkrótsza z trzech wartości: twojego żądania, ustawień konta i maksimum platformy, więc odczytaj ją z rekordu zadania, zamiast zakładać, że podana liczba zadziałała. Podanie okna dłuższego, niż pozwala konto, nic nie zmienia.

Użyj w ComfyUI

Zainstaluj węzły SpicyAPI przez ComfyUI Manager albo poleceniem poniżej, a potem wyszukaj na płótnie VEED Dubbing · Dub Video with Lip Sync. Węzeł ma te same opcje co ta strona i pokazuje cenę, zanim ruszy.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

Przykładowe workflowy Poradnik konfiguracji Kod źródłowy na GitHubie

Osadzony panel czyta ten sam schemat co ta strona, więc nie może się od API rozjechać. Jeśli twoja dokumentacja potrzebuje treści przeszukiwalnej, pobierz JSON spod /api/embed/models/ i wyrenderuj go samodzielnie.

<iframe src="https://spicyapi.ai/embed/pl/models/veed-dubbing/api?model=veed%2Fdubbing%2Fvideo-translate" width="100%" height="560" loading="lazy" title="Przykładowe żądanie" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Otwórz panel

Obszar roboczy

Wyślij żądanie

Uwierzytelnianie API

Parametry wejściowe

Śledź zadanie

Odczytaj wynik

SDK i integracje

Użyj w ComfyUI