> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.voicecheap.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Pobierz stan przetwarzania projektu > Sprawdzaj postęp transkrypcji, tłumaczenia i synchronizacji ruchu ust oraz pobieraj adresy URL ukończonych wyników. Sprawdzaj postęp transkrypcji, tłumaczenia i synchronizacji ruchu ust oraz pobieraj adresy URL ukończonych wyników. ```http theme={null} POST https://api.voicecheap.ai/v1/actions/projects_status ``` ## Uwierzytelnianie i uprawnienia Wyślij klucz API VoiceCheap w tym nagłówku. Obsługiwany jest również nagłówek Authorization: Bearer z tym samym kluczem API. Tokeny dostępu OAuth są akceptowane tylko przez MCP, a nie przez ten endpoint REST. Wymagane uprawnienia: `projects:read`. Wymagana jest aktywna płatna subskrypcja. Uprawnienia nie zmieniają ról w zespole, własności zasobów, kredytów na multimedia ani limitów planu. ## Parametry Wartość tekstowa. Minimalna długość: 1. Maksymalna długość: 200. Wzorzec: `^[^/\\]+$`. Poniższy JSON Schema zachowuje dokładne nazwy pól, typy zagnieżdżone, wartości domyślne, ograniczenia i akceptowane wartości udostępniane przez mechanizm wykrywania. Dodatkowe reguły zależności między polami znajdują się w uwagach do operacji. ```json theme={null} { "type": "object", "properties": { "projectId": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "^[^/\\\\]+$" } }, "required": ["projectId"], "additionalProperties": false } ``` ## Przykłady żądań Zastąp przykładowe identyfikatory zasobów i klucze multimediów wartościami zwróconymi dla Twojego konta. Przy ponawianiu tej samej operacji zmieniającej dane zachowaj identyfikator żądania. ```bash cURL theme={null} curl --request POST 'https://api.voicecheap.ai/v1/actions/projects_status' \ --header "x-api-key: $VOICECHEAP_API_KEY" \ --header 'Content-Type: application/json' \ --data '{"projectId":"project_launch_2026"}' ``` ```javascript JavaScript theme={null} const input = { projectId: 'project_launch_2026', }; const response = await fetch('https://api.voicecheap.ai/v1/actions/projects_status', { method: 'POST', headers: { 'x-api-key': process.env.VOICECHEAP_API_KEY, 'Content-Type': 'application/json', }, body: JSON.stringify(input), }); const body = await response.json(); if (!response.ok) throw new Error(body.code + ': ' + body.message); console.log(body); ``` ```python Python theme={null} import os import requests response = requests.post( "https://api.voicecheap.ai/v1/actions/projects_status", headers={"x-api-key": os.environ["VOICECHEAP_API_KEY"]}, json={"projectId": "project_launch_2026"}, timeout=120, ) body = response.json() if not response.ok: raise RuntimeError(f"{body.get('code')}: {body.get('message')}") print(body) ``` ## Odpowiedź Pierwsze pomyślne wykonanie zwraca HTTP 200 z wynikiem operacji w data. Ponowienie może zamiast tego zwrócić zapisany stan żądania. Przykład przedstawia jedną obsługiwaną odpowiedź, bez wszystkich opcjonalnych pól. Zwraca postęp przetwarzania i adresy URL ukończonych wyników bez osadzonych transkrypcji. ```json HTTP 200 theme={null} { "data": { "projectId": "project_launch_2026", "projectName": "Product launch", "originalVideoUrl": "https://media.example.com/launch/original.mp4", "originalLanguage": "fr", "targetLanguage": "english", "duration": 75, "createdAt": 1792152000000, "workflow": "translation", "transcriptionStatus": "success", "actualProgressStep": "done", "translationAndTranscriptionProgress": 100, "workId": "5f8423d1-e4c0-4f80-9e3f-eed959389e24", "translatedVersionId": "0fa684f3-4997-4d7a-9424-16d1f9ac849c", "dubbingStep": "done", "dubbingProgress": 100, "status": "success", "translatedVideoUrl": "https://media.example.com/launch/english.mp4", "translatedAudioUrl": "https://media.example.com/launch/english.mp3" } } ``` ## Pola wyniku | Pole | Opis | | - | - | | `data.projectId` | Identyfikator projektu nadrzędnego. | | `data.projectName` | Nazwa projektu. | | `data.originalVideoUrl` | Oryginalny zapisany adres URL mediów lub pusty ciąg tekstowy. | | `data.originalLanguage` | Język źródłowy lub unknown. | | `data.targetLanguage` | Pierwszy skonfigurowany język docelowy projektu, domyślnie english; nie jest to lista wszystkich wersji językowych. | | `data.duration` | Czas trwania mediów w sekundach. | | `data.createdAt` | Czas utworzenia projektu w milisekundach czasu Unix. | | `data.workflow` | transcription lub translation. | | `data.transcriptionStatus` | processing, success lub failed. | | `data.actualProgressStep` | Bieżący etap projektu, zastępowany etapem dubbingu po zakończeniu transkrypcji, jeśli dubbing nadal trwa. | | `data.translationAndTranscriptionProgress` | Opcjonalny zapisany postęp transkrypcji. | | `data.status` | processing, success lub failed dla bieżącego procesu. | | `data.workId` | Obecne, gdy w najnowszej wersji językowej istnieje najnowsza przetłumaczona wersja. | | `data.translatedVersionId` | Identyfikator najnowszej wersji w najnowszej wersji językowej. | | `data.dubbingStep` | Opcjonalny etap dubbingu z tej wersji. | | `data.dubbingProgress` | Opcjonalny postęp dubbingu z tej wersji. | | `data.translatedVideoUrl` | Dołączane dla pomyślnie ukończonej wersji, gdy istnieje adres URL wideo. | | `data.translatedAudioUrl` | Dołączane dla pomyślnie ukończonej wersji; pusty ciąg znaków, gdy nie zapisano adresu URL audio. | | `data.lipSync` | Opcjonalny najnowszy wpis synchronizacji ruchu ust z jobId, status, videoUrl, errorMessage, publicznym polem type, createdAt oraz opcjonalnymi requestedAt, completedAt, failedAt, timedOutAt, activeSpeakerDetectionEnabled. | | `data.error` | Opcjonalne publiczne \{code,message}, gdy przetwarzanie projektu, tłumaczenie lub synchronizacja ruchu ust zakończyły się błędem. | ## Uwagi do operacji * Użyj tej akcji do sprawdzania stanu projects\_create, translations\_create, translations\_start, translations\_dub i lipsync\_create. Transkrypcje pobieraj osobno przez transcripts\_get. * Ten uwierzytelniony odczyt stanu, podlegający limitowi częstotliwości, nie zużywa miesięcznego limitu wywołań akcji. * W przypadku tłumaczeń śledzi ostatnio utworzoną wersję językową i jej ostatnią wersję. Aby uzyskać pełny stan wielu języków, odczytaj projects\_get lub translations\_list. * Projekt obejmujący tylko transkrypcję kończy się pomyślnie po ukończeniu transkrypcji. Ukończony wynik dubbingu może pozostać w stanie processing, gdy synchronizacja ruchu ust jest aktywna, lub w stanie failed, jeśli ostatnia synchronizacja ruchu ust się nie powiodła. * Procedura obsługi zawsze usuwa transcripts z bazowego wyniku stanu. Nie zawiera pól ukończenia dynamicznych napisów; sprawdzaj je przez projects\_get. * Zapisane błędy zwracają kody błędów VoiceCheap i stałe komunikaty. Użyj kodu i aktualnego stanu zasobu, aby zdecydować, jak wznowić działanie. ## Wykorzystanie Ta kontrola stanu lub wykorzystania nie zużywa miesięcznego limitu wywołań API/MCP. Nadal obowiązują zasady uwierzytelniania, płatnego dostępu, własności i limitów częstotliwości. ## Błędy | Status HTTP | Kod | Znaczenie lub sposób rozwiązania | | - | - | - | | 400 | `CREDENTIAL_IN_QUERY` | Dane uwierzytelniające zostały podane w parametrze zapytania access\_token lub api\_key. Wysyłaj dane uwierzytelniające w nagłówkach. | | 400 | `VALIDATION_ERROR` | Popraw dane wejściowe zgodnie ze schematem. Nieprawidłowe lub niespójne wartości są odrzucane przed wykonaniem. | | 401 | `API_KEY_EXPIRED` | Klucz API wygasł. | | 401 | `INVALID_API_KEY` | Podaj prawidłowy, niewygasły klucz API. | | 401 | `INVALID_CREDENTIAL` | Nagłówek Authorization ma nieprawidłowy format lub jest sprzeczny z x-api-key. | | 401 | `MISSING_CREDENTIAL` | Nie podano użytecznych danych uwierzytelniających w nagłówku lub przekroczyły one 4096 znaków. | | 401 | `USER_NOT_FOUND` | Konto powiązane z poświadczeniem już nie istnieje. | | 403 | `AMBIGUOUS_TEAM_API_KEY` | Użytkownik, do którego należą dane uwierzytelniające, należy do więcej niż jednego zespołu, więc kontekst rozliczeniowy jest niejednoznaczny. | | 403 | `FORBIDDEN` | Uwierzytelniony podmiot wykonujący akcję nie ma dostępu do tego projektu. | | 403 | `INSUFFICIENT_SCOPE` | Nadaj wszystkie wymagane uprawnienia lub wybierz inne dane uwierzytelniające. | | 403 | `INTEGRATION_PLAN_UNSUPPORTED` | Nie udało się zweryfikować limitów integracji konta. | | 403 | `SUBSCRIPTION_REQUIRED` | Użyj aktywnej płatnej subskrypcji. | | 403 | `TEAM_OWNER_NOT_FOUND` | Nie znaleziono konta faktycznego właściciela zespołu. | | 404 | `PROJECT_NOT_FOUND` | Projekt nie istnieje na dostępnym koncie. | | 429 | `INTEGRATION_RATE_LIMIT_REACHED` | Jeśli występuje nagłówek Retry-After, odczekaj wskazany czas i stosuj rosnące odstępy między ponowieniami. | | 500 | `INTERNAL_ERROR` | Sprawdź stan zapisanego żądania i historię zasobu przed podjęciem decyzji o ponowieniu operacji zmieniającej dane. | | 503 | `SERVER_RESTARTING` | Serwer jest uruchamiany ponownie. Spróbuj ponownie wkrótce i zachowaj ten sam identyfikator żądania dla operacji zmieniającej dane. | ```json theme={null} { "code": "INSUFFICIENT_SCOPE", "message": "This credential does not permit the requested action.", "status": 403, "details": { "requiredScopes": ["projects:read"] } } ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.