註冊

語義關係:換字

83.6 萬條同義／反義關係

01換字才是真正的用法

詞庫收錄 836,004 條語義關係。單看數字沒有意義 —— 真正的價值在於:同義詞可以直接疊加聲韻條件。

填詞時的實際問題不是「孤獨的同義詞有哪些」,而是 「這個位置要低平＋低平,而且意思要接近孤獨,有什麼字可以換」。 後者一個請求就能回答。

意思接近「孤獨」，且兩字皆為低平（碼 22）
cURL
curl -H "Authorization: Bearer $WRITERHK_API_KEY" \
  "https://api.writer.hk/api/lexicon/synonyms?word=孤獨&code=22&limit=10"
↳total 3 · 寂寞 / 獨自 / 落寞
不加 code 是 39 個候選;加上聲調約束後剩 3 個, 而這 3 個是唱得上去的。

02同義與反義

GET/api/lexicon/synonyms
GET/api/lexicon/antonyms

兩個端點參數完全相同,只差關係類型。回應中的 relation_type會標明是 syn 還是 ant。

回應（節錄）
{
  "word": "孤獨",
  "relation_type": "syn",
  "relation_source": "all",
  "words": [
    { "char": "單獨", "jyutping": "daan1 duk6", "code": "32", "rhyme": "uk", "length": 2 }
  ],
  "total": 39,
  "limit": 10,
  "offset": 0
}

結果的每一項都是完整詞條(含粵拼、碼、韻母),毋須再逐個回查。

03在關係上疊加聲韻條件

參數型別預設說明
word必填string—來源詞。
codestring—限定協音碼 —— 換字修正倒字的主力參數。
rhyme_charstring—限定與此字押韻。
loose_rhymebooleanfalse放寬到通韻組。
lengthinteger—限定字數 —— 換字時字數通常不能變。
regstring—語域:粵 / 通 / 雅。
posstring—詞性:n / v / a / r。
sourcestringallall / curated / generated,見下節。
limitinteger50每頁筆數。
「溫柔」的同義詞中，碼為 02 者
cURL
curl -H "Authorization: Bearer $WRITERHK_API_KEY" \
  "https://api.writer.hk/api/lexicon/synonyms?word=溫柔&code=02&limit=6"
↳total 12 · 和善 / 和順 / 嫻靜 / 寧靜 / 平靜 / 文靜
限定書面語
cURL
curl -H "Authorization: Bearer $WRITERHK_API_KEY" \
  "https://api.writer.hk/api/lexicon/synonyms?word=孤獨&reg=雅&limit=6"
↳total 16 · 隱居 / 伶仃 / 孑然 / 孤僻 / 孤寂 / 孤立
反義詞 + 押韻限定
cURL
curl -H "Authorization: Bearer $WRITERHK_API_KEY" \
  "https://api.writer.hk/api/lexicon/antonyms?word=光明&rhyme_char=心&limit=6"
↳total 20 · 暗 / 陰暗 / 黑暗 / 陰 / 黯 / 冥暗
條件太緊會回零
交集是實打實的:word=孤獨&rhyme_char=心 回 0 —— 孤獨的同義詞裡沒有押 am 韻的。這不是錯誤,是答案。 請在介面上為零結果準備好退路(放寬 loose_rhyme、去掉 code、 或改用 /search 從語義維度重新出發)。

04curated 與 generated

source來源「孤獨」同義詞數適用
curatedWordNet 人工基底4需要可靠度時
generated模型補完35需要廣度時
all（預設）兩者合併39一般用途

curated 源自 WordNet 的人工對齊詞義,數量少但可信;generated 由模型補完,覆蓋面大得多,但含有一定比例的錯誤。 兩者的實際錯誤率與已知限制,請讀資料品質申報。

給人挑選 vs 自動替換
若結果會直接寫進成品(自動替換、批次改寫),請用 curated。 若只是列給人挑,all 的廣度更有用 —— 人眼會自己篩掉不對的。

05詞卡:一次取齊

GET/api/lexicon/word/{text}

單一詞條的完整資料:讀音(含多音)、釋義、例句、情感標註、義項、同義與反義。

GET /api/lexicon/word/孤獨?relations_limit=3
{
  "char": "孤獨",
  "length": 2,
  "pos": "a",
  "reg": "通",
  "is_canto": false,
  "definition": "獨自一人、感到寂寞",
  "examples": ["感到孤獨"],
  "readings": [
    { "jyutping": "gu1 duk6", "code": "32", "rhyme": "uk", "rank": 0 }
  ],
  "affect": {
    "valence": "負",
    "emotion": "悲傷",
    "themes": ["孤獨"],
    "themes_inferred": []
  },
  "synonyms": ["單獨", "孤丁", "寂寞"],
  "antonyms": ["人丁興旺", "伴着", "合群"],
  "relation_counts": { "curated": 3, "generated": 3 },
  "relation_source": "all"
}
  • readings 依 rank 排序,rank: 0 為主要讀音。多音字會有多筆。
  • relation_counts 讓你知道同／反義各有多少是人工基底、多少是模型補完。
  • 查無此詞回 404,而非空詞卡。

06配額成本

relations_limit 直接決定成本
/word/{text} 的 relations_limit 預設為 150 —— 即每種關係最多回 150 個詞,而這些詞全部計入當日配額。 一張詞卡最多可花掉 300 個額度。

介面只顯示十數條時,請明確傳 relations_limit=10:同樣的畫面, 配額消耗降到約十五分之一。

  • 只需要同義詞就用 /synonyms,不要為此取整張詞卡。
  • 同一個詞在同一日內重複查詢不會重複計數 —— 所以在客戶端快取的效益主要是延遲,不是配額。
  • 每個成功回應的 X-Quota-Remaining 是最可靠的成本儀表。