跳转到内容

Γρήγορη εκκίνηση

Η παρακάτω διαδικασία χρησιμοποιεί μια κλειδόσφραγη API για να ανεβάσει ένα αρχείο, να δημιουργήσει μια διαδικασία μετάφρασης και να κατεβάσει τα αποτελέσματα.

  1. Ετοιμάστε τα δικαιολογητικά και το αρχείο

    Terminal window
    export OMNIDOC_API_KEY="sk_your_key"
    BASE="https://omnidoc.top/api/v1"
    FILE="report.docx"
    SIZE=$(wc -c < "$FILE" | tr -d ' ')
  2. Ζητήστε μια διεύθυνση και ανεβάστε το αρχείο

    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"
  3. Επιβεβαιώστε την ανάρτηση και λάβετε τον αριθμό αναγνώρισης του εγγράφου

    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')
  4. Δημιουργήστε την εργασία μετάφρασης

    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')
  5. Περιμένετε την ολοκλήρωση και τη λήψη

    import re
    import time
    from urllib.parse import unquote
    while 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"}:
    break
    time.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 = fallback
    safe_name = Path(name).name or fallback
    Path(safe_name).write_bytes(download.content)

Το σενάριο εκτυπώνει πρώτα το job_id. Όταν η εργασία επιτύχει, τα αποτελέσματα κατεβαίνουν στον τρέχοντα κατάλογο. Η παρακολούθηση σταματά όταν η εργασία φτάσει στο completed ή failed.

Ο χρόνος που απαιτείται εξαρτάται από το μέγεθος του αρχείου και την ουρά. Σε παραγωγή, χρησιμοποιήστε ένα webhook ή SSE αντί για polling χωρίς όριο.

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

  • 401: ελέγξτε ότι η μεταβλητή περιβάλλοντος έχει οριστεί και ο κωδικός είναι έγκυρος.
  • 402, ή quota_exceeded στην εργασία: ελέγξτε ότι το πιστωτικό υπόλοιπο (μετά το χρέος) καλύπτει το όριο εκκίνησης.
  • 403: ελέγξτε τον προϋπολογισμό του κλειδιού, τις επιτρεπόμενες ρυθμίσεις του και τον ιδιοκτήτη του πόρου.
  • 429: διαβάστε τον κωδικό επιχειρηματικού σφάλματος για να διακρίνετε το όριο ρυθμού, τη γεμάτη ουρά και το εξαντλημένο προϋπολογισμό.
  • Η διεύθυνση άμεσης ανάρτησης έχει λήξει ή η ανάρτηση απέτυχε: ζητήστε μια νέα διεύθυνση ανάρτησης.

Καταγράψτε το X-Request-Id και τη διαδρομή αίτησης, αλλά ποτέ το πλήρες κλειδί ή τα διαπιστευτήρια μεταφόρτωσης. Όλα τα σφάλματα και οι μέθοδοι επαναληπτικής προσπάθειας βρίσκονται στην παραπομπή sφάλμα .