ತ್ವರಿತ ಪ್ರಾರಂಭ
ಕೆಳಗಿನ ಪ್ರವಾಹವು ಒಂದು ಫೈಲ್ ಅನ್ನು ಅಪ್ಲೋಡ್ ಮಾಡಲು, ಅನುವಾದ ಕಾರ್ಯವನ್ನು ರಚಿಸಲು ಮತ್ತು ಫಲಿತಾಂಶಗಳನ್ನು ಡೌನ್ಲೋಡ್ ಮಾಡಲು 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: ಪರಿಸರ ಚ biến್ಯಾ ಹೊಂದಿಕೊಂಡಿದೆಯೇ ಮತ್ತು ಕೀಲಿಕೈ ಸಿಂಧುವಾಗಿದೆಯೇ ಎಂದು ಪರಿಶೀಲಿಸಿ.402, ಅಥವಾ ಕೆಲಸದಲ್ಲಿquota_exceeded: ಸಾಲದ ನಂತರದ ಕ್ರೆಡಿಟ್ ಬ್ಯಾಲೆನ್ಸ್ ಪ್ರಾರಂಭದ ಮಿತಿಯನ್ನು ಒಳಗೊಂಡಿದೆಯೇ ಎಂದು ಪರಿಶೀಲಿಸಿ.403: ಕೀಲಿಯ ಬಜೆಟ್, ಅದರ ಅನುಮತಿಸಲಾದ ಸೆಟ್ಟಿಂಗ್ಗಳು ಮತ್ತು ಸಂಪನ್ಮೂಲದ ಮಾಲೀಕರನ್ನು ಪರಿಶೀಲಿಸಿ.429: ದರ ಮಿತಿ, ಪೂರ್ಣ ಕತೆ ಮತ್ತು ಬಳಸಲಾದ ಬಜೆಟ್ ಅನ್ನು ಪ್ರತ್ಯೇಕವಾಗಿ ಗುರುತಿಸಲು ವ್ಯವಹಾರ ದೋಷ ಸಂಕೇತವನ್ನು ಓದಿ.- ನೇರ ಅಪ್ಲೋಡ್ ವಿಳಾಸ ಅವಧಿ ಮೀರಿದೆ ಅಥವಾ ಅಪ್ಲೋಡ್ ವಿಫಲವಾಗಿದೆ: ಹೊಸ ಅಪ್ಲೋಡ್ ವಿಳಾಸವನ್ನು ಕೋರಿ.
X-Request-Id ಮತ್ತು ವಿನಂತಿ ಪಥವನ್ನು ಲಾಗ್ ಮಾಡಿ, ಆದರೆ ಸಂಪೂರ್ಣ ಕೀಲಿಯನ್ನು ಅಥವಾ ಅಪ್ಲೋಡ್ ಗುಪ್ತಚಿಹ್ನೆಗಳನ್ನು ಎಂದಿಗೂ ಲಾಗ್ ಮಾಡಬೇಡಿ. ಎಲ್ಲಾ ದೋಷಗಳು ಮತ್ತು ಪುನರಾವರ್ತನೆ ವಿಧಾನಗಳು ದೋಷ ಉಲ್ಲೇಖ ನಲ್ಲಿವೆ.