Γρήγορη εκκίνηση
Η παρακάτω διαδικασία χρησιμοποιεί μια κλειδόσφραγη API για να ανεβάσει ένα αρχείο, να δημιουργήσει μια διαδικασία μετάφρασης και να κατεβάσει τα αποτελέσματα.
-
Ετοιμάστε τα δικαιολογητικά και το αρχείο
Terminal window export OMNIDOC_API_KEY="sk_your_key"BASE="https://omnidoc.top/api/v1"FILE="report.docx"SIZE=$(wc -c < "$FILE" | tr -d ' ')import uuidfrom pathlib import Pathimport requestsAPI_KEY = "sk_your_key"BASE = "https://omnidoc.top/api/v1"FILE = Path("report.docx")H = {"X-API-Key": API_KEY}import axios from 'axios';import fs from 'node:fs';import path from 'node:path';const API_KEY = 'sk_your_key';const BASE = 'https://omnidoc.top/api/v1';const filePath = 'report.docx';const apiHeaders = { 'X-API-Key': API_KEY }; -
Ζητήστε μια διεύθυνση και ανεβάστε το αρχείο
Terminal window PRESIGN=$(curl --fail-with-body -sS "$BASE/upload/presign" \-H "X-API-Key: $OMNIDOC_API_KEY" \-H "Content-Type: application/json" \-d "$(jq -n --arg filename "$(basename "$FILE")" --argjson size "$SIZE" \'{filename:$filename,file_size:$size}')")UPLOAD_URL=$(printf '%s' "$PRESIGN" | jq -r '.upload_url')UPLOAD_TYPE=$(printf '%s' "$PRESIGN" | jq -r '.upload_headers["Content-Type"]')FINALIZE_TOKEN=$(printf '%s' "$PRESIGN" | jq -r '.finalize_token')curl --fail-with-body -sS -X PUT "$UPLOAD_URL" \-H "Content-Type: $UPLOAD_TYPE" \-H "If-None-Match: *" \--upload-file "$FILE"presign = requests.post(f"{BASE}/upload/presign",headers=H,json={"filename": FILE.name,"file_size": FILE.stat().st_size,},timeout=20,)presign.raise_for_status()ticket = presign.json()with FILE.open("rb") as stream:put_headers = {**ticket["upload_headers"],"Content-Length": str(FILE.stat().st_size),}uploaded = requests.put(ticket["upload_url"], headers=put_headers, data=stream, timeout=300)uploaded.raise_for_status()const stat = fs.statSync(filePath);const { data: ticket } = await axios.post(`${BASE}/upload/presign`,{filename: path.basename(filePath),file_size: stat.size,},{ headers: apiHeaders });await axios.put(ticket.upload_url, fs.createReadStream(filePath), {headers: { ...ticket.upload_headers, 'Content-Length': stat.size },maxBodyLength: Infinity,}); -
Επιβεβαιώστε την ανάρτηση και λάβετε τον αριθμό αναγνώρισης του εγγράφου
Terminal window DOCUMENT=$(curl --fail-with-body -sS "$BASE/upload/finalize" \-H "X-API-Key: $OMNIDOC_API_KEY" \-H "Content-Type: application/json" \-d "$(jq -n --arg token "$FINALIZE_TOKEN" '{finalize_token:$token}')")DOCUMENT_ID=$(printf '%s' "$DOCUMENT" | jq -r '.document.id')finalized = requests.post(f"{BASE}/upload/finalize",headers=H,json={"finalize_token": ticket["finalize_token"]},timeout=30,)finalized.raise_for_status()document_id = finalized.json()["document"]["id"]const { data: finalized } = await axios.post(`${BASE}/upload/finalize`,{ finalize_token: ticket.finalize_token },{ headers: apiHeaders });const documentId = finalized.document.id; -
Δημιουργήστε την εργασία μετάφρασης
Terminal window JOB=$(curl --fail-with-body -sS "$BASE/jobs" \-H "X-API-Key: $OMNIDOC_API_KEY" \-H "Content-Type: application/json" \-H "Idempotency-Key: $(uuidgen)" \-d "$(jq -n --arg document_id "$DOCUMENT_ID" \'{document_id:$document_id,target_lang:"en"}')")JOB_ID=$(printf '%s' "$JOB" | jq -r '.id')job_response = requests.post(f"{BASE}/jobs",headers={**H, "Idempotency-Key": str(uuid.uuid4())},json={"document_id": document_id, "target_lang": "en"},timeout=30,)job_response.raise_for_status()job_id = job_response.json()["id"]const { data: job } = await axios.post(`${BASE}/jobs`,{ document_id: documentId, target_lang: 'en' },{ headers: { ...apiHeaders, 'Idempotency-Key': crypto.randomUUID() } });const jobId = job.id; -
Περιμένετε την ολοκλήρωση και τη λήψη
import reimport timefrom urllib.parse import unquotewhile True:response = requests.get(f"{BASE}/jobs/{job_id}", headers=H, timeout=20)response.raise_for_status()job = response.json()if job["status"] in {"completed", "failed"}:breaktime.sleep(3)if job["status"] == "failed":raise RuntimeError(job.get("error_msg") or "translation failed")artifacts = requests.get(f"{BASE}/artifacts", headers=H, params={"job_id": job_id}, timeout=20)artifacts.raise_for_status()for artifact in artifacts.json():download = requests.get(f"{BASE}/artifacts/{artifact['id']}/download",headers=H,timeout=300,)download.raise_for_status()fallback = f"{artifact['id']}.{artifact['format']}"disposition = download.headers.get("Content-Disposition", "")utf8 = re.search(r"filename\*=UTF-8''([^;]+)", disposition, re.I)plain = re.search(r'filename="([^"]+)"', disposition, re.I)if utf8:name = unquote(utf8.group(1))elif plain:name = plain.group(1)else:name = fallbacksafe_name = Path(name).name or fallbackPath(safe_name).write_bytes(download.content)
Τι παίρνετε
Section titled “Τι παίρνετε”Το σενάριο εκτυπώνει πρώτα το job_id. Όταν η εργασία επιτύχει, τα αποτελέσματα κατεβαίνουν στον τρέχοντα κατάλογο. Η παρακολούθηση σταματά όταν η εργασία φτάσει στο completed ή failed.
Ο χρόνος που απαιτείται εξαρτάται από το μέγεθος του αρχείου και την ουρά. Σε παραγωγή, χρησιμοποιήστε ένα webhook ή SSE αντί για polling χωρίς όριο.
Το παράδειγμα δεν επαναλαμβάνει αυτόματα τις αιτήσεις δημιουργίας. Μετά από περιορισμό χρόνου δικτύου, διατηρήστε το ID της εργασίας, το κλειδί ιδεμποτενσίας και το σώμα της αίτησης, και ελέγξτε πρώτα την κατάσταση. μια εργασία που δημιουργήθηκε δεν ακυρώνεται όταν το σενάριο τερματίζεται.
Όταν κάτι αποτύχει
Section titled “Όταν κάτι αποτύχει”401: ελέγξτε ότι η μεταβλητή περιβάλλοντος έχει οριστεί και ο κωδικός είναι έγκυρος.402, ήquota_exceededστην εργασία: ελέγξτε ότι το πιστωτικό υπόλοιπο (μετά το χρέος) καλύπτει το όριο εκκίνησης.403: ελέγξτε τον προϋπολογισμό του κλειδιού, τις επιτρεπόμενες ρυθμίσεις του και τον ιδιοκτήτη του πόρου.429: διαβάστε τον κωδικό επιχειρηματικού σφάλματος για να διακρίνετε το όριο ρυθμού, τη γεμάτη ουρά και το εξαντλημένο προϋπολογισμό.- Η διεύθυνση άμεσης ανάρτησης έχει λήξει ή η ανάρτηση απέτυχε: ζητήστε μια νέα διεύθυνση ανάρτησης.
Καταγράψτε το X-Request-Id και τη διαδρομή αίτησης, αλλά ποτέ το πλήρες κλειδί ή τα διαπιστευτήρια μεταφόρτωσης. Όλα τα σφάλματα και οι μέθοδοι επαναληπτικής προσπάθειας βρίσκονται στην παραπομπή sφάλμα .