Генерация и редактирование изображений

Создавайте и редактируйте изображения с помощью совместимых с OpenAI API для работы с изображениями.

API для работы с изображениями поддерживают генерацию и редактирование. Точные размеры, значения качества, форматы и поддержка потоковой передачи зависят от модели и вышестоящего канала.

Конечные точки

Метод	Путь	Описание
`POST`	`/v1/images/generations`	Генерация изображений
`POST`	`/v1/images/edits`	Редактирование изображений, ввод в формате JSON или multipart form
`POST`	`/v1/edits`	Путь для совместимости. Предпочтительнее использовать `/v1/images/edits`

Поля запроса

Поле	Тип	Обязательно	Описание
`model`	string	Да	Идентификатор модели изображения
`prompt`	string	Обязательно для генерации	Промпт изображения
`n`	integer	Нет	Количество изображений, по умолчанию 1
`size`	string	Нет	Размер изображения, например `1024x1024`. Не используйте знак умножения `×`
`quality`	string	Нет	Качество, например `standard`, `hd` или `auto`
`response_format`	string	Нет	Формат ответа, например `url` или `b64_json`, в зависимости от модели
`style`	any	Нет	Расширенное поле OpenAI для изображений
`background`, `moderation`	any	Нет	Расширенные поля более новых моделей изображений
`output_format`, `output_compression`	any	Нет	Параметры формата вывода и сжатия
`partial_images`, `stream`	any	Нет	Используются моделями изображений, поддерживающими потоковую передачу
`image`, `images`	file/string/array	Обязательно для редактирования	Изображения для редактирования. Multipart принимает `image`, `image[]` или `image[n]`
`mask`	file/string	Нет	Маска редактирования
`input_fidelity`	any	Нет	Точность входных данных, в зависимости от модели
`watermark`	boolean	Нет	Переключатель водяного знака, в зависимости от поддержки канала

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

curl https://api.tensoraxis.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TENSORAXIS_API_KEY" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "A minimalist poster of a futuristic city",
    "size": "1024x1024"
  }'

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

Используйте multipart form data при загрузке локальных файлов:

curl https://api.tensoraxis.com/v1/images/edits \
  -H "Authorization: Bearer $TENSORAXIS_API_KEY" \
  -F model="gpt-image-1" \
  -F prompt="Change the background to a night city" \
  -F image="@input.png"

Если выбранная модель это поддерживает, также можно использовать URL-адреса изображений в формате JSON:

{
  "model": "gpt-image-1",
  "prompt": "Change the background to a night city",
  "image": "https://example.com/input.png"
}

Формат ответа

{
  "created": 1710000000,
  "data": [
    {
      "url": "https://example.com/result.png",
      "b64_json": "",
      "revised_prompt": "..."
    }
  ]
}

Генерация видео не является API для работы с изображениями. Для видеомоделей Seedance / Doubao используйте тело асинхронной задачи в разделе Генерация видео.