Входные файлы

Как передать изображения, видео и аудио.

Файлы передаются ссылками в полях image_url, end_image_url, image_urls, video_url, video_urls, audio_urls.

Публичная ссылка

Любая ссылка https, которая открывается без входа. Мы скачиваем файл сами. Ограничения:

Вид	Размер	Форматы
Изображения	до 20 МБ, до 100 мегапикселей	JPEG, PNG, WebP, HEIC
Видео	до 200 МБ	MP4, MOV (WebM модели не принимают)
Аудио	до 50 МБ	MP3, WAV, M4A; AAC, OGG и FLAC принимаются и перекодируются в MP3

Загрузка к нам

Если файла нет по публичной ссылке, загрузите его:

bash

# 1. Получите адрес загрузки
curl https://api.outsee.io/v1/files \
  -H "Authorization: Bearer $OUTSEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "content_type": "image/jpeg", "filename": "hero.jpg", "size_bytes": 482133 }'

size_bytes — точный размер файла в байтах. Он входит в подпись адреса загрузки: файл другого размера хранилище не примет.

json

{
  "id": "file_1842",
  "file_url": "https://outsee.io/f/u1842-…",
  "upload": { "url": "https://…", "method": "PUT", "headers": { "Content-Type": "image/jpeg", "Content-Length": "482133" }, "expires_at": "…" }
}

bash

# 2. Загрузите файл по адресу upload.url (curl сам поставит Content-Length по размеру файла)
curl -X PUT "$UPLOAD_URL" -H "Content-Type: image/jpeg" --upload-file hero.jpg

Дальше передавайте file_url в поле запроса. Адрес загрузки действует час, загруженный файл хранится 30 дней. content_type — один из: image/jpeg, image/png, image/webp, image/heic, video/mp4, video/quicktime, audio/mpeg, audio/wav, audio/mp4, audio/aac, audio/ogg, audio/flac.

Готовые результаты

Ссылку на готовый ролик (output.video.url) можно передать во вход другого запроса — например, чтобы продолжить или поправить ролик.

Референсы в промпте

В режимах reference-to-video на файлы ссылаются по порядку: «женщина с изображения 1», «движение камеры как в видео 1». Порядок — как в массиве.