ಅನುವಾದ ಕಾರ್ಯವನ್ನು ರಚಿಸಿ
POST /api/v1/jobsIdempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402fContent-Type: application/jsonವಿನಂತಿ
Section titled “ವಿನಂತಿ”| ಕ್ಷೇತ್ರ | ಪ್ರಕಾರ | ಅವಶ್ಯಕ | ಡೀಫಾಲ್ಟ್ | ವಿವರಣೆ |
|---|---|---|---|---|
document_id | string | ✅ | — | ದೃಢಪಡಿಸಲಾದ ದಾಖಲೆಯ ಐಡಿ |
target_lang | string | ✅ | — | ಗುರಿ ಭಾಷೆಯ ಕೋಡ್ |
source_lang | string | — | ಸ್ವಯಂ-ಗುರುತಿಸು | ಮೂಲ ಭಾಷೆಯ ಕೋಡ್ |
engine | string | — | xr-397b | ಅನುವಾದ ಸೆಟ್ಟಿಂಗ್ ಐಡಿ, ನೋಡಿ ಅನುವಾದ ಸೆಟ್ಟಿಂಗ್ಗಳು |
output_mode | string | — | bilingual | single ಅಥವಾ bilingual |
glossary_id | string | — | — | ಈ ಖಾತೆಯ ಪದಸಂಗ್ರಹ ಗುರುತು. ಪದಸಂಗ್ರಹಗಳು ಪಾವತಿಸಿದ ಖಾತೆಗಳಿಗಾಗಿ (ಕನಿಷ್ಠ ಒಂದು ಯಶಸ್ವಿ ಪಾವತಿ) ಇರುತ್ತವೆ; ಪಾವತಿಸದ ಖಾತೆಯಿಂದ ಒಮ್ಮೆ ಕಳುಹಿಸಿದರೆ 403 ಸಿಗುತ್ತದೆ |
include_images | ಬೂಲಿಯನ್ | — | false | ಅಲ್ಲದೆ, ದಾಖಲೆಯ ಚಿತ್ರಗಳಲ್ಲಿನ ಪಠ್ಯವನ್ನು ಸಹ ಅನುವಾದಿಸಿ. |
context_translation | ಬೂಲಿಯನ್ | — | false | ಸಂದರ್ಭ ವರ್ಧನೆಯನ್ನು ಸಕ್ರಿಯಗೊಳಿಸಿ |
style_preset | string | — | — | ಶೈಲಿ ಪೂರ್ವನಿಯಮಿತ |
ಸೃಷ್ಟಿಸಲಾದ ಕಾರ್ಯವು ಸರದಿ ಸಾಲಿಗೆ ಸೇರುತ್ತದೆ. ಪ್ರತಿ ಖಾತೆಯು ಏಕಕಾಲಕ್ಕೆ 5 ಫೈಲ್ಗಳನ್ನು ಪ್ರಕ್ರಿಯೆಗೊಳಿಸುತ್ತದೆ; ಹೆಚ್ಚಿನ ಕಾರ್ಯಗಳು ಸೃಷ್ಟಿಯಾಗುತ್ತಲೇ ಇರುತ್ತವೆ ಮತ್ತು ಸರದಿ ಸಾಲು ಸ್ವಯಂಚಾಲಿತವಾಗಿ, ಹಿಂದಿನ ಕಾರ್ಯಗಳು ಪೂರ್ಣಗೊಳ್ಳುತ್ತಿದ್ದಂತೆ ಪ್ರಾರಂಭವಾಗುತ್ತದೆ. ಒಂದು ಕಾರ್ಯವು ಕಾಯುತ್ತಿರುವಾಗ, its stage_message ಎಷ್ಟು ಕಾರ್ಯಗಳು ಮುಂದಿವೆ ಎಂಬುದನ್ನು ತಿಳಿಸುತ್ತದೆ.
ಕೆಲಸ ಪ್ರಾರಂಭವಾಗುವ ಮೊದಲು, ಬ್ಯಾಲೆನ್ಸ್ ಅನ್ನು ಥ್ರೆಶೋಲ್ಡ್ನೊಂದಿಗೆ ಪರಿಶೀಲಿಸಲಾಗುತ್ತದೆ: PDF ಗೆ “ಪುಟಗಳು × 2 ಕ್ರೆಡಿಟ್ಗಳ” ಮೇಲ್ಪಟ್ಟ ಬ್ಯಾಲೆನ್ಸ್ ಅಗತ್ಯ; ಇತರ ಫಾರ್ಮ್ಯಾಟ್ಗಳು ಮೂಲ ಪಠ್ಯದ ಉದ್ದವನ್ನು ಆಧರಿಸಿ, ಕನಿಷ್ಠ 2 ಕ್ರೆಡಿಟ್ಗಳು ಬೇಕಾಗುತ್ತವೆ. ಒಂದು ವೇಳೆ ಬ್ಯಾಲೆನ್ಸ್ ಫೈಲ್ ಪ್ರಾರಂಭಿಸಲು ಸಾಧ್ಯವಾಗದಿದ್ದರೆ, ಆ ಕೆಲಸ status=failed ಮತ್ತು quota_exceeded=true ಜೊತೆಗೆ ಮುಕ್ತಾಯಗೊಳ್ಳುತ್ತದೆ, ಯಾವುದೇ ಶುಲ್ಕ ವಿಧಿಸಲಾಗುವುದಿಲ್ಲ ಮತ್ತು ಇತರ ಕೆಲಸಗಳ ಮೇಲೆ ಯಾವುದೇ ಪರಿಣಾಮ ಬೀರುವುದಿಲ್ಲ. ಒಂದು ಕೆಲಸ ಮುಕ್ತಾಯಗೊಂಡಾಗ, ನಿಖರವಾದ ಬಳಕೆಯ ಮೇಲೆ ಶುಲ್ಕ ವಿಧಿಸಲಾಗುತ್ತದೆ; ವೆಚ್ಚವು ಬ್ಯಾಲೆನ್ಸ್ಅನ್ನು ಮೀರಿದರೆ, ಬ್ಯಾಲೆನ್ಸ್ ಋಣಾತ್ಮಕವಾಗುತ್ತದೆ, ನಂತರ ಬರುವ ಕ್ರೆಡಿಟ್ಗಳು ಮೊದಲು ಸಾಲವನ್ನು ತೀರಿಸುತ್ತವೆ, ಮತ್ತು ಬ್ಯಾಲೆನ್ಸ್ ಋಣಾತ್ಮಕವಾಗಿರುವಾಗ ಹೊಸ ಕೆಲಸಗಳನ್ನು ಪ್ರಾರಂಭಿಸಲು ಸಾಧ್ಯವಿಲ್ಲ, ಆದ್ದರಿಂದ ರಿಚಾರ್ಜ್ ಮಾಡಿ. ಕ್ರೆಡಿಟ್ಗಳು ಮತ್ತು ಬಳಕೆಯನ್ನು ನೋಡಿ .
ಉದಾಹರಣೆ
Section titled “ಉದಾಹರಣೆ”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"}ತಪ್ಪುಗಳು
Section titled “ತಪ್ಪುಗಳು”| ಸ್ಥಿತಿ | ಕಾರಣ |
|---|---|
403 | ಕೀಲಿಯು ಆಯ್ಕೆಮಾಡಿದ ಸೆಟ್ಟಿಂಗ್ ಅನ್ನು ಅನುಮತಿಸುವುದಿಲ್ಲ, ಅಥವಾ ಪಾವತಿಸದ ಖಾತೆ glossary_id ಅನ್ನು ಕಳುಹಿಸಿದೆ |
404 | ದಾಖಲೆ ಅಥವಾ ಪದಕೋಶ ಅಸ್ತಿತ್ವದಲ್ಲಿಲ್ಲ, ಅದನ್ನು ಅಳಿಸಲಾಗಿದೆ ಅಥವಾ ಇದು ಬೇರೆ ಖಾತೆಗೆ ಸೇರಿದೆ |
415 | ಫೈಲ್ ಸ್ವರೂಪವನ್ನು ಅನುವಾದಿಸಲಾಗುವುದಿಲ್ಲ |
422 | ಫೈಲ್ ಖಾಲಿಯಿದೆ, ಅದರಲ್ಲಿ ಅನುವಾದಿಸಬಹುದಾದ ಪಠ್ಯವಿಲ್ಲ ಅಥವಾ ನಿಯತಾಂಕವು ಅಮಾನ್ಯವಾಗಿದೆ |
429 | ಅತಿಯಾದ ವಿನಂತಿಗಳು, ಅಥವಾ ಕ್ಯೂ ತುಂಬಿದೆ; Retry-After ನಂತರ ಪುನಃ ಪ್ರಯತ್ನಿಸಿ |
ಇಡೆಂಪೋಟೆನ್ಸಿ
Section titled “ಇಡೆಂಪೋಟೆನ್ಸಿ”Idempotency-Key ಐಚ್ಛಿಕವಾಗಿದ್ದರೂ, ಪ್ರತಿ ಸಲ್ಲಿಕೆಗೆ ಶಿಫಾರಸು ಮಾಡಲಾಗಿದೆ. ಕೀಲಿಯು 1–128 ಗೋಚರ ಏಸ್ಸಿಐಎಸ್ಐ ಅಕ್ಷರಗಳನ್ನು ಒಳಗೊಂಡಿರುತ್ತದೆ ಮತ್ತು ಒಂದೇ ಪ್ರಮಾಣಪತ್ರಕ್ಕಾಗಿ ಅನಿರ್ದಿಷ್ಟಕಾಲದವರೆಗೆ ಮಾನ್ಯವಾಗಿರುತ್ತದೆ:
- ಅದೇ ಕೀ, ಅದೇ ದೇಹ: ಮೂಲ ಕಾರ್ಯವನ್ನು (ವಿಫಲವಾದದ್ದನ್ನು ಸಹ) ಹಿಂತಿರುಗಿಸುತ್ತದೆ; ಯಾವುದನ್ನೂ ಎರಡು ಬಾರಿ ರಚಿಸಲಾಗುವುದಿಲ್ಲ ಅಥವಾ ಶುಲ್ಕ ವಿಧಿಸಲಾಗುವುದಿಲ್ಲ.
- ಒಂದೇ ಕೀ, ವಿಭಿನ್ನ ದೇಹ:
409(idempotency_request_conflict). - ಮೂಲ ಕಾರ್ಯವನ್ನು ಅಳಿಸಲಾಗಿದೆ:
410(idempotency_job_gone).
ಪ್ರತಿ ಹೊಸ ಸಲ್ಲಿಕೆಗೆ ಹೊಸ UUID ಅನ್ನು ಬಳಸಿ, ಮತ್ತು ಅದೇ ಸಲ್ಲಿಕೆಯನ್ನು ಪುನಃ ಪ್ರಯತ್ನಿಸುವಾಗ ಮಾತ್ರ ಮೂಲ ಕೀಲಿಯನ್ನು ಮರುಬಳಕೆ ಮಾಡಿ.