GetRouterДокументация
  • Русский

    • Изображения

    GetRouter предоставляет отдельные эндпоинты для генерации и редактирования изображений.

    POST https://getrouter.ai/v1/images/generations
POST https://getrouter.ai/v1/images/edits

    Выберите модель для изображений на странице Models, проверьте её цену и поддерживаемые параметры, а затем отправляйте запрос.

    Генерация изображения

    curl https://getrouter.ai/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "Минималистичная чёрно-белая иллюстрация маршрутизатора API",
    "n": 1,
    "size": "1024x1024",
    "response_format": "url"
  }'

    Ответ содержит массив data. В зависимости от запроса и модели каждый элемент может содержать URL размещённого изображения или данные изображения в кодировке Base64.

    Python

    from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://getrouter.ai/v1",
)

response = client.images.generate(
    model="MODEL_ID",
    prompt="Минималистичная чёрно-белая иллюстрация маршрутизатора API",
    size="1024x1024",
    n=1,
)

print(response.data[0].url or response.data[0].b64_json)

    Редактирование изображения

    Для редактирования изображений используются данные формы multipart:

    curl https://getrouter.ai/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=MODEL_ID" \
  -F "prompt=Замени фон на чистую стену фотостудии" \
  -F "[email protected]" \
  -F "n=1"

    Совместимая модель может также принимать маску и дополнительные поля, специфичные для этой модели.

    Основные поля

    ПолеНазначение
    modelИдентификатор модели для изображений
    promptОписание изображения или инструкция по редактированию
    nКоличество запрашиваемых изображений
    sizeПоддерживаемые моделью размеры результата
    qualityРежим качества, специфичный для модели
    styleРежим стиля, специфичный для модели
    response_formatРаспространённые значения: url и b64_json

    Для некоторых моделей API также поддерживает форматы запросов, специфичные для провайдера. Если модели требуется другая структура тела запроса, используйте схему и пример из справочника API.

    Warning

    Количество изображений, размеры, качество и поддержка редактирования зависят от модели и напрямую влияют на стоимость. Перед пакетной генерацией проверьте страницу Pricing.

    Безопасная обработка результата

    • Скачивайте файлы по предоставленным URL до истечения срока их действия.
    • Декодируйте b64_json, прежде чем записывать его в файл.
    • Проверяйте MIME-тип результата в приложениях, которые предоставляют сгенерированные файлы пользователям.
    • Не повторяйте успешно выполненную генерацию только потому, что клиент не смог сохранить ответ.

    Что дальше