Lewati ke konten

Mulai cepat

Alur di bawah menggunakan kunci API untuk mengunggah satu file, membuat pekerjaan terjemahan, dan mengunduh hasilnya.

  1. Siapkan kredensial dan berkas

    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. Minta alamat dan unggah berkas

    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. Konfirmasikan unggahan dan dapatkan ID dokumen

    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. Buat pekerjaan terjemahan

    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. Tunggu hingga selesai dan unduh

    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)

Skrip tersebut terlebih dahulu mencetak job_id. Ketika pekerjaan berhasil, hasilnya diunduh ke direktori saat ini. Pemantauan berhenti ketika pekerjaan mencapai completed atau failed.

Waktu yang dibutuhkan tergantung pada ukuran file dan antrian. Dalam produksi, gunakan webhook atau SSE sebagai ganti polling tanpa batas.

Contoh ini tidak melakukan pencobaan ulang secara otomatis terhadap permintaan pembuatan. Setelah timeout jaringan, pertahankan ID pekerjaan, kunci idempotensi, dan badan permintaan, lalu periksa status terlebih dahulu. Pekerjaan yang telah dibuat tidak dibatalkan ketika skrip berhenti berjalan.

  • 401: periksa apakah variabel lingkungan telah diatur dan kuncinya valid.
  • 402, atau quota_exceeded pada pekerjaan: periksa apakah saldo kredit (setelah dikurangi utang) mencukupi untuk memenuhi ambang batas awal.
  • 403: periksa anggaran kunci, pengaturan yang diizinkan, serta pemilik sumber daya.
  • 429: baca kode kesalahan bisnis untuk membedakan antara batas laju, antrian penuh, dan anggaran habis.
  • Alamat unggah langsung telah kedaluwarsa atau unggahan gagal: mintalah alamat unggah baru.

Catat X-Request-Id dan jalur permintaan, tetapi jangan pernah mencatat kunci lengkap atau kredensial unggahan. Semua kesalahan dan metode coba ulang terdapat dalam referensi kesalahan . .