跳转到内容

వేగవంతమైన ప్రారంభం

క్రింది ప్రవాహం 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 ను ఉపయోగించండి.

ఉదాహరణ సృష్టి అభ్యర్థనలను స్వయంచాలకంగా పునఃప్రయత్నించదు. నెట్‌వర్క్ టైమ్‌ఔట్ తర్వాత, జాబ్ ID, ఇడెంపోటెన్సీ కీ మరియు అభ్యర్థన శరీరాన్ని నిలుపుకొని, మొదట స్థితిని తనిఖీ చేయండి. స్క్రిప్ట్ ముగిసినప్పుడు సృష్టించబడిన జాబ్ రద్దు చేయబడదు.

ఏదైనా విఫలమైనప్పుడు

Section titled “ఏదైనా విఫలమైనప్పుడు”
  • 401: పర్యావరణ వేరియబుల్ సెట్ చేయబడిందో మరియు కీ చెల్లుబాటు అయ్యేదో తనిఖీ చేయండి.
  • 402, లేదా జాబ్‌లో quota_exceeded: క్రెడిట్ బ్యాలెన్స్ (అప్పు తర్వాత) ప్రారంభ థ్రెషోల్డ్‌ను కవర్ చేస్తుందో లేదో తనిఖీ చేయండి.
  • 403: కీ యొక్క బడ్జెట్, అనుమతించబడిన సెట్టింగ్‌లు మరియు వనరు యొక్క యజమానిని తనిఖీ చేయండి.
  • 429: రేట్ లిమిట్, ఫుల్ క్యూ మరియు వాడిన బడ్జెట్‌ను వేరు చేయడానికి వ్యాపార దోష కోడ్‌ను చదవండి.
  • ప్రత్యక్ష-అప్‌లోడ్ చిరునామా గడువు ముగిసింది లేదా అప్‌లోడ్ విఫలమైంది: కొత్త అప్‌లోడ్ చిరునామాను అభ్యర్థించండి.

X-Request-Id మరియు అభ్యర్థన మార్గాన్ని లాగ్ చేయండి, కానీ పూర్తి కీ లేదా అప్‌లోడ్ ఆధారాలను ఎప్పుడూ లాగ్ చేయకండి. అన్ని దోషాలు మరియు పునఃప్రయత్న పద్ధతులు దోష సూచనలో ఉన్నాయి .