即時翻訳
短いテキストの翻訳
Section titled “短いテキストの翻訳”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" }バッチセグメント翻訳
Section titled “バッチセグメント翻訳”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です。 - 実際に処理された原文テキストの量に基づいて課金されます。
画像内のテキスト認識
Section titled “画像内のテキスト認識”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は古い拡張機能バージョン用に保持されており、結果には影響しません。 - 翻訳済みの画像を直接取得するには、画像をアップロードして翻訳ジョブを作成してください。
退役したエンドポイント
Section titled “退役したエンドポイント”POST /api/v1/ai/notes、/ai/chat、および /ai/generate は廃止され、代わりに 410 を返します。