コンテンツにスキップ

即時翻訳

POST /api/v1/ai/translate-snippet
{
"text": "Hello world",
"source_lang": "auto",
"target_lang": "zh",
"engine": "xr-397b"
}

text は 1~5000 文字です。target_lang および source_lang(auto を除く)はサポートされている言語コードでなければならず、そうでない場合は 422 となります。応答:

{ "translated_text": "你好,世界", "source_lang": "auto", "target_lang": "zh" }
POST /api/v1/ai/translate-batch
{
"segments": [
{ "id": "p1", "text": "First paragraph." },
{ "id": "p2", "text": "Second paragraph." }
],
"target_lang": "zh"
}
  • segments は最大4000文字のセグメントを1~64個保持します。各 id はリクエスト内で一意であり(1~64文字)、セグメント数が多すぎるか、セグメントが長すぎると 413 が返されます。
  • レスポンスはリクエスト順に segments: [{ "id", "translated_text" }] を返します。
  • 空白のみを含むセグメントはそのまま返され、課金されません。
  • リクエスト本文は2 MBに制限されており、リクエストの実行時間は最大180秒です。クライアントのタイムアウトを少なくとも180秒以上に設定してください。
  • Idempotency-Key を送信してください。ネットワークの切断またはタイムアウトが発生した場合、同じキーと本文で再試行してください。二重請求されることはありません。
  • 利用できない engine は 400 を返します。キーに選択した設定を含まない許可設定がある場合、403 です。
  • 実際に処理された原文テキストの量に基づいて課金されます。
POST /api/v1/ai/ocr

画像を multipart/form-data の file フィールド(PNG、JPEG、WebP、BMP、GIF、最大 12 MB および 2,500 万ピクセル)にアップロードするか、リクエスト本文として画像を送信してください。レスポンスには、ピクセル座標とともにテキストが行ごとに返されます:

{
"width": 640,
"height": 240,
"engine": "omnidoc-ocr",
"blocks": [
{ "text": "编号 INV-20261029-0042", "confidence": 0.97, "x": 23, "y": 76, "w": 366, "h": 33 }
]
}
  • x および y は、アップロードされた画像の座標系におけるテキスト行の左上隅を示します(向きデータを持つ JPEG は正立して読み込まれます)。
  • 各行に1つのボックス;confidenceはその行の認識信頼度(0~1)です。テキストが見つからない場合、レスポンスは空のblocksを持つ200となります。
  • 画像内のテキスト認識にはクレジットはかかりません。幅または高さが11ピクセル未満の画像は、空の結果を返します。
  • 認識が一時的に利用できない場合は応答コード 503、タイムアウトの場合は 504、中国語での説明は detail となります。後ほど再度お試しください。
  • Web翻訳拡張機能のサインイン(omnidoc.translate.use)、APIキー、およびブラウザのサインインは、いずれもこれを呼び出すことができます。
  • クエリパラメータ engine、scene、lang は古い拡張機能バージョン用に保持されており、結果には影響しません。
  • 翻訳済みの画像を直接取得するには、画像をアップロードして翻訳ジョブを作成してください。

POST /api/v1/ai/notes、/ai/chat、および /ai/generate は廃止され、代わりに 410 を返します。