跳转到内容

झटपट सुरूवात

खालील प्रवाह एक फाइल अपलोड करण्यासाठी, अनुवाद कार्य तयार करण्यासाठी आणि निकाल डाउनलोड करण्यासाठी 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. अपलोडची पुष्टी करा आणि दस्तऐवज ID मिळवा

    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)

तुम्हाला काय मिळते

Section titled “तुम्हाला काय मिळते”

स्क्रिप्ट प्रथम job_id छापते. कार्य यशस्वीरित्या पूर्ण झाल्यावर, निकाल सध्याच्या डिरेक्टरीमध्ये डाउनलोड होतात. कार्य completed किंवा failed गाठताच पोलिंग थांबते.

किती वेळ लागतो हे फाइलचा आकार आणि कतारवर अवलंबून असते. प्रोडक्शनमध्ये, मर्यादित पोलिंगऐवजी webhook किंवा SSE वापरा.

उदाहरण निर्मिती विनंत्या स्वयंचलितपणे पुन्हा प्रयत्न करत नाही. नेटवर्क वेळमर्यादा संपल्यानंतर, जॉब आयडी, इडेम्पोटन्सी की आणि विनंती बॉडी ठेवा आणि प्रथम स्थिती तपासा. स्क्रिप्ट संपल्यावर निर्माण केलेला जॉब रद्द होत नाही.

जेव्हा काही अयशस्वी होते

Section titled “जेव्हा काही अयशस्वी होते”
  • 401: तपासा की पर्यावरण च biếnिबल सेट आहे आणि की वैध आहे.
  • 402, किंवा जॉबवर quota_exceeded: तपासा की क्रेडिट शिल्लक (कर्जानंतर) सुरुवातीची थ्रेशोल्ड भरून काढते का.
  • 403: कीच्या बजेट, त्याच्या परवानगी दिलेल्या सेटिंग्ज आणि संसाधनाचे मालक कोण आहेत हे तपासा.
  • 429: दर मर्यादा, पूर्ण कतार आणि संपलेले बजेट यांमध्ये फरक सांगण्यासाठी व्यवसाय त्रुटी कोड वाचा.
  • थेट अपलोड पत्ता कालबाह्य झाला आहे किंवा अपलोड अयशस्वी झाले आहे: नवीन अपलोड पत्ता मागवा.

X-Request-Id आणि विनंती मार्ग पथ लॉग करा, परंतु संपूर्ण की किंवा अपलोड क्रेडेन्शियल्स लॉग करू नका. सर्व त्रुटी आणि पुन्हा प्रयत्नांचे पद्धत error reference मध्ये दिलेल्या आहेत.