দ্রুত শুরু
নীচের প্রবাহটিতে একটি ফাইল আপলোড করা, একটি অনুবাদ জব তৈরি করা এবং ফলাফলগুলি ডাউনলোড করার জন্য একটি API কী ব্যবহার করা হয়েছে।
-
ক্রেডেনশিয়াল এবং ফাইলটি প্রস্তুত করুন
Terminal window export OMNIDOC_API_KEY="sk_your_key"BASE="https://omnidoc.top/api/v1"FILE="report.docx"SIZE=$(wc -c < "$FILE" | tr -d ' ')import uuidfrom pathlib import Pathimport requestsAPI_KEY = "sk_your_key"BASE = "https://omnidoc.top/api/v1"FILE = Path("report.docx")H = {"X-API-Key": API_KEY}import axios from 'axios';import fs from 'node:fs';import path from 'node:path';const API_KEY = 'sk_your_key';const BASE = 'https://omnidoc.top/api/v1';const filePath = 'report.docx';const apiHeaders = { 'X-API-Key': API_KEY }; -
একটি ঠিকানা অনুরোধ করুন এবং ফাইলটি আপলোড করুন
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"presign = requests.post(f"{BASE}/upload/presign",headers=H,json={"filename": FILE.name,"file_size": FILE.stat().st_size,},timeout=20,)presign.raise_for_status()ticket = presign.json()with FILE.open("rb") as stream:put_headers = {**ticket["upload_headers"],"Content-Length": str(FILE.stat().st_size),}uploaded = requests.put(ticket["upload_url"], headers=put_headers, data=stream, timeout=300)uploaded.raise_for_status()const stat = fs.statSync(filePath);const { data: ticket } = await axios.post(`${BASE}/upload/presign`,{filename: path.basename(filePath),file_size: stat.size,},{ headers: apiHeaders });await axios.put(ticket.upload_url, fs.createReadStream(filePath), {headers: { ...ticket.upload_headers, 'Content-Length': stat.size },maxBodyLength: Infinity,}); -
আপলোড নিশ্চিত করুন এবং ডকুমেন্ট আইডি পান
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')finalized = requests.post(f"{BASE}/upload/finalize",headers=H,json={"finalize_token": ticket["finalize_token"]},timeout=30,)finalized.raise_for_status()document_id = finalized.json()["document"]["id"]const { data: finalized } = await axios.post(`${BASE}/upload/finalize`,{ finalize_token: ticket.finalize_token },{ headers: apiHeaders });const documentId = finalized.document.id; -
অনুবাদ কাজটি তৈরি করুন
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')job_response = requests.post(f"{BASE}/jobs",headers={**H, "Idempotency-Key": str(uuid.uuid4())},json={"document_id": document_id, "target_lang": "en"},timeout=30,)job_response.raise_for_status()job_id = job_response.json()["id"]const { data: job } = await axios.post(`${BASE}/jobs`,{ document_id: documentId, target_lang: 'en' },{ headers: { ...apiHeaders, 'Idempotency-Key': crypto.randomUUID() } });const jobId = job.id; -
সমাপ্তির জন্য অপেক্ষা করুন এবং ডাউনলোড করুন
import reimport timefrom urllib.parse import unquotewhile 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"}:breaktime.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 = fallbacksafe_name = Path(name).name or fallbackPath(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 এবং অনুরোধের পথটি লগ করুন, তবে সম্পূর্ণ কী বা আপলোড শংসাপত্র কখনও লগ করবেন না। সমস্ত ত্রুটি এবং পুনরায় চেষ্টার পদ্ধতি error reference-এ উল্লেখ করা আছে।