Tra âm Hán Việt API

Chuyển chữ Hán sang âm Hán Việt và pinyin theo từ, kèm dạng phồn thể / giản thể; hoặc tra chữ Hán theo âm Hán Việt.

GETPOSThttps://apibox.io.vn/v1/vn-hanviet

Gửi văn bản chữ Hán (giản thể hoặc phồn thể, tối đa 1.000 ký tự), API trả về âm Hán Việt, pinyin, dạng phồn thể, dạng giản thể và các đoạn: mỗi từ kèm âm đọc, pinyin và nghĩa tiếng Anh. Văn bản được tách từ theo cách khớp dài nhất với khoảng 7.600 từ Hán Việt (愛國 → ái quốc, 銀行 → ngân hàng) và 125.000 từ của CC-CEDICT, nên chữ đa âm được đọc theo từ chứa nó khi từ đó có trong dữ liệu (行動 hành động, 銀行 ngân hàng); chữ còn lại lấy âm chính, và mọi âm của chữ đứng riêng đều được liệt kê.

Tra ngược: reading=ái liệt kê các chữ đọc là "ái", ưu tiên chữ có âm chính đó (ignore_tones=true để khớp không dấu thanh). details=true thêm từng chữ kèm mọi âm Hán Việt, âm Hán Nôm, pinyin và dạng biến thể. Chữ chưa có âm đọc được liệt kê trong unknown_characters.

Dữ liệu: âm Hán Việt từ cơ sở dữ liệu Unihan của Unicode (kVietnamese, giấy phép Unicode) bổ sung bằng Wiktionary (CC BY-SA 4.0); pinyin từ Unihan và CC-CEDICT (CC BY-SA 4.0, mdbg.net); cập nhật hằng tuần. Mỗi kết quả kèm thông tin ghi nguồn. Âm đọc mang tính tham khảo khi học: văn bản cổ đôi khi dùng âm khác với âm chính.

Tham số

Tên	Vị trí	Kiểu	Bắt buộc	Mặc định
`text`	query\|body	string	không		Văn bản chữ Hán, giản thể hoặc phồn thể (tối đa 1.000 ký tự).
`reading`	query\|body	string	không		Tra ngược: một âm Hán Việt (vd. `ái`); `ignore_tones=true` để khớp không dấu, `limit` (mặc định 100).
`details`	query\|body	boolean	không	`false`	Thêm từng chữ kèm mọi âm đọc, pinyin và biến thể.
`words`	query\|body	boolean	không	`true`	Dùng từ của CC-CEDICT để tách từ, lấy pinyin và nghĩa tiếng Anh.

Ví dụ

curl "https://apibox.io.vn/v1/vn-hanviet?text=%E6%88%91%E7%88%B1%E8%B6%8A%E5%8D%97" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/vn-hanviet?text=%E6%88%91%E7%88%B1%E8%B6%8A%E5%8D%97', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
  },
});
const data = await res.json();
console.log(data);

import requests

res = requests.get(
    "https://apibox.io.vn/v1/vn-hanviet?text=%E6%88%91%E7%88%B1%E8%B6%8A%E5%8D%97",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-hanviet?text=%E6%88%91%E7%88%B1%E8%B6%8A%E5%8D%97');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Kết quả trả về

{
  "text": "我爱越南",
  "han_viet": "ngã ái việt nam",
  "pinyin": "wǒ ài yuè nán",
  "traditional": "我愛越南",
  "simplified": "我爱越南",
  "segments": [
    {
      "text": "我",
      "han_viet": "ngã",
      "pinyin": "wǒ",
      "traditional": "我",
      "simplified": "我",
      "source": "character",
      "english": [
        "I; me; my"
      ],
      "readings": [
        "ngã",
        "ngả"
      ]
    },
    {
      "text": "爱",
      "han_viet": "ái",
      "pinyin": "ài",
      "traditional": "愛",
      "simplified": "爱",
      "source": "traditional variant",
      "english": [
        "to love; to be fond of; to like",
        "affection",
        "to be inclined (to do sth); to tend to (happen)"
      ],
      "readings": [
        "ái"
      ]
    },
    {
      "text": "越南",
      "han_viet": "việt nam",
      "pinyin": "yuè nán",
      "traditional": "越南",
      "simplified": "越南",
      "source": "compound",
      "english": [
        "Vietnam"
      ]
    }
  ],
  "unknown_characters": [],
  "note": "Hán-Việt readings of whole words come from Sino-Vietnamese words in Wiktionary; other characters take their main reading, which may not fit the context.",
  "attribution": {
    "sources": [
      {
        "name": "Unicode Unihan database",
        "version": "18.0.0",
        "license": "Unicode License v3",
        "url": "https://www.unicode.org/charts/unihan.html"
      },
      {
        "name": "Wiktionary (Vietnamese entries, via wiktextract / kaikki.org)",
        "license": "CC BY-SA 4.0",
        "url": "https://en.wiktionary.org"
      },
      {
        "name": "CC-CEDICT",
        "version": "2026-11-10",
        "license": "CC BY-SA 4.0",
        "url": "https://www.mdbg.net/chinese/dictionary?page=cedict"
      }
    ],
    "built_at": "2026-11-11"
  }
}

Ứng dụng

Hiện âm Hán Việt trong ứng dụng học tiếng Trung (HSK)
Đọc tên người, địa danh Trung Quốc theo âm Hán Việt
Hỗ trợ người dịch truyện Trung với thuật ngữ Hán Việt
Tra chữ cho gia phả, câu đối, nghiên cứu Hán Nôm

Hỏi đáp

Chữ đa âm được xử lý thế nào?

Ưu tiên khớp theo từ: chữ nằm trong một từ Hán Việt hoặc một từ của CC-CEDICT đã biết sẽ lấy âm và pinyin của từ đó; chữ đứng riêng lấy âm chính, kèm danh sách các âm khác.

Giản thể hay phồn thể?

Cả hai: chữ giản thể được quy về dạng phồn thể để tìm từ Hán Việt, và kết quả có cả hai cách viết.

Có được dùng dữ liệu cho mục đích thương mại không?

Được: Unihan theo giấy phép Unicode, Wiktionary và CC-CEDICT theo CC BY-SA 4.0, đều cho phép dùng thương mại khi ghi nguồn; hãy giữ trường attribution khi hiển thị kết quả.

Tra âm Hán Việt API

Tham số

Ví dụ

Kết quả trả về

Ứng dụng

Hỏi đáp

API liên quan

So sánh văn bản

Tạo slug

Thống kê văn bản