跳转到内容

പെട്ടെന്നുള്ള തുടക്കം

ഒരു ഫയൽ അപ്‌ലോഡ് ചെയ്യാനും വിവർത്തന ജോലി സൃഷ്ടിക്കാനും ഫലങ്ങൾ ഡൗൺലോഡ് ചെയ്യാനും ചുവടെയുള്ള ഫ്ലോ ഒരു 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)

നിങ്ങൾക്ക് എന്ത് ലഭിക്കും

Section titled “നിങ്ങൾക്ക് എന്ത് ലഭിക്കും”

സ്ക്രിപ്റ്റ് ആദ്യം പ്രിൻ്റ് ചെയ്യുന്നത് job_id ആണ്. ജോലി വിജയിക്കുമ്പോൾ, ഫലങ്ങൾ നിലവിലെ ഡയറക്‌ടറിയിലേക്ക് ഡൗൺലോഡ് ചെയ്യപ്പെടും. ജോലി completed അല്ലെങ്കിൽ failed എത്തുമ്പോൾ പോളിംഗ് നിർത്തുന്നു.

ഇത് എത്ര സമയമെടുക്കും എന്നത് ഫയലിൻ്റെ വലുപ്പത്തെയും ക്യൂവിനെയും ആശ്രയിച്ചിരിക്കുന്നു. ഉൽപ്പാദനത്തിൽ, പരിധിയില്ലാതെ വോട്ടെടുപ്പിന് പകരം webhook അല്ലെങ്കിൽ SSE ഉപയോഗിക്കുക.

അഭ്യർത്ഥനകൾ സ്വയമേവ സൃഷ്ടിക്കാൻ ഉദാഹരണം വീണ്ടും ശ്രമിക്കുന്നില്ല. നെറ്റ്‌വർക്ക് കാലഹരണപ്പെട്ടതിന് ശേഷം, ജോലി ഐഡി, ഐഡമ്പോട്ടൻസി കീ, അഭ്യർത്ഥന ബോഡി എന്നിവ സൂക്ഷിക്കുക, ആദ്യം സ്റ്റാറ്റസ് പരിശോധിക്കുക. സൃഷ്‌ടിച്ച ജോലി സ്‌ക്രിപ്‌റ്റിൽ നിന്ന് പുറത്തുകടക്കുമ്പോൾ റദ്ദാക്കപ്പെടുന്നില്ല.

എന്തെങ്കിലും പരാജയപ്പെടുമ്പോൾ

Section titled “എന്തെങ്കിലും പരാജയപ്പെടുമ്പോൾ”
  • 401: എൻവയോൺമെൻ്റ് വേരിയബിൾ സജ്ജീകരിച്ചിട്ടുണ്ടെന്നും കീ സാധുവാണോയെന്നും പരിശോധിക്കുക.
  • ജോലിയിൽ 402, അല്ലെങ്കിൽ quota_exceeded: ക്രെഡിറ്റ് ബാലൻസ് (കടത്തിന് ശേഷം) ആരംഭ പരിധി ഉൾക്കൊള്ളുന്നുണ്ടോയെന്ന് പരിശോധിക്കുക.
  • 403: കീയുടെ ബജറ്റ്, അതിൻ്റെ അനുവദനീയമായ ക്രമീകരണങ്ങൾ, ഉറവിടം ആരുടേത് എന്നിവ പരിശോധിക്കുക.
  • 429: നിരക്ക് പരിധി, പൂർണ്ണ ക്യൂ, ഉപയോഗിച്ച ബജറ്റ് എന്നിവയെ കുറിച്ച് പറയാൻ ബിസിനസ് പിശക് കോഡ് വായിക്കുക.
  • നേരിട്ടുള്ള അപ്‌ലോഡ് വിലാസം കാലഹരണപ്പെട്ടു അല്ലെങ്കിൽ അപ്‌ലോഡ് പരാജയപ്പെട്ടു: ഒരു പുതിയ അപ്‌ലോഡ് വിലാസം അഭ്യർത്ഥിക്കുക.

X-Request-Id, അഭ്യർത്ഥന പാത എന്നിവ ലോഗ് ചെയ്യുക, പക്ഷേ ഒരിക്കലും പൂർണ്ണ കീ അല്ലെങ്കിൽ ക്രെഡൻഷ്യലുകൾ അപ്‌ലോഡ് ചെയ്യുക. എല്ലാ പിശകുകളും വീണ്ടും ശ്രമിക്കുന്നതിനുള്ള രീതികളും പിശക് റഫറൻസ് എന്നതിലാണ്.

അടുത്ത ഘട്ടങ്ങൾ

Section titled “അടുത്ത ഘട്ടങ്ങൾ”