Przejdź do głównej zawartości

Utwórz zadanie tłumaczeniowe

POST /api/v1/jobs
Idempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402f
Content-Type: application/json
PoleTypWymaganeDomyślnyOpis
document_idciąg znaków✅—ID potwierdzonego dokumentu
target_langciąg znaków✅—Kod języka docelowego
source_langciąg znaków—Automatyczne wykrywanieKod języka źródłowego
engineciąg znaków—xr-397bIdentyfikator ustawienia tłumaczenia, zobacz ustawienia tłumaczenia
output_modeciąg znaków—bilingualsingle lub bilingual
glossary_idciąg znaków——Identyfikator glosariusza dla tego konta. Glosariusze są przeznaczone dla płatnych kont (przynajmniej jeden udany płatność); nieopłacone konto, które wyśle jedną płatność, otrzymuje 403
include_imagesboolean—falseTakże przetłumacz tekst na obrazkach w dokumencie.
context_translationboolean—falseWłącz ulepszenie kontekstu
style_presetciąg znaków——Wstępna konfiguracja stylu

Utworzona praca wchodzi do kolejki. Każde konto przetwarza jednocześnie maksymalnie 5 plików; kolejne prace są nadal tworzone i automatycznie umieszczane w kolejce, rozpoczynając się po zakończeniu wcześniejszych zadań. Podczas oczekiwania na wykonanie zadanie wyświetla w polu stage_message liczbę prac znajdujących się przed nim w kolejności.

Przed rozpoczęciem zadania saldo jest sprawdzane pod względem progu: format PDF wymaga salda powyżej „strony × 2 kredyty”; inne formaty są oceniane na podstawie długości tekstu źródłowego, minimum 2 kredyty. Jeśli saldo nie pozwala rozpocząć pliku, to zadanie kończy się kodami status=failed i quota_exceeded=true, żaden koszt nie jest naliczany, a pozostałe zadania nie są dotknięte. Po zakończeniu zadania naliczany jest rzeczywisty zużycie; jeśli koszt przekracza saldo, saldo staje się ujemne, najpierw spłacane są później nadeszłe kredyty, a nowe zadania nie mogą zostać rozpoczęte, gdy saldo jest ujemne, dlatego należy dokonać doładowania. Zobacz kredyty i zużycie .

Okno terminala
curl --fail-with-body -X POST https://omnidoc.top/api/v1/jobs \
-H "X-API-Key: $OMNIDOC_API_KEY" \
-H "Idempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402f" \
-H "Content-Type: application/json" \
-d '{"document_id":"4q8mx2q9z1k7p6ra","target_lang":"en"}'

Odpowiedź 201 (serwer stage_message jest w języku chińskim):

{
"id": "q3f8s6c2a9m1k4tx",
"document_id": "4q8mx2q9z1k7p6ra",
"source_lang": null,
"target_lang": "en",
"engine": "xr-397b",
"status": "pending",
"stage": "queued",
"stage_progress": 0,
"stage_message": "排队中",
"time_cost": 0,
"error_msg": null,
"quota_exceeded": false,
"queue_position": null,
"created_at": "2026-10-01T12:01:00Z",
"updated_at": "2026-10-01T12:01:00Z"
}
StatusPrzyczyna
403Klucz nie pozwala na wybrany ustawienie lub konto nieopłacone wysłało glossary_id
404Dokument lub glosariusz nie istnieje, został usunięty lub należy do innego konta.
415Format pliku nie może zostać przetłumaczony.
422Plik jest pusty, nie zawiera tekstu do tłumaczenia lub jeden z parametrów jest nieprawidłowy.
429Zbyt wiele żądań lub kolejka jest pełna; spróbuj ponownie po Retry-After

Idempotency-Key jest opcjonalny, ale zalecany dla każdego przesłania. Klucz to 1–128 widocznych znaków ASCII i pozostaje ważny bezterminowo dla tej samej uwierzytelniającej:

  • Ten sam klucz, ten sam obudowa: zwraca oryginalne zadanie (w tym niepowodujące); żadne elementy nie są tworzone ani naliczane podwójnie.
  • Ten sam klucz, inny korpus: 409 (idempotency_request_conflict).
  • Oryginalne zadanie zostało usunięte: 410 (idempotency_job_gone).

Używaj nowego UUID dla każdego nowego przesyłania i ponownie używaj oryginalnego klucza tylko podczas powtórnego próbowania tego samego przesyłania.