விரைவான தொடக்கம்
கீழே உள்ள ஓட்டம், ஒரு கோப்பைப் பதிவேற்றவும், மொழிபெயர்ப்புப் பணியை உருவாக்கவும் மற்றும் முடிவுகளைப் பதிவிறக்கவும் 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,}); -
பதிவேற்றத்தை உறுதிப்படுத்தி ஆவண ID-ஐப் பெறுங்கள்
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 $ போன்ற உள்ளீட்டு LaTeX கணிதத்தை சிதைக்காமல் பாதுகாக்கவும்; ஒவ்வொரு சூத்திரத்தையும் மூலத்தில் உள்ளது போலவே பராமரிக்கவும்.- நேரடி பதிவேற்ற முகவரி காலாவதியானது அல்லது பதிவேற்றம் தோல்வியடைந்தது: புதிய பதிவேற்ற முகவரியைக் கோரவும்.
X-Request-Id மற்றும் கோரிக்கை பாதையை பதிவு செய்யவும், ஆனால் முழு தடையையோ அல்லது பதிவேற்ற சான்றுகளையோ ஒருபோதும் பதிவு செய்ய வேண்டாம். அனைத்து பிழைகள் மற்றும் மீண்டும் முயற்சி முறைகளும் error reference இல் உள்ளன.