跳转到内容

ಅನುವಾದ ಕಾರ್ಯವನ್ನು ರಚಿಸಿ

POST /api/v1/jobs
Idempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402f
Content-Type: application/json
ಕ್ಷೇತ್ರಪ್ರಕಾರಅವಶ್ಯಕಡೀಫಾಲ್ಟ್ವಿವರಣೆ
document_idstring✅—ದೃಢಪಡಿಸಲಾದ ದಾಖಲೆಯ ಐಡಿ
target_langstring✅—ಗುರಿ ಭಾಷೆಯ ಕೋಡ್
source_langstring—ಸ್ವಯಂ-ಗುರುತಿಸುಮೂಲ ಭಾಷೆಯ ಕೋಡ್
enginestring—xr-397bಅನುವಾದ ಸೆಟ್ಟಿಂಗ್ ಐಡಿ, ನೋಡಿ ಅನುವಾದ ಸೆಟ್ಟಿಂಗ್‌ಗಳು
output_modestring—bilingualsingle ಅಥವಾ bilingual
glossary_idstring——ಈ ಖಾತೆಯ ಪದಸಂಗ್ರಹ ಗುರುತು. ಪದಸಂಗ್ರಹಗಳು ಪಾವತಿಸಿದ ಖಾತೆಗಳಿಗಾಗಿ (ಕನಿಷ್ಠ ಒಂದು ಯಶಸ್ವಿ ಪಾವತಿ) ಇರುತ್ತವೆ; ಪಾವತಿಸದ ಖಾತೆಯಿಂದ ಒಮ್ಮೆ ಕಳುಹಿಸಿದರೆ 403 ಸಿಗುತ್ತದೆ
include_imagesಬೂಲಿಯನ್—falseಅಲ್ಲದೆ, ದಾಖಲೆಯ ಚಿತ್ರಗಳಲ್ಲಿನ ಪಠ್ಯವನ್ನು ಸಹ ಅನುವಾದಿಸಿ.
context_translationಬೂಲಿಯನ್—falseಸಂದರ್ಭ ವರ್ಧನೆಯನ್ನು ಸಕ್ರಿಯಗೊಳಿಸಿ
style_presetstring——ಶೈಲಿ ಪೂರ್ವನಿಯಮಿತ

ಸೃಷ್ಟಿಸಲಾದ ಕಾರ್ಯವು ಸರದಿ ಸಾಲಿಗೆ ಸೇರುತ್ತದೆ. ಪ್ರತಿ ಖಾತೆಯು ಏಕಕಾಲಕ್ಕೆ 5 ಫೈಲ್‌ಗಳನ್ನು ಪ್ರಕ್ರಿಯೆಗೊಳಿಸುತ್ತದೆ; ಹೆಚ್ಚಿನ ಕಾರ್ಯಗಳು ಸೃಷ್ಟಿಯಾಗುತ್ತಲೇ ಇರುತ್ತವೆ ಮತ್ತು ಸರದಿ ಸಾಲು ಸ್ವಯಂಚಾಲಿತವಾಗಿ, ಹಿಂದಿನ ಕಾರ್ಯಗಳು ಪೂರ್ಣಗೊಳ್ಳುತ್ತಿದ್ದಂತೆ ಪ್ರಾರಂಭವಾಗುತ್ತದೆ. ಒಂದು ಕಾರ್ಯವು ಕಾಯುತ್ತಿರುವಾಗ, its stage_message ಎಷ್ಟು ಕಾರ್ಯಗಳು ಮುಂದಿವೆ ಎಂಬುದನ್ನು ತಿಳಿಸುತ್ತದೆ.

