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

POST /v1/images/generations

Модуль, совместимый с OpenAI images.generate СДК. Параметры, специфичные для поставщика, живут рядом со стандартными — серверная часть передает то, что понимает каждая модель.

Общие параметры

Базовый пример

curl https://api.airforce/v1/images/generations \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "A cute baby sea otter floating on its back",
    "n": 1,
    "response_format": "url"
  }'

Форма ответа

{
  "created": 1715000000,
  "data": [{
    "url": "https://.../image.jpeg"
  }]
}

Потоковый вариант

Проходить sse: true при проксировании через промежуточное программное обеспечение с жесткими тайм-аутами простоя. Ответом является одно событие SSE с полным JSON, затем [DONE].

data: {"created":1715000000,"data":[{"url":"https://.../image.jpeg"}]}

data: [DONE]

Изображение к изображению и ссылка

Модели с image_caps.max_input_images > 0 принять эталонные изображения. Либо передайте URL-адреса, либо данные в кодировке Base64.

curl https://api.airforce/v1/images/generations \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "Same character, now in a snowy forest",
    "aspect_ratio": "16:9",
    "input_images": [
      {"url": "https://example.com/character.jpg"}
    ]
  }'

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

Совместимый с OpenAI эндпоинт редактирования. Отправьте исходное изображение файлом multipart, как это делают SDK OpenAI для images.edit, или отправьте показанное выше JSON-тело с input_images. Он идёт тем же путём, что и /v1/images/generations: те же модели, цены и формат ответа.

curl https://api.airforce/v1/images/edits \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY" \
  -F "model=nano-banana-2" \
  -F "prompt=Same character, now in a snowy forest" \
  -F "[email protected]" \
  -F "aspect_ratio=16:9"

from openai import OpenAI

client = OpenAI(base_url="https://api.airforce/v1", api_key="sk-air-YOUR_API_KEY")

with open("character.png", "rb") as image:
    result = client.images.edit(
        model="nano-banana-2",
        image=image,
        prompt="Same character, now in a snowy forest",
    )
print(result.data[0].url)

До 16 входных изображений на запрос, по 25 МБ каждое; собственный лимит модели — image_caps.max_input_images. Запрос без входного изображения отклоняется с кодом 400, а не превращается в генерацию по тексту. Каждое входное изображение может увеличить цену, как указано на странице модели.

Параметры, специфичные для модели

Помимо общих параметров, указанных выше, отдельные семейства моделей допускают дополнительные параметры. Неизвестные параметры передаются в восходящий поток как есть, поэтому любая будущая ручка, зависящая от поставщика, также будет работать без обновления SDK.

Nano-Banana

nano-banana-2, nano-banana-pro

Suno (music)

suno-v4.5, suno-v5 и suno-v5.5 исторически принимались на этой конечной точке. Теперь они относятся к нативному музыкальному API по адресу /v1/audio/music — вызовы здесь отклоняются с `wrong_endpoint`.

Открытие возможностей

Каждая модель изображения раскрывает image_caps на /v1/models чтобы клиенты могли проверять вводимые данные перед отправкой:

Цены на изображения не указаны в image_caps — для определения стоимости используйте поля цен модели в /v1/models.