更新日: 2026-06-06

チャット画像認識

POST /v1/chat/completions

Crazyrouter 本番環境では、OpenAI 形式の image_url 入力をサポートする主要な視覚モデルを検証済みです：

gpt-4o、gpt-4o-mini、gpt-4.1、gpt-5.5 などの OpenAI 視覚モデル
data:image/...;base64,... data URL と公開 https:// URL の両方が利用可能
message.content は現在プレーン文字列で返却されます

推奨手順：ローカル画像はまず画像アップロード API で media.crazyrouter.com の一時 URL に変換してから image_url に渡す、あるいは base64 data URL を直接送る。リモート公開 URL も使えますが、後述の「リモート URL の制約」を満たす必要があります。

base64 data URL を使う（最も確実）

curl https://api.crazyrouter.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "What color is this image?"},
          {
            "type": "image_url",
            "image_url": {
              "url": "data:image/png;base64,iVBORw0KGgoAAA..."
            }
          }
        ]
      }
    ],
    "max_tokens": 100
  }'

レスポンス例：

{
  "model": "gpt-4o-mini",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "Red."
      }
    }
  ]
}

リモート https URL を使う

curl https://api.crazyrouter.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "Describe in 5 words."},
          {
            "type": "image_url",
            "image_url": {
              "url": "https://www.gstatic.com/webp/gallery/1.jpg"
            }
          }
        ]
      }
    ],
    "max_tokens": 40
  }'

リモート URL の制約

URL は Crazyrouter サーバーから到達可能 である必要があります。「ブラウザで開ける」だけでは不十分です。よくある失敗パターン：

失敗	原因	対処
ドメインが解決できない	プライベートアドレス、誤入力	公開 https URL に変更
403 Forbidden	一部 CDN（wikimedia、プライベート S3 など）がサーバー UA / Referer を拒否	アップロード API または base64 を使用
Content-Type が `image/*` ではない	URL が HTML やログインページにリダイレクトしている	画像直リンクであることを確認
ファイル 20MB 超	単一ファイルサイズ上限	圧縮・トリミング

エラー Unable to process the image you provided. Please verify the image URL is publicly accessible, or upload it as base64. が表示された場合、URL がサーバーから到達不能ということなので、上表に沿って切り分けてください。

推奨運用

社内素材、プライベート画像、到達性が不確かな画像：先に POST /v1/files/uploads で 72 時間有効な media.crazyrouter.com/... URL を取得し、それを image_url に渡す
小さい（< 1MB）画像、使い捨ての画像：base64 data URL を直接送り、追加リクエストを省く
複数画像入力、detail パラメータなどの高度な使い方：OpenAI 上流で対応済みなので、OpenAI 公式仕様どおりに送れば動作します

はじめに

主要機能

公式モデル課金

チャット画像認識

チャット画像認識

base64 data URL を使う（最も確実）

リモート https URL を使う

リモート URL の制約

推奨運用

​チャット画像認識

​base64 data URL を使う（最も確実）

​リモート https URL を使う

​リモート URL の制約

​推奨運用

チャット画像認識

base64 data URL を使う（最も確実）

リモート https URL を使う

リモート URL の制約

推奨運用