ಕೆಲಸ ಪ್ರಾರಂಭವಾಗುವ ಮೊದಲು, ಬ್ಯಾಲೆನ್ಸ್ ಅನ್ನು ಥ್ರೆಶೋಲ್ಡ್‌ನೊಂದಿಗೆ ಪರಿಶೀಲಿಸಲಾಗುತ್ತದೆ: PDF ಗೆ “ಪುಟಗಳು × 2 ಕ್ರೆಡಿಟ್‌ಗಳ” ಮೇಲ್ಪಟ್ಟ ಬ್ಯಾಲೆನ್ಸ್ ಅಗತ್ಯ; ಇತರ ಫಾರ್ಮ್ಯಾಟ್‌ಗಳು ಮೂಲ ಪಠ್ಯದ ಉದ್ದವನ್ನು ಆಧರಿಸಿ, ಕನಿಷ್ಠ 2 ಕ್ರೆಡಿಟ್‌ಗಳು ಬೇಕಾಗುತ್ತವೆ. ಒಂದು ವೇಳೆ ಬ್ಯಾಲೆನ್ಸ್ ಫೈಲ್ ಪ್ರಾರಂಭಿಸಲು ಸಾಧ್ಯವಾಗದಿದ್ದರೆ, ಆ ಕೆಲಸ status=failed ಮತ್ತು quota_exceeded=true ಜೊತೆಗೆ ಮುಕ್ತಾಯಗೊಳ್ಳುತ್ತದೆ, ಯಾವುದೇ ಶುಲ್ಕ ವಿಧಿಸಲಾಗುವುದಿಲ್ಲ ಮತ್ತು ಇತರ ಕೆಲಸಗಳ ಮೇಲೆ ಯಾವುದೇ ಪರಿಣಾಮ ಬೀರುವುದಿಲ್ಲ. ಒಂದು ಕೆಲಸ ಮುಕ್ತಾಯಗೊಂಡಾಗ, ನಿಖರವಾದ ಬಳಕೆಯ ಮೇಲೆ ಶುಲ್ಕ ವಿಧಿಸಲಾಗುತ್ತದೆ; ವೆಚ್ಚವು ಬ್ಯಾಲೆನ್ಸ್‌ಅನ್ನು ಮೀರಿದರೆ, ಬ್ಯಾಲೆನ್ಸ್ ಋಣಾತ್ಮಕವಾಗುತ್ತದೆ, ನಂತರ ಬರುವ ಕ್ರೆಡಿಟ್‌ಗಳು ಮೊದಲು ಸಾಲವನ್ನು ತೀರಿಸುತ್ತವೆ, ಮತ್ತು ಬ್ಯಾಲೆನ್ಸ್ ಋಣಾತ್ಮಕವಾಗಿರುವಾಗ ಹೊಸ ಕೆಲಸಗಳನ್ನು ಪ್ರಾರಂಭಿಸಲು ಸಾಧ್ಯವಿಲ್ಲ, ಆದ್ದರಿಂದ ರಿಚಾರ್ಜ್ ಮಾಡಿ. ಕ್ರೆಡಿಟ್‌ಗಳು ಮತ್ತು ಬಳಕೆಯನ್ನು ನೋಡಿ .

Terminal window
curl --fail-with-body -X POST https://omnidoc.top/api/v1/jobs \
-H "X-API-Key: $OMNIDOC_API_KEY" \
-H "Idempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402f" \
-H "Content-Type: application/json" \
-d '{"document_id":"4q8mx2q9z1k7p6ra","target_lang":"en"}'

ಪ್ರತಿಕ್ರಿಯೆ 201 (ಸರ್ವರ್‌ನ stage_message ಚೀನೀ ಭಾಷೆಯಲ್ಲಿದೆ):

{
"id": "q3f8s6c2a9m1k4tx",
"document_id": "4q8mx2q9z1k7p6ra",
"source_lang": null,
"target_lang": "en",
"engine": "xr-397b",
"status": "pending",
"stage": "queued",
"stage_progress": 0,
"stage_message": "排队中",
"time_cost": 0,
"error_msg": null,
"quota_exceeded": false,
"queue_position": null,
"created_at": "2026-10-01T12:01:00Z",
"updated_at": "2026-10-01T12:01:00Z"
}
ಸ್ಥಿತಿಕಾರಣ
403ಕೀಲಿಯು ಆಯ್ಕೆಮಾಡಿದ ಸೆಟ್ಟಿಂಗ್ ಅನ್ನು ಅನುಮತಿಸುವುದಿಲ್ಲ, ಅಥವಾ ಪಾವತಿಸದ ಖಾತೆ glossary_id ಅನ್ನು ಕಳುಹಿಸಿದೆ
404ದಾಖಲೆ ಅಥವಾ ಪದಕೋಶ ಅಸ್ತಿತ್ವದಲ್ಲಿಲ್ಲ, ಅದನ್ನು ಅಳಿಸಲಾಗಿದೆ ಅಥವಾ ಇದು ಬೇರೆ ಖಾತೆಗೆ ಸೇರಿದೆ
415ಫೈಲ್ ಸ್ವರೂಪವನ್ನು ಅನುವಾದಿಸಲಾಗುವುದಿಲ್ಲ
422ಫೈಲ್ ಖಾಲಿಯಿದೆ, ಅದರಲ್ಲಿ ಅನುವಾದಿಸಬಹುದಾದ ಪಠ್ಯವಿಲ್ಲ ಅಥವಾ ನಿಯತಾಂಕವು ಅಮಾನ್ಯವಾಗಿದೆ
429ಅತಿಯಾದ ವಿನಂತಿಗಳು, ಅಥವಾ ಕ್ಯೂ ತುಂಬಿದೆ; Retry-After ನಂತರ ಪುನಃ ಪ್ರಯತ್ನಿಸಿ

Idempotency-Key ಐಚ್ಛಿಕವಾಗಿದ್ದರೂ, ಪ್ರತಿ ಸಲ್ಲಿಕೆಗೆ ಶಿಫಾರಸು ಮಾಡಲಾಗಿದೆ. ಕೀಲಿಯು 1–128 ಗೋಚರ ಏಸ್ಸಿಐಎಸ್‌ಐ ಅಕ್ಷರಗಳನ್ನು ಒಳಗೊಂಡಿರುತ್ತದೆ ಮತ್ತು ಒಂದೇ ಪ್ರಮಾಣಪತ್ರಕ್ಕಾಗಿ ಅನಿರ್ದಿಷ್ಟಕಾಲದವರೆಗೆ ಮಾನ್ಯವಾಗಿರುತ್ತದೆ:

  • ಅದೇ ಕೀ, ಅದೇ ದೇಹ: ಮೂಲ ಕಾರ್ಯವನ್ನು (ವಿಫಲವಾದದ್ದನ್ನು ಸಹ) ಹಿಂತಿರುಗಿಸುತ್ತದೆ; ಯಾವುದನ್ನೂ ಎರಡು ಬಾರಿ ರಚಿಸಲಾಗುವುದಿಲ್ಲ ಅಥವಾ ಶುಲ್ಕ ವಿಧಿಸಲಾಗುವುದಿಲ್ಲ.
  • ಒಂದೇ ಕೀ, ವಿಭಿನ್ನ ದೇಹ: 409 (idempotency_request_conflict).
  • ಮೂಲ ಕಾರ್ಯವನ್ನು ಅಳಿಸಲಾಗಿದೆ: 410 (idempotency_job_gone).

ಪ್ರತಿ ಹೊಸ ಸಲ್ಲಿಕೆಗೆ ಹೊಸ UUID ಅನ್ನು ಬಳಸಿ, ಮತ್ತು ಅದೇ ಸಲ್ಲಿಕೆಯನ್ನು ಪುನಃ ಪ್ರಯತ್ನಿಸುವಾಗ ಮಾತ್ರ ಮೂಲ ಕೀಲಿಯನ್ನು ಮರುಬಳಕೆ ಮಾಡಿ.