跳转到内容

দ্রুত শুরু

নীচের প্রবাহটিতে একটি ফাইল আপলোড করা, একটি অনুবাদ জব তৈরি করা এবং ফলাফলগুলি ডাউনলোড করার জন্য একটি 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: পরিবেশ চলকটি সেট করা আছে এবং কীটি বৈধ কিনা তা যাচাই করুন।
  • 402, অথবা কাজের সময় quota_exceeded: যাচাই করুন যে ক্রেডিট ব্যালেন্স (ঋণ বাদে) শুরুর থ্রেশহোল্ড কভার করে।
  • 403: কী-এর বাজেট, এর অনুমোদিত সেটিংস এবং রিসোর্সের মালিককে পরীক্ষা করুন।
  • 429: একটি রেট লিমিট, একটি সম্পূর্ণ কিউ এবং একটি ব্যবহৃত বাজেটের মধ্যে পার্থক্য করতে বিজনেস এরর কোডটি পড়ুন।
  • সরাসরি আপলোডের ঠিকানা মেয়াদোত্তীর্ণ হয়েছে বা আপলোড ব্যর্থ হয়েছে: একটি নতুন আপলোড ঠিকানা চান।

X-Request-Id এবং অনুরোধের পথটি লগ করুন, তবে সম্পূর্ণ কী বা আপলোড শংসাপত্র কখনও লগ করবেন না। সমস্ত ত্রুটি এবং পুনরায় চেষ্টার পদ্ধতি error reference-এ উল্লেখ করা আছে।

পরবর্তী পদক্ষেপসমূহ

Section titled “পরবর্তী পদক্ষেপসমূহ”