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

Создание по тексту или редактирование по образцу.

POST/v1/images/generations

Создайте изображение по запросу или передайте образцы в image в том же JSON-запросе для редактирования.

Аутентификация

bearerAuth

АутентификацияBearer <token>

Используйте ключ API платформы.

Расположение: header

Тело запроса

application/json

Определения типов TypeScript

Используйте тип request body в TypeScript.

model*string

ID модели на платформе.

prompt?string

Инструкция генерации или редактирования. Можно опустить только при разложении на слои.

Длина1 <= length

image?|array<>

Образцы. Без поля выполняется генерация из текста. Размер каждого изображения не более 30 MB. Число образцов см. на странице различий моделей. Разложение на слои принимает одно изображение.

size?string

Предустановка разрешения или WIDTHxHEIGHT. Значения и значения по умолчанию см. на странице различий моделей.

optimize_prompt_options?

output_format?string

Формат файла. При разложении влияет только на основу, слои всегда PNG.

По умолчанию"jpeg"

Допустимые значения

"png"
"jpeg"

background?string

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

По умолчанию"opaque"

Допустимые значения

"opaque"
"transparent"

response_format?string

Возвращать URL или данные Base64.

По умолчанию"url"

Допустимые значения

"url"
"b64_json"

watermark?boolean

Добавлять ли отметку о генерации ИИ.

По умолчаниюtrue

layer_decomposition?boolean

Разложить изображение на основу и отдельные слои. Поддерживается некоторыми моделями.

По умолчаниюfalse

sequential_image_generation?string

Режим серии. При auto модель сама решает, создавать ли серию.

По умолчанию"disabled"

Допустимые значения

"disabled"
"auto"

sequential_image_generation_options?

stream?boolean

Возвращать изображения по одному. Поддерживается некоторыми моделями.

По умолчаниюfalse

tools?array<>

Инструмент веб-поиска. Поддерживается некоторыми моделями.

Тело ответа

`application/json`

type*string

model?string

ID фактически использованной модели.

created?integer

Временная метка Unix в секундах.

Диапазон0 <= value

image_index*integer

Индекс изображения с 0.

Диапазон0 <= value

url?string

Временный URL загрузки. Сохраните изображение в течение 24 часов.

Форматuri

b64_json?string

Данные изображения Base64.

size?string

Фактические размеры в формате WIDTHxHEIGHT.

curl -X POST "https://example.com/v1/images/generations" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "Создай фотографию белой кружки на деревянном столе с мягким светом из окна слева."
  }'

{
  "created": 1793980674,
  "data": [
    {
      "url": "https://example.com/result.jpeg"
    }
  ]
}

Замените URL в примере редактирования ссылкой на изображение предыдущего шага. Для Base64 замените BASE64_BYTES фактическими данными, сохранив префикс Data URL нужного формата.

API генерации изображений VolcengineПоля API, ответы и руководства по функциям.

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

Аутентификация

Тело запроса

Тело ответа

200application/json

400application/json

401application/json

403application/json

События потокового ответа

`application/json`

`application/json`

`application/json`