API 使用條款

本《API 使用條款》適用於 writer.hk 提供的 /api/lexicon 與 /api/keys 服務 (下稱「本 API」)。本條款為《服務條款》之補充而非取代;兩者如有牴觸,就本 API 之使用而言以本條款為準。

使用本 API(包括匿名呼叫)即表示你接受本條款。

• 密鑰代表你的身分。在你的密鑰下發生的一切呼叫,均視為由你作出,你須為此負責。
• 密鑰不得共享、轉售、嵌入公開的用戶端程式碼,或以任何方式讓第三方以你的額度呼叫本 API。
• 明文密鑰只在建立時顯示一次。我們只保存其雜湊值,無法為你找回。
• 如懷疑密鑰外洩,你應立即在 /api/keys 撤銷並重新建立。撤銷前所產生的用量仍由你承擔。
• 我們可在偵測到密鑰外洩、濫用或違反本條款時,暫停或撤銷該密鑰。

本 API 設有每分鐘請求數與每日不重複詞配額兩重限制。後者(而非請求數) 才是真正的上限,目的在於防止整個詞庫被逐頁擷取。你可隨時以 GET /api/lexicon/usage 查詢用量。

下列行為構成規避額度,屬違反本條款:

• 為擴大配額而建立多個帳戶或密鑰、輪換 IP,或以其他方式分散同一項擷取工作;
• 系統性地枚舉詞條(例如按字序或編碼窮舉),不論速率高低;
• 以自動化方式重建本 API 所返回資料之整體或實質部分。

本 API 返回的資料包含以下第三方開放資料。這些授權要求標示原作者, 而該義務會隨資料傳遞至你的產品:

• 粵拼讀音 —— rime-cantonese(CanCLID),CC BY 4.0;
• 釋義與詞例 —— 開放詞典 kfcd(hyzd / yyzd),CC BY 3.0;
• 量詞與搭配 —— 劉錫祥《粵語量詞詞典》(kfcd/yylc),CC BY 3.0;
• 語義群、語義分類與同反義基底 —— Chinese Open Wordnet 與 Princeton WordNet,WordNet License。

若你的產品向使用者呈現上述任何資料,你須於產品內合理可見之處 (例如「關於」頁、資料來源說明、或呈現該資料的介面附近)作出標示。GET /api/lexicon/attribution 會返回一段可直接使用的required_notice 文字,以及逐個回應欄位對應的來源;每個回應亦附X-Data-Attribution 標頭。

純演算法推導的欄位(協音碼、音層、押韻歸類、聲韻分解)不涉第三方權利, 但仍受本條款其他條文規範。

允許:

• 在你的應用程式、網站或內部工具中查詢並向你的使用者呈現結果;
• 為效能目的快取回應(見下條);
• 將結果用於你自己作品的創作過程。

未經書面授權,不得:

• 將本 API 之資料整體或實質部分,以資料集、詞庫、詞典檔或同類形式再分發、公開或出售;
• 以本 API 為後端,提供與本 API 功能實質相同的查詢服務(即轉售本服務);
• 利用本 API 之輸出訓練、微調或評估任何用以替代本服務的模型或資料庫;
• 移除、遮蔽或竄改回應中的來源標示資訊。

資料集本身的授權(而非 API 查詢)另循獨立協議辦理。

你可為減少重複呼叫而快取回應,保存期不超過三十(30)日。 快取僅限用於服務你自己的使用者,不得作為建立本地副本或衍生資料集的手段。 我們更新詞典版本後,你應在合理期間內更新快取;GET /api/lexicon/version 可查詢當前資料版本。

本 API 之資料以「現狀」提供。我們公開申報以下已知限制,你在採用前應自行評估其是否適合你的用途:

• 讀音、協音碼與押韻歸類覆蓋率 100%;釋義約 76%。
• 同義與反義關係共 836,004 條,其中約 89% 由大型模型生成,並非人工校訂。 可用 source=curated 只取 WordNet 人工基底。
• 主題意象 theme 原標僅覆蓋約 8.3% 詞條;theme_scope=all 可加入由語義群傳播推得的標籤(合計約 19.8%), 但該推測部分抽樣顯示約三成不準確,僅適合擴大聯想,不適合精確檢索。
• 語域 reg 覆蓋約 20.5%;情緒標籤非中性者約 13.4%。

上列數值為現階段實測結果。本詞庫之詞條、語義關係、情感與主題標註持續維護、擴充與校正, 覆蓋率一般會隨版本更新而提升。惟本條僅為現況說明,不構成就任何維度於任何時間 達致特定覆蓋率、準確率或新增特定內容之承諾;貴方之採用決定應以GET /api/lexicon/version 所示之當前版本實況為準。

我們不保證資料之準確性、完整性或適合特定用途。你不應在需要語言學或法律準確性的場合, 單憑本 API 之輸出作出決定。本條不免除或限制本平台因重大過失或違法行為而須承擔的責任。

• 資料版本可經 GET /api/lexicon/version 查詢。
• 我們會盡合理努力以新增方式演進 API(加欄位、加參數),此類變更不視為破壞性變更, 你的用戶端應容忍未知欄位。
• 如需作出破壞性變更(移除或改變既有欄位、參數語義),我們會就受影響的付費密鑰 提供不少於九十(90)日的事先通知。
• 本條款如有修訂,將於本頁發布;你於變更後繼續使用本 API,即表示同意修訂後的條款。

免費與試用額度不附帶任何服務水平承諾,並可能在維護或容量緊張時受限。 付費方案之可用性、延遲與支援承諾,以雙方另行簽署的協議為準;如無另行約定, 本 API 按「合理努力」提供。

如你違反本條款、規避額度、或你的使用方式危害本服務的穩定或安全, 我們可暫停或終止你的密鑰與服務,必要時可不經事先通知(其後我們會盡合理努力說明原因)。 你亦可隨時撤銷自己的密鑰以終止使用。終止後,你須在合理期間內刪除依本條款所快取的資料。

本條款受香港特別行政區法律管轄並據其詮釋。因本條款引起的任何爭議,雙方同意受香港法院的司法管轄。

如對本條款、資料授權或商業方案有任何疑問,歡迎經來信與我們聯絡。資料來源與授權之完整清單見鳴謝與授權。