Входные медиа и загрузка

Передача HTTPS URL

json

{ "type": "https_url", "url": "https://cdn.example.com/input.mp4" }

URL должен использовать HTTPS, не содержать логин или пароль и оставаться доступным до завершения генерации.

1. Получение ссылки для загрузки

POST/v1/media-uploadsBearer key · generations:write

bash

curl --silent --show-error --fail-with-body \
  -X POST "https://api-platform.gensta.ai/v1/media-uploads" \
  -H "Authorization: Bearer $GENSTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"media_kind":"video","content_type":"video/mp4","size_bytes":123456}'

Ответ 201 содержит временный объект upload. Загрузите файл по указанным в нём URL и HTTP-методу, передав все полученные заголовки.

Тип	Форматы	Максимум
video	MP4, MOV	200 MiB
image	JPEG, PNG, WebP	менее 30 MiB
audio	MP3, WAV	15 MiB

Сигнатура файла должна совпадать с заявленным типом. Общая проверка допускает видео и аудио длительностью до 30 секунд, стороны до 6000 пикселей и изображения до 36 000 000 пикселей. У выбранной модели и режима могут быть более строгие ограничения — прочитайте operation_constraints из GET /v1/models. Анимированные и многостраничные изображения отклоняются.

2. Завершение и проверка

POST/v1/media-uploads/{id}/completeBearer key · generations:write

Повторный запрос на завершение безопасен и возвращает 202. Проверяйте GET /v1/media-uploads/{id} до статуса ready или failed.

3. Использование файла

json

{ "type": "media_asset", "media_asset_id": "7c74c900-8b68-4b0f-a337-32ed3a9a2020" }

Файл должен принадлежать тому же проекту, иметь статус ready и подходить для выбранного поля запроса.