Sari la conținut

Start rapid

Fluxul de mai jos folosește o cheie API pentru a încărca un fișier, a crea un job de traducere și a descărca rezultatele.

  1. Preparați credențialele și fișierul

    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. Solicitați o adresă și încărcați fișierul

    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. Confirma încărcarea și obține ID-ul documentului

    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. Creează sarcina de traducere

    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. Așteaptă finalizarea și descărcarea

    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)

Scriptul afișează mai întâi job_id. Atunci când sarcina are succes, rezultatele sunt descărcate în directorul curent. Poluarea se oprește atunci când sarcina atinge completed sau failed.

Durata depinde de dimensiunea fișierului și de coada de procesare. În producție, folosiți un webhook sau SSE în locul verificării continue fără limită.

Exemplul nu reîncearcă automat cererile de creare. După o limită de timp la nivel de rețea, păstrați ID-ul sarcinii, cheia de idempotență și corpul cererii, verificând mai întâi starea. O sarcină creată nu este anulată atunci când scriptul se încheie.

  • 401: verificați dacă variabila de mediu este setată și cheia este validă.
  • 402, sau quota_exceeded la locul de muncă: verificați dacă soldul credit (după datorii) acoperă pragul de început.
  • 403: verifica bugetul cheii, setările permise și proprietarul resursei.
  • 429: citiți codul de eroare comercial pentru a diferenția limita de rată, coada plină și bugetul epuizat.
  • Adresa de încărcare directă a expirat sau încărcarea nu a reușit: solicitați o nouă adresă de încărcare.

Înregistrează X-Request-Id și calea cererii, dar niciodată cheia completă sau credențialele de încărcare. Toate erorile și metodele de retried sunt în referința eroare .