跳转到内容

ತ್ವರಿತ ಪ್ರಾರಂಭ

ಕೆಳಗಿನ ಪ್ರವಾಹವು ಒಂದು ಫೈಲ್ ಅನ್ನು ಅಪ್‌ಲೋಡ್ ಮಾಡಲು, ಅನುವಾದ ಕಾರ್ಯವನ್ನು ರಚಿಸಲು ಮತ್ತು ಫಲಿತಾಂಶಗಳನ್ನು ಡೌನ್‌ಲೋಡ್ ಮಾಡಲು 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 ಅನ್ನು ಬಳಸಿ.

ಉದಾಹರಣೆಯು ರಚನಾ ವಿನಂತಿಗಳನ್ನು ಸ್ವಯಂಚಾಲಿತವಾಗಿ ಪುನಃ ಪ್ರಯತ್ನಿಸುವುದಿಲ್ಲ. ನೆಟ್‌ವರ್ಕ್ ಸಮಯಾವಧಿ ಮೀರಿದ ನಂತರ, ಕೆಲಸದ ಐಡಿ, ಇಡಂಪೋಟೆನ್ಸಿ ಕೀಲಿ ಮತ್ತು ವಿನಂತಿ ದೇಹವನ್ನು ಉಳಿಸಿಕೊಂಡು, ಮೊದಲು ಸ್ಥಿತಿಯನ್ನು ಪರಿಶೀಲಿಸಿ. ಸ್ಕ್ರಿಪ್ಟ್ ನಿರ್ಗಮಿಸಿದಾಗ, ರಚಿಸಲಾದ ಕೆಲಸವನ್ನು ರದ್ದು ಮಾಡಲಾಗುವುದಿಲ್ಲ.

ಯಾವುದಾದರೂ ವೈಫಲ್ಯ ಸಂಭವಿಸಿದಾಗ

Section titled “ಯಾವುದಾದರೂ ವೈಫಲ್ಯ ಸಂಭವಿಸಿದಾಗ”
  • 401: ಪರಿಸರ ಚ biến್ಯಾ ಹೊಂದಿಕೊಂಡಿದೆಯೇ ಮತ್ತು ಕೀಲಿಕೈ ಸಿಂಧುವಾಗಿದೆಯೇ ಎಂದು ಪರಿಶೀಲಿಸಿ.
  • 402, ಅಥವಾ ಕೆಲಸದಲ್ಲಿ quota_exceeded: ಸಾಲದ ನಂತರದ ಕ್ರೆಡಿಟ್ ಬ್ಯಾಲೆನ್ಸ್ ಪ್ರಾರಂಭದ ಮಿತಿಯನ್ನು ಒಳಗೊಂಡಿದೆಯೇ ಎಂದು ಪರಿಶೀಲಿಸಿ.
  • 403: ಕೀಲಿಯ ಬಜೆಟ್, ಅದರ ಅನುಮತಿಸಲಾದ ಸೆಟ್ಟಿಂಗ್‌ಗಳು ಮತ್ತು ಸಂಪನ್ಮೂಲದ ಮಾಲೀಕರನ್ನು ಪರಿಶೀಲಿಸಿ.
  • 429: ದರ ಮಿತಿ, ಪೂರ್ಣ ಕತೆ ಮತ್ತು ಬಳಸಲಾದ ಬಜೆಟ್ ಅನ್ನು ಪ್ರತ್ಯೇಕವಾಗಿ ಗುರುತಿಸಲು ವ್ಯವಹಾರ ದೋಷ ಸಂಕೇತವನ್ನು ಓದಿ.
  • ನೇರ ಅಪ್‌ಲೋಡ್ ವಿಳಾಸ ಅವಧಿ ಮೀರಿದೆ ಅಥವಾ ಅಪ್‌ಲೋಡ್ ವಿಫಲವಾಗಿದೆ: ಹೊಸ ಅಪ್‌ಲೋಡ್ ವಿಳಾಸವನ್ನು ಕೋರಿ.

X-Request-Id ಮತ್ತು ವಿನಂತಿ ಪಥವನ್ನು ಲಾಗ್ ಮಾಡಿ, ಆದರೆ ಸಂಪೂರ್ಣ ಕೀಲಿಯನ್ನು ಅಥವಾ ಅಪ್‌ಲೋಡ್ ಗುಪ್ತಚಿಹ್ನೆಗಳನ್ನು ಎಂದಿಗೂ ಲಾಗ್ ಮಾಡಬೇಡಿ. ಎಲ್ಲಾ ದೋಷಗಳು ಮತ್ತು ಪುನರಾವರ್ತನೆ ವಿಧಾನಗಳು ದೋಷ ಉಲ್ಲೇಖ ನಲ್ಲಿವೆ.