Skip to main content
POST
Выполнить операцию над медиа

Операции над медиа

После генерации медиа контента можно выполнять дополнительные операции:

Синхронные vs Асинхронные операции

Синхронные операции (upscale)

Результат возвращается сразу в поле data:

Асинхронные операции (extend)

Создаётся новая генерация со статусом pending:
Для получения результата используйте GET /v1/media/ с новым ID.

Параметр async

  • async: false (по умолчанию) — ждёт результат до 120 секунд
  • async: true — сразу возвращает ID новой генерации

Примеры

Продление видео (extend)

Увеличение разрешения (upscale)

Параметры операции extend

Операция extend создаёт новую генерацию с новым ID. Оригинальное видео не изменяется.

Авторизации

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

API ключ передаётся в заголовке: Authorization: Bearer <POLZA_AI_API_KEY>

Параметры пути

id
string
обязательно

Тело

application/json
operation
enum<string>
обязательно

ID операции

Доступные опции:
extend,
upscale_1080p,
upscale_4k
Пример:

"extend"

params
object

Параметры операции. Зависят от типа операции.

Пример:
async
boolean
по умолчанию:false

Асинхронный режим. При true сразу возвращает ID операции, результат получить через GET /v2/media/:id

Пример:

false

Ответ

id
string
обязательно

Уникальный идентификатор генерации

Пример:

"gen_581761234567890123"

object
string
обязательно

Тип объекта

Пример:

"media.generation"

status
enum<string>
обязательно

Статус генерации

Доступные опции:
pending,
processing,
completed,
failed,
cancelled
Пример:

"pending"

created
number
обязательно

Временная метка создания (Unix timestamp)

Пример:

1703001234

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

ID модели, которая генерирует контент

Пример:

"google/gemini-2.5-flash-image"

completed_at
number

Временная метка завершения (Unix timestamp)

Пример:

1703001244

data

Данные сгенерированного контента

usage
object

Информация об использовании ресурсов

error
object

Информация об ошибке (если failed)

content
string

Текстовый ответ модели (если вернула текст вместо/вместе с изображением)

Пример:

"Банан и яблоко — это фрукты."

reasoning_summary
string

Краткое резюме рассуждений модели

Пример:

"Preparing image generation prompt with camera settings..."

warnings
string[]

Предупреждения (неподдерживаемые параметры и т.д.)

Пример: