Δημιουργήστε μια εργασία μετάφρασης
POST /api/v1/jobsIdempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402fContent-Type: application/jsonΑίτημα
Section titled “Αίτημα”| Πεδίο | Τύπος | Απαιτούμενο | Προεπιλεγμένο | Περιγραφή |
|---|---|---|---|---|
document_id | συμβολοσειρά | ✅ | — | Αναγνωριστικό επιβεβαιωμένου εγγράφου |
target_lang | συμβολοσειρά | ✅ | — | Κωδικός στόχιστης γλώσσας |
source_lang | συμβολοσειρά | — | Αυτόματη ανίχνευση | Κωδικός γλώσσας πηγής |
engine | συμβολοσειρά | — | xr-397b | Ταυτότητα ρύθμισης μετάφρασης, βλ. ρυθμίσεις μετάφρασης |
output_mode | συμβολοσειρά | — | bilingual | single ή bilingual |
glossary_id | συμβολοσειρά | — | — | Ένας κωδικός ορολογίας για αυτόν τον λογαριασμό. Οι λεξικοί όροι αφορούν πληρωμένους λογαριασμούς (τουλάχιστον μία επιτυχημένη πληρωμή). Ένας απλήρωτος λογαριασμός που στέλνει μία πληρωμή λαμβάνει 403 |
include_images | πολυδιακριτικός | — | false | Επίσης, μεταφράστε το κείμενο στις εικόνες του εγγράφου. |
context_translation | πολυδιακριτικός | — | false | Ενεργοποιήστε τη βελτίωση πλαισίου |
style_preset | συμβολοσειρά | — | — | Προκαθορισμένη ρύθμιση στυλ |
Μια δημιουργηθείσα εργασία εισάγεται στην ουρά. Κάθε λογαριασμός επεξεργάζεται έως 5 αρχεία ταυτόχρονα· περαιτέρω εργασίες δημιουργούνται και τοποθετούνται αυτόματα στην ουρά, ξεκινώντας όταν ολοκληρωθούν οι προηγούμενες. Ενώ μια εργασία βρίσκεται σε αναμονή, το stage_message της δείχνει πόσες εργασίες βρίσκονται μπροστά.
Πριν ξεκινήσει μια εργασία, το υπόλοιπο ελέγχεται σε σχέση με ένα όριο: μια PDF απαιτεί υπόλοιπο άνω του «σελίδες × 2 πιστώσεις»· οι άλλες μορφές βασίζονται στο μήκος του πηγαίου κειμένου, τουλάχιστον 2 πιστώσεις. Εάν το υπόλοιπο δεν επαρκεί για να ξεκινήσει ένα αρχείο, η συγκεκριμένη εργασία ολοκληρώνεται με status=failed και quota_exceeded=true, δεν χρεώνεται τίποτα και οι άλλες εργασίες δεν επηρεάζονται. Όταν ολοκληρωθεί μια εργασία, χρεώνεται η πραγματική χρήση· εάν το κόστος υπερβεί το υπόλοιπο, το υπόλοιπο γίνεται αρνητικό, οι πιστώσεις που προστίθενται αργότερα εξοφλούν πρώτα το χρέος, και δεν μπορούν να ξεκινήσουν νέες εργασίες όσο το υπόλοιπο είναι αρνητικό, οπότε πρέπει να αναπληρωθεί. Δείτε πιστώσεις και χρήση .
Παράδειγμα
Section titled “Παράδειγμα”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"}'Απόκριση 201 (το stage_message του διακομιστή είναι στα κινεζικά):
{ "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"}Σφάλματα
Section titled “Σφάλματα”| Κατάσταση | Αιτία |
|---|---|
403 | Το κλειδί δεν επιτρέπει την επιλεγμένη ρύθμιση, ή ένας ανενεργός λογαριασμός έστειλε glossary_id |
404 | Το έγγραφο ή το γλωσσάρι δεν υπάρχει, διαγράφηκε ή ανήκει σε άλλο λογαριασμό |
415 | Το αρχειακό σχήμα δεν μπορεί να μεταφραστεί |
422 | Το αρχείο είναι άδειο, δεν περιέχει μεταφράσιμο κείμενο ή κάποια παράμετρος είναι άκυρη |
429 | Πάρα πολλά αιτήματα ή η ουρά είναι γεμάτη· επαναλάβετε την προσπάθεια μετά από Retry-After |
Ιδιμποτενσία
Section titled “Ιδιμποτενσία”Το Idempotency-Key είναι προαιρετικό, αλλά συνιστάται για κάθε υποβολή. Ένας κλειδώριος είναι 1–128 ορατοί χαρακτήρες ASCII και παραμένει έγκυρος επ’ αόριστον για την ίδια διαπίστευση:
- Ίδιο πλήκτρο, ίδιο σώμα: επιστρέφει την αρχική εργασία (συμπεριλαμβανομένης και μιας αποτυχημένης); δεν δημιουργείται ή χρεώνεται τίποτα δύο φορές.
- Ίδιο πλήκτρο, διαφορετικό σώμα:
409(idempotency_request_conflict). - Η αρχική εργασία διαγράφηκε:
410(idempotency_job_gone).
Χρησιμοποιήστε ένα νέο UUID για κάθε νέα υποβολή και επαναχρησιμοποιήστε το αρχικό κλειδί μόνο όταν επαναλαμβάνετε την ίδια υποβολή.