跳转到内容

Δημιουργήστε μια εργασία μετάφρασης

POST /api/v1/jobs
Idempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402f
Content-Type: application/json
ΠεδίοΤύποςΑπαιτούμενοΠροεπιλεγμένοΠεριγραφή
document_idσυμβολοσειρά✅—Αναγνωριστικό επιβεβαιωμένου εγγράφου
target_langσυμβολοσειρά✅—Κωδικός στόχιστης γλώσσας
source_langσυμβολοσειρά—Αυτόματη ανίχνευσηΚωδικός γλώσσας πηγής
engineσυμβολοσειρά—xr-397bΤαυτότητα ρύθμισης μετάφρασης, βλ. ρυθμίσεις μετάφρασης
output_modeσυμβολοσειρά—bilingualsingle ή bilingual
glossary_idσυμβολοσειρά——Ένας κωδικός ορολογίας για αυτόν τον λογαριασμό. Οι λεξικοί όροι αφορούν πληρωμένους λογαριασμούς (τουλάχιστον μία επιτυχημένη πληρωμή). Ένας απλήρωτος λογαριασμός που στέλνει μία πληρωμή λαμβάνει 403
include_imagesπολυδιακριτικός—falseΕπίσης, μεταφράστε το κείμενο στις εικόνες του εγγράφου.
context_translationπολυδιακριτικός—falseΕνεργοποιήστε τη βελτίωση πλαισίου
style_presetσυμβολοσειρά——Προκαθορισμένη ρύθμιση στυλ

Μια δημιουργηθείσα εργασία εισάγεται στην ουρά. Κάθε λογαριασμός επεξεργάζεται έως 5 αρχεία ταυτόχρονα· περαιτέρω εργασίες δημιουργούνται και τοποθετούνται αυτόματα στην ουρά, ξεκινώντας όταν ολοκληρωθούν οι προηγούμενες. Ενώ μια εργασία βρίσκεται σε αναμονή, το stage_message της δείχνει πόσες εργασίες βρίσκονται μπροστά.

Πριν ξεκινήσει μια εργασία, το υπόλοιπο ελέγχεται σε σχέση με ένα όριο: μια PDF απαιτεί υπόλοιπο άνω του «σελίδες × 2 πιστώσεις»· οι άλλες μορφές βασίζονται στο μήκος του πηγαίου κειμένου, τουλάχιστον 2 πιστώσεις. Εάν το υπόλοιπο δεν επαρκεί για να ξεκινήσει ένα αρχείο, η συγκεκριμένη εργασία ολοκληρώνεται με status=failed και quota_exceeded=true, δεν χρεώνεται τίποτα και οι άλλες εργασίες δεν επηρεάζονται. Όταν ολοκληρωθεί μια εργασία, χρεώνεται η πραγματική χρήση· εάν το κόστος υπερβεί το υπόλοιπο, το υπόλοιπο γίνεται αρνητικό, οι πιστώσεις που προστίθενται αργότερα εξοφλούν πρώτα το χρέος, και δεν μπορούν να ξεκινήσουν νέες εργασίες όσο το υπόλοιπο είναι αρνητικό, οπότε πρέπει να αναπληρωθεί. Δείτε πιστώσεις και χρήση .

Terminal window
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"
}
ΚατάστασηΑιτία
403Το κλειδί δεν επιτρέπει την επιλεγμένη ρύθμιση, ή ένας ανενεργός λογαριασμός έστειλε glossary_id
404Το έγγραφο ή το γλωσσάρι δεν υπάρχει, διαγράφηκε ή ανήκει σε άλλο λογαριασμό
415Το αρχειακό σχήμα δεν μπορεί να μεταφραστεί
422Το αρχείο είναι άδειο, δεν περιέχει μεταφράσιμο κείμενο ή κάποια παράμετρος είναι άκυρη
429Πάρα πολλά αιτήματα ή η ουρά είναι γεμάτη· επαναλάβετε την προσπάθεια μετά από Retry-After

Το Idempotency-Key είναι προαιρετικό, αλλά συνιστάται για κάθε υποβολή. Ένας κλειδώριος είναι 1–128 ορατοί χαρακτήρες ASCII και παραμένει έγκυρος επ’ αόριστον για την ίδια διαπίστευση:

  • Ίδιο πλήκτρο, ίδιο σώμα: επιστρέφει την αρχική εργασία (συμπεριλαμβανομένης και μιας αποτυχημένης); δεν δημιουργείται ή χρεώνεται τίποτα δύο φορές.
  • Ίδιο πλήκτρο, διαφορετικό σώμα: 409 (idempotency_request_conflict).
  • Η αρχική εργασία διαγράφηκε: 410 (idempotency_job_gone).

Χρησιμοποιήστε ένα νέο UUID για κάθε νέα υποβολή και επαναχρησιμοποιήστε το αρχικό κλειδί μόνο όταν επαναλαμβάνετε την ίδια υποβολή.