KKeeLingua BETA
Built for your next idea

あなたのアプリにも、言葉の橋を。

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入力・同意・サイズ不正内容を修正
401APIキー無効キーを確認
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とは提携・協賛・推奨関係にありません。