Utwórz zadanie tłumaczeniowe
POST /api/v1/jobsIdempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402fContent-Type: application/jsonŻądanie
Dział zatytułowany „Żądanie”| Pole | Typ | Wymagane | Domyślny | Opis |
|---|---|---|---|---|
document_id | ciąg znaków | ✅ | — | ID potwierdzonego dokumentu |
target_lang | ciąg znaków | ✅ | — | Kod języka docelowego |
source_lang | ciąg znaków | — | Automatyczne wykrywanie | Kod języka źródłowego |
engine | ciąg znaków | — | xr-397b | Identyfikator ustawienia tłumaczenia, zobacz ustawienia tłumaczenia |
output_mode | ciąg znaków | — | bilingual | single lub bilingual |
glossary_id | cią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_images | boolean | — | false | Także przetłumacz tekst na obrazkach w dokumencie. |
context_translation | boolean | — | false | Włącz ulepszenie kontekstu |
style_preset | cią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 .
Przykład
Dział zatytułowany „Przykład”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"}| Status | Przyczyna |
|---|---|
403 | Klucz nie pozwala na wybrany ustawienie lub konto nieopłacone wysłało glossary_id |
404 | Dokument lub glosariusz nie istnieje, został usunięty lub należy do innego konta. |
415 | Format pliku nie może zostać przetłumaczony. |
422 | Plik jest pusty, nie zawiera tekstu do tłumaczenia lub jeden z parametrów jest nieprawidłowy. |
429 | Zbyt wiele żądań lub kolejka jest pełna; spróbuj ponownie po Retry-After |
Idempotentność
Dział zatytułowany „Idempotentność”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.