Изображения

Когда использовать

Этот сценарий подходит, если модель умеет:

• принимать изображение как вход;
• генерировать изображение на выходе;
• работать с image-capable payloads через совместимый upstream.

Пример: анализ изображения

curl https://routerapi.ru/api/v1/chat/completions \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-2.5-flash-image",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "Опиши это изображение простыми словами"
          },
          {
            "type": "image_url",
            "image_url": {
              "url": "data:image/png;base64,BASE64_IMAGE_HERE"
            }
          }
        ]
      }
    ]
  }'

Пример: генерация изображения

curl https://routerapi.ru/api/v1/chat/completions \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-2.5-flash-image",
    "messages": [
      {
        "role": "user",
        "content": "Создай атмосферный закат над горами"
      }
    ],
    "modalities": ["image", "text"]
  }'

Пример ответа

В успешном ответе image-capable модель может вернуть:

{
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "Готово.",
        "images": [
          {
            "type": "image_url",
            "image_url": {
              "url": "data:image/png;base64,iVBORw0KGgoAAA..."
            }
          }
        ]
      }
    }
  ]
}

Важная оговорка

RouterAPI проксирует изображение только тогда, когда:

• модель действительно image-capable;
• upstream принимает такой payload;
• баланс и ключ пользователя проходят проверку.

Если конкретная модель не поддерживает изображения, этот запрос не будет считаться “рабочим” сценарием — RouterAPI не добавляет поддержку поверх несовместимой модели.