Dịch ngay lập tức
Dịch văn bản ngắn
Phần tiêu đề “Dịch văn bản ngắn”POST /api/v1/ai/translate-snippet{ "text": "Hello world", "source_lang": "auto", "target_lang": "zh", "engine": "xr-397b"}text có độ dài từ 1 đến 5000 ký tự. target_lang và source_lang (ngoại trừ auto) phải là các mã ngôn ngữ được hỗ trợ; nếu không, sẽ dùng 422. Phản hồi:
{ "translated_text": "你好,世界", "source_lang": "auto", "target_lang": "zh" }Dịch phân đoạn hàng loạt
Phần tiêu đề “Dịch phân đoạn hàng loạt”POST /api/v1/ai/translate-batch{ "segments": [ { "id": "p1", "text": "First paragraph." }, { "id": "p2", "text": "Second paragraph." } ], "target_lang": "zh"}segmentschứa từ 1 đến 64 đoạn, mỗi đoạn tối đa 4000 ký tự; mỗiidphải là duy nhất trong yêu cầu (1–64 ký tự). Nếu có quá nhiều đoạn hoặc một đoạn quá dài sẽ trả về413.- Phản hồi trả về
segments: [{ "id", "translated_text" }]theo thứ tự yêu cầu. - Các đoạn chỉ chứa khoảng trắng được trả về nguyên vẹn và không bị tính phí.
Quy ước
Phần tiêu đề “Quy ước”- Định dạng yêu cầu bị giới hạn ở 2 MB và mỗi yêu cầu chạy tối đa 180 giây; hãy đặt thời gian chờ của máy khách ít nhất là 180 giây.
- Gửi một
Idempotency-Key. Sau khi mất kết nối mạng hoặc hết thời gian chờ, hãy thử lại với cùng một khóa và cùng một nội dung yêu cầu; bạn sẽ không bị tính phí hai lần. enginekhông khả dụng trả về400; nếu khóa có các cài đặt được phép nhưng không bao gồm cài đặt đã chọn, thì403.- Tính phí dựa trên lượng văn bản nguồn thực tế đã được xử lý.
Nhận dạng văn bản trên ảnh
Phần tiêu đề “Nhận dạng văn bản trên ảnh”POST /api/v1/ai/ocrTải lên hình ảnh vào trường file của multipart/form-data (PNG, JPEG, WebP, BMP, GIF, tối đa 12 MB và 25 triệu pixel), hoặc gửi hình ảnh dưới dạng thân yêu cầu. Phản hồi trả về văn bản theo từng dòng kèm tọa độ pixel:
{ "width": 640, "height": 240, "engine": "omnidoc-ocr", "blocks": [ { "text": "编号 INV-20261029-0042", "confidence": 0.97, "x": 23, "y": 76, "w": 366, "h": 33 } ]}xvàylà góc trên cùng bên trái của dòng văn bản, tính theo tọa độ của hình ảnh được tải lên (một JPEG có dữ liệu định hướng được đọc ở tư thế thẳng đứng).- Mỗi dòng chứa một hộp;
confidencelà độ tin cậy nhận dạng của dòng đó (0–1). Nếu không tìm thấy văn bản, phản hồi là200vớiblockstrống. - Nhận dạng văn bản trong ảnh không tính phí tín dụng. Các ảnh có chiều rộng hoặc chiều dài nhỏ hơn 11 pixel sẽ trả về kết quả rỗng.
- Nếu tính năng nhận dạng tạm thời không khả dụng, phản hồi là
503; khi hết thời gian chờ, phản hồi là504, kèm theo giải thích bằng tiếng Trung tạidetail; vui lòng thử lại sau. - Tính năng đăng nhập của tiện ích mở rộng dịch web (
omnidoc.translate.use), các khóa API và tính năng đăng nhập trình duyệt đều có thể gọi đến nó. - Các tham số truy vấn
engine,scenevàlangđược giữ nguyên cho các phiên bản tiện ích mở rộng cũ hơn và không ảnh hưởng đến kết quả. - Để nhận hình ảnh đã dịch trực tiếp, hãy tải lên hình ảnh và tạo một công việc dịch.
Điểm cuối đã nghỉ hưu
Phần tiêu đề “Điểm cuối đã nghỉ hưu”POST /api/v1/ai/notes, /ai/chat và /ai/generate đã ngừng hoạt động và trả về 410.