Документация API Ссылка SDK Ссылка Агентное использование AI Навыки

Изображения

Создать изображение

Генерирует изображение из текстовой подсказки. По умолчанию возвращает OpenAI-совместимую синхронизацию JSON (работает с client.images.generate()); passstream: true, чтобы вместо этого получить поток событий SSE. Преобразование изображения в изображение поддерживается через inputImages/input_references.

POST/api/v1/images/generations

Авторизация

Authorizationобязательно

string · header

Ключ API как Bearer-токен в заголовке Authorization.

Тело

modelобязательно

string

Используемая модель создания изображения, указанная поставщиком, например «openai/gpt-image-2».

minLength: 1

Example: "openai/gpt-image-2"

promptобязательно

string

Текстовое описание желаемого изображения.

minLength: 1

Example: "a red cat on a sofa"

n

integer

Количество изображений для создания: 1–10.

1–10

Example: 1

size

string

Размер изображения — явные пиксели («2048х2048») или уровень («2К», «4К»). Пересылается провайдеру как есть; поддерживаемые размеры зависят от модели.

Example: "1024x1024"

stream

boolean

Выбирает форму ответа: опущено или false = OpenAI-совместимая синхронизация JSON (по умолчанию), true = поток событий SSE.

input_references

string[]

Исходные изображения для преобразования изображения в изображение (данные: или URL-адреса https:), до 8. Псевдоним inputImages (условное имя поля); оба сначала проходят модерацию контента. Возвращает 400 (не предупреждение), если маршрут модели не поддерживает i2i.

≤ 8 images

aspect_ratio

enum<string>

Соотношение сторон сгенерированного изображения. Встроенная поддержка на маршрутах некоторых моделей — проверьте support_parameters в ответе GET /api/v1/images/models для каждой модели; неподдерживаемые маршруты игнорируют это поле и отмечают его в предупреждениях ответа [] (запрос все равно выполняется успешно).

1:11:21:41:82:12:33:23:44:14:34:55:48:19:1616:99:19.519.5:99:2020:99:2121:9auto

Example: "16:9"

resolution

enum<string>

Уровень разрешения; конкретные пиксели получаются для каждого поставщика. Встроенная поддержка на маршрутах некоторых моделей — проверьте support_parameters в ответе GET /api/v1/images/models для каждой модели; неподдерживаемые маршруты игнорируют это поле и отмечают его в предупреждениях ответа [] (запрос все равно выполняется успешно).

5121K2K4K

Example: "2K"

quality

enum<string>

Качество рендеринга. Встроенная поддержка на маршрутах некоторых моделей — проверьте support_parameters в ответе GET /api/v1/images/models для каждой модели; неподдерживаемые маршруты игнорируют это поле и отмечают его в предупреждениях ответа [] (запрос все равно выполняется успешно).

autolowmediumhigh

background

enum<string>

Фоновое лечение; Для прозрачности требуется выходной_формат с поддержкой альфа-канала (png/webp). Встроенная поддержка на маршрутах некоторых моделей — проверьте support_parameters в ответе GET /api/v1/images/models для каждой модели; неподдерживаемые маршруты игнорируют это поле и отмечают его в предупреждениях ответа [] (запрос все равно выполняется успешно).

autotransparentopaque

output_format

enum<string>

Кодирование возвращаемых байтов изображения. Встроенная поддержка на маршрутах некоторых моделей — проверьте support_parameters в ответе GET /api/v1/images/models для каждой модели; неподдерживаемые маршруты игнорируют это поле и отмечают его в предупреждениях ответа [] (запрос все равно выполняется успешно).

pngjpegwebpsvg

Example: "png"

output_compression

integer

Уровень сжатия (0–100) для вывода в формате WebP/JPEG; игнорируется для png. Встроенная поддержка на маршрутах некоторых моделей — проверьте support_parameters в ответе GET /api/v1/images/models для каждой модели; неподдерживаемые маршруты игнорируют это поле и отмечают его в предупреждениях ответа [] (запрос все равно выполняется успешно).

0–100

Example: 100

seed

integer

Детерминированная начальная выборка; идентичные параметры начального числа + должны воспроизводить результат, хотя не все поставщики гарантируют это. Встроенная поддержка на маршрутах некоторых моделей — проверьте support_parameters в ответе GET /api/v1/images/models для каждой модели; неподдерживаемые маршруты игнорируют это поле и отмечают его в предупреждениях ответа [] (запрос все равно выполняется успешно).

Подробное руководство →

POST /api/v1/images/generations

1
2
3
4
5
6
7
8
curl https://bazaarlink.ai/api/v1/images/generations \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "a red cat on a sofa",
    "size": "1024x1024"
  }'

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

Успех. По умолчанию (или поток: false) возвращает синхронизацию JSON ниже; с потоком: true, возвращает поток событий SSE (см. подробное руководство по протоколу событий). Параметры, игнорируемые маршрутом, отображаются в предупреждениях верхнего уровня[] (только для информации).

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "created": 1753500000,
  "data": [
    {
      "url": "https://bazaarlink.ai/api/v1/images/proxy/eyJhbGciOi..."
    }
  ],
  "warnings": [
    {
      "param": "aspect_ratio",
      "action": "dropped",
      "reason": "'aspect_ratio' is not yet mapped for this model's upstream and was ignored; the image was still generated using the model's default."
    }
  ]
}