Sozdai LogoDocs
Эндпоинты/Media

Создание медиазадачи

Постановка асинхронной задачи на генерацию медиа: изображение по тексту, видео по тексту, музыка. Ответ с идентификатором задачи приходит сразу, средства резервируются, а сама генерация идёт в фоне.

POSThttps://api.sozdai.ai/v1/media/generations

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

Во всех запросах ключ передаётся в заголовке Authorization.

http
Authorization: Bearer sk-corr-...

#Параметры запроса

ПараметрТипОбязательныйОписание
modelstringДаИдентификатор медиамодели, например gpt-image-2 или kling-video
promptstringДаТекстовое описание того, что нужно сгенерировать
...anyНетПрочие параметры конкретной модели — смотрите страницу нужной модели

#Пример запроса

bash
curl https://api.sozdai.ai/v1/media/generations \
  -H "Authorization: Bearer $CORRY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a futuristic city skyline in vaporwave style"
  }'

#Пример ответа

Возвращает идентификатор и статус только что созданной задачи.

json
{
  "id": "task_abc123",
  "status": "pending"
}

О опросе результата

Получив идентификатор задачи, опрашивайте эндпоинт статуса медиазадачи — он вернёт ссылки на результат. Как только status станет succeeded, в result.urls будут постоянные ссылки на файлы.