あなたのアプリにも、言葉の橋を。
KeeLingua APIは、Raspberry Piで動く翻訳エンジンへの非同期APIです。38種類の言語・表記に対応。無料ベータ期間中は、発行済みAPIキーごとに1分30回・1日1,000回まで利用できます。全体の処理枠は共有です。
APIキー発行・停止のご相談は support@keeai.cloud へ。キーはサーバー側で保管し、公開JavaScriptやアプリに埋め込まないでください。
01 — 翻訳をリクエスト
POST /v1/translate · Authorization: Bearer <API_KEY> · Content-Type: application/json
{
"text": "明日までに資料を送ります。",
"source": "ja",
"target": "en",
"consent": true
}原文は500 Unicodeコードポイント以内。source / target は下記対応一覧のコードを指定します(大文字小文字を区別、同一コードは不可)。自動言語判定はありません。consent: true は利用規約・モデル利用条件・地域制限への同意を表します。
HTTP 202
{
"id": "ジョブID",
"token": "この結果専用の秘密トークン",
"state": "queued",
"expiresIn": 120,
"poll": "/v1/jobs/ジョブID"
}02 — 結果を取得
返された poll のパスに GET を送ります。AuthorizationにはAPIキーではなく、返された token を指定します。2秒程度の間隔で確認してください。トークンをURL・ログ・第三者に含めないでください。
GET /v1/jobs/<ID>
Authorization: Bearer <JOB_TOKEN>
HTTP 200
{
"id": "ジョブID",
"state": "done",
"translation": "I will send the materials by tomorrow.",
"elapsedMs": 1234,
"machineTranslated": true
}上記は応答形式の例です。elapsedMsはRPI側処理時間で、待ち時間や通信時間を含みません。未完了時は202とqueued / runningを返します。結果は受付から最大120秒で取得不能になります。再起動等では早期に失われる場合があります。
エラーと再試行
| HTTP | 意味 | 対応 |
|---|---|---|
| 400 / 413 | 入力・同意・サイズ不正 | 内容を修正 |
| 401 | APIキー無効 | キーを確認 |
| 403 | 地域または送信元制限 | 制限を迂回しない |
| 404 | 結果期限切れ/トークン不正 | 必要なら再受付 |
| 429 | 利用上限 | 分上限は翌分、日上限は翌UTC日に回復 |
| 502 | 翻訳失敗・出力超過 | 文章を短くする |
| 503 | オフライン・混雑 | Retry-After後に間隔を空ける |
自動再試行は最大3回程度に制限してください。受付成功後の重複送信は別ジョブになり、回数を消費します。SLA、無制限利用、一定の翻訳品質は提供しません。
対応言語・表記(38種類)
GET /v1/languages で一覧を取得できます(APIキー不要、地域制限あり)。応答の languages に code / name / direction / experimental が含まれます。experimental: true の5言語は試験対応です。カザフ語はアラビア文字、モンゴル語は伝統文字で出力される場合があります。中国語は zh(簡体字)、zh-Hant(繁体字)、yue(広東語)を指定してください。言語によって品質に差があり、すべての組み合わせで同等の品質を保証するものではありません。
| コード | 言語・表記 |
|---|
ブラウザーでAPIを試す
利用上の重要な制限
APIにもEU・英国・韓国の地域制限が適用されます。地域判定不能の場合も提供しません。プロキシや海外サーバーを利用して制限地域に再提供してはいけません。結果を他のAIモデルの改善・学習に使用することは禁止されています(Tencent HYまたはその派生モデルを除く)。公開する出力にはAIによる機械翻訳と明示してください。
Tencent HY Community License全文・Acceptable Use Policy を確認してください。本サービスの提供者は池端孝将です。Tencentとは提携・協賛・推奨関係にありません。