API リファレンス

画像内のテキストを翻訳し、元のレイアウトを保ったまま画像として返します。

クイックスタート

curl -X POST https://api.imagetranslate.ai/translate/image \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "imageBase64": "iVBORw0KGgoAAAANSUhEUgAA...",
    "sourceLanguage": "ja",
    "targetLanguage": "en",
    "mode": "general",
    "translator": "Grok"
  }'

認証

すべてのリクエストで、Authorization ヘッダーに API key を Bearer トークンとして指定してください。

Authorization: Bearer YOUR_KEY

API key は sk_imagetranslate_ プレフィックス付きの 32 バイトのランダム文字列です。パスワード同様に厳重に管理してください。サーバー側のシークレットマネージャーで保管し、リポジトリへのコミットやフロントエンドコードへの埋め込みは避けてください。

べき等性

ネットワークタイムアウト後にリクエストを再送する場合は、クレジットの二重消費を防ぐため、同じ Idempotency-Key ヘッダーを付けて送信してください。

Idempotency-Key: <your-uuid>

• そのキーでの最初の呼び出し: 通常どおり処理されます。
• 同じキー(同一 API key 内)での再呼び出し: 409 Conflict と元の recordId を返します。再送ではクレジットを消費しません。
• 異なるキー = 異なる呼び出しです。

キーはクライアント側で生成してください(UUIDv4 で十分です)。指定しない場合、再送のたびに新たなクレジットを消費し、Torii の呼び出しも再実行されます。

画像翻訳

同期エンドポイントです。翻訳済み画像を base64 エンコードした文字列(data:image/png;base64, プレフィックス付き)として返します。

Base URL

https://api.imagetranslate.ai

リクエストボディ

レスポンス

サンプル

curl -X POST https://api.imagetranslate.ai/translate/image \
  -H "Authorization: Bearer $IMAGETRANSLATE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "imageBase64": "YOUR_BASE64_IMAGE",
    "sourceLanguage": "ja",
    "targetLanguage": "en",
    "mode": "general",
    "translator": "Grok"
  }'

レスポンスサンプル

{
  "success": true,
  "recordId": "Z3l4abc...",
  "resultImage": "data:image/png;base64,iVBORw0KGgoAAAANSU...",
  "remainingCredit": 9990
}

エラーコード

エラーレスポンス形式

• 4xx / 500: { "detail": "<message>" }
• 422: { "detail": [{ "loc": [...], "msg": "...", "type": "..." }] }
• 409: { "error": "idempotency_replay", "recordId": "<id>", "message": "..." }

レート制限

API key 単位の 1 分あたりのリクエスト数で、プランごとに異なります。

上限を引き上げたい場合は [email protected] までご連絡ください。

料金

1 リクエストあたり advanced credit を 10 ポイント消費します。プランおよびクレジットパックの詳細は料金ページ を参照してください。

付録

言語コード

sourceLanguage には ISO 639-1 / BCP-47 コード、または自動検出用の auto を指定できます。 targetLanguage も同じコードセットですが、auto は使用できません。

主なコード:

mode 値

mode はレンダリングスタイルを指定します。画像の内容に最も合うものを選んでください。

translator モデル

translator で翻訳に使用する AI モデルを指定します。いずれのモデルも 1 回あたり 10 ポイントです。

• Grok (既定)
• Gemini
• Deepseek
• ChatGPT
• Claude

はじめに

統合の準備が整ったら、最初の API key を作成 →