Tovább a tartalomhoz

Gyorsindítás

Az alábbi művelet egy API-kulcs segítségével tölt fel egy fájlt, létrehoz egy fordítási feladatot és letölti az eredményeket.

  1. Készítse elő a hitelesítő adatokat és a fájlt

    Terminál
    export OMNIDOC_API_KEY="sk_your_key"
    BASE="https://omnidoc.top/api/v1"
    FILE="report.docx"
    SIZE=$(wc -c < "$FILE" | tr -d ' ')
  2. Kérjen címet és töltse fel a fájlt

    Terminál
    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. Erősítse meg a feltöltést és szerezze meg a dokumentumazonosítót

    Terminál
    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. Hozzon létre fordítási feladatot

    Terminál
    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. Várjon a befejezésre és töltse le

    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)

A szkript először kiírja a job_id-at. Ha a feladat sikeres, az eredmények letöltődnek a jelenlegi könyvtárba. A lekérdezés megszűnik, amikor a feladat eléri a completed-et vagy a failed-at.

Az időtartam a fájl méretétől és a sorrendtől függ. Termelési környezetben használjon webhook vagy SSE / helyett korlátlan lekérdezést.

A példa nem próbálkozik újra a létrehozási kérésekkel automatikusan. Hálózati időtúllépés után tartsa meg a feladatazonosítót, az idempotencia kulcsát és a kérelem testét, majd először ellenőrizze a állapotot. A létrehozott feladat nem szűnik meg a script kilépésekor.

  • 401: ellenőrizze, hogy a környezeti változó be van-e állítva és a kulcs érvényes.
  • 402, vagy quota_exceeded munkafolyamatban: ellenőrizze, hogy a jóváírásos egyenleg (adósság után) fedezze a kezdő küszöbértéket.
  • 403: ellenőrizze a kulcs költségvetését, az engedélyezett beállításokat és hogy ki a forrás tulajdonosa.
  • 429: olvassa ki az üzleti hibakódot, hogy megkülönböztesse a sebességkorlátozást, a teljes sorost és a kifogyott költségkeretet.
  • A közvetlen feltöltési cím lejárt vagy a feltöltés sikertelen volt: kérjen új feltöltési címet.

Rögzítse a X-Request-Id-et és a kérési elérési útvonalat, de soha ne rögzítse a teljes kulcsot vagy feltöltési hitelesítő adatokat. Minden hiba és újrapróbálási módszer az hibahivatkozásban található .