2. Gọi API

POST https://ocr.retec.vn/api/v1/ocr, body multipart/form-data, key trong header Authorization: Bearer <key>.

curl

curl -X POST https://ocr.retec.vn/api/v1/ocr \
  -H "Authorization: Bearer $RETEC_API_KEY" \
  -F "[email protected]" \
  -F "fields=Số văn bản, Ngày ban hành, Người ký"

Python

import os, requests

with open("cong-van.pdf", "rb") as f:
    r = requests.post(
        "https://ocr.retec.vn/api/v1/ocr",
        headers={"Authorization": f"Bearer {os.environ['RETEC_API_KEY']}"},
        files={"file": f},
        data={"fields": "Số văn bản, Ngày ban hành, Người ký"},
        timeout=120,
    )
data = r.json()
print(data["text"] if data["ok"] else data["message"])

3. Kết quả

Luôn là JSON. Thành công (HTTP 200):

{
  "ok": true,
  "text": "ỦY BAN NHÂN DÂN ...",
  "pages": 2,
  "fields": {"Số văn bản": "12/QĐ-UBND", "Ngày ban hành": "05/01/2026", "Người ký": "Nguyễn Văn A"},
  "remaining": 4
}

• fields là null khi không gửi fields; thông tin không tìm thấy có giá trị rỗng hoặc không có trong kết quả. Ngày tháng ở dạng DD/MM/YYYY.
• Có fieldsError khi không trích xuất được thông tin: lượt vẫn tính, text vẫn đầy đủ.
• remaining: số lượt còn lại hôm nay của key.

Lỗi (HTTP 4xx, 5xx): {"ok": false, "code": "quota", "message": "…"}. message là câu có thể hiện cho người dùng, tiếng Việt hoặc tiếng Anh theo header Accept-Language (en → tiếng Anh); phần mềm nên xử lý theo code.

4. Mã lỗi

5. Giới hạn và lưu ý

• Chỉ nhận yêu cầu từ mạng tại Việt Nam: máy chủ gọi API cần đặt ở Việt Nam.
• Mỗi mạng (IP) chỉ một yêu cầu đang xử lý tại một thời điểm, tối đa 6 yêu cầu mỗi phút: gửi file lần lượt, chờ kết quả rồi gửi tiếp.
• Mỗi file thường mất vài giây; đặt thời gian chờ phía bạn khoảng 120 giây.
• Giữ key bí mật, chỉ gọi API từ máy chủ của bạn, không đặt key trong mã chạy trên trình duyệt hay ứng dụng phát hành.
• File và nội dung chỉ được xử lý trong bộ nhớ, không lưu lại, như trên trang web (xem Chính sách & Điều khoản).
• Kết quả được tạo tự động và có thể sai sót; hãy kiểm tra lại trước khi dùng cho việc quan trọng.

2. Call the API

POST https://ocr.retec.vn/api/v1/ocr, body multipart/form-data, key in the header Authorization: Bearer <key>.

curl

curl -X POST https://ocr.retec.vn/api/v1/ocr \
  -H "Authorization: Bearer $RETEC_API_KEY" \
  -H "Accept-Language: en" \
  -F "[email protected]" \
  -F "lang=en" \
  -F "fields=Invoice number, Issue date, Signer"

Python

import os, requests

with open("invoice.pdf", "rb") as f:
    r = requests.post(
        "https://ocr.retec.vn/api/v1/ocr",
        headers={"Authorization": f"Bearer {os.environ['RETEC_API_KEY']}", "Accept-Language": "en"},
        files={"file": f},
        data={"lang": "en", "fields": "Invoice number, Issue date, Signer"},
        timeout=120,
    )
data = r.json()
print(data["text"] if data["ok"] else data["message"])

3. Response

Always JSON. Success (HTTP 200):

{
  "ok": true,
  "text": "INVOICE ...",
  "pages": 2,
  "fields": {"Invoice number": "INV-0012", "Issue date": "05/01/2026", "Signer": "John Smith"},
  "remaining": 4
}

• fields is null when you do not send fields; information that is not found has an empty value or is missing from the result. Dates use DD/MM/YYYY.
• fieldsError is present when the information could not be extracted: the request still counts and text is still complete.
• remaining: the key's remaining requests for today.

Errors (HTTP 4xx, 5xx): {"ok": false, "code": "quota", "message": "…"}. message is a sentence you can show to users, in Vietnamese or English depending on the Accept-Language header (en → English); your software should act on code.

4. Error codes

5. Limits and notes

• Requests are only accepted from networks in Vietnam: the server calling the API must be located in Vietnam.
• Each network (IP) can have only one request in progress at a time, and at most 6 requests per minute: send files one by one and wait for each result.
• Each file usually takes a few seconds; set your client timeout to about 120 seconds.
• Keep the key secret: call the API only from your own server, never put the key in code that runs in a browser or in a published app.
• Files and their content are processed in memory only and are not kept, just like on the website (see Policy & Terms).
• Results are generated automatically and may contain mistakes; check them before using them for anything important.