bn-router

API изображений и видео

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

Эндпоинт

Генерация изображений и видео использует один эндпоинт. Отправьте POST-запрос с вашим промптом, и шлюз направит его к лучшему вышестоящему аккаунту.

Endpoint
POST https://YOUR-BASE-URL/v1/images/generations

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

Создавайте изображения по текстовому описанию. Запрос следует формату OpenAI images/generations. Поддерживаются Flux Pro, DALL·E 3, Stable Diffusion 3 и другие — все через один эндпоинт.

Установите model на любой ID модели изображений из плазы моделей. Ответ содержит один или несколько URL созданных изображений.

curl
curl https://YOUR-BASE-URL/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-pro",
    "prompt": "A serene mountain lake at sunrise, photorealistic",
    "n": 1,
    "size": "1024x1024"
  }'

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

Редактируйте существующее изображение, указав маску и новый промпт. Отправьте multipart/form-data запрос с полями изображения, маски и промпта.

Только модели, поддерживающие инпейнтинг, принимают редактирование. Проверьте плазу моделей на наличие совместимых моделей.

curl
curl https://YOUR-BASE-URL/v1/images/edits \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "image=@./input.png" \
  -F "mask=@./mask.png" \
  -F "prompt=Replace the background with a futuristic cityscape" \
  -F "n=1" \
  -F "size=1024x1024"

Генерация видео

Создавайте короткие видео по текстовому или графическому запросу. Тот же эндпоинт и аутентификация работают для видеомоделей. Время отклика дольше из-за вычислительной стоимости генерации видео.

Поддержка видео быстро расширяется. Проверьте плазу моделей для получения информации о последних доступных видеомоделях.

curl
curl https://YOUR-BASE-URL/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "A cinematic aerial view of a futuristic city at night",
    "n": 1,
    "size": "1920x1080"
  }'

Использование и биллинг

Запросы на создание изображений и видео тарифицируются за генерацию по ставкам, указанным в плазе моделей. Размер изображения, качество (hd/standard) и количество запрошенных изображений влияют на стоимость в токенах.

Использование отслеживается в дашборде наряду с текстовыми завершениями, что позволяет видеть всю активность шлюза в одном месте.