# Медиа: входы, ограничения и результат

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

1. Определите, что хотите получить: изображение, видео, аудио или 3D.
2. Выберите модель в [каталоге Studio](/knowledge/models/) и проверьте, какие исходные материалы она принимает.
3. [Добавьте файлы](/docs/knowledge/guides/studio-files.md) в подходящие поля. Проверьте их порядок и выбранный режим.
4. Проверьте настройки и стоимость, затем дождитесь готового результата.
5. Откройте и скачайте результат. Сбой передачи файла не требует повторной платной генерации.

## Изображения и видео

Количество и назначение референсов зависят от модели. Референс — исходный материал, на который должна ориентироваться генерация; он не всегда означает режим редактирования.

Для Seedance ширина и высота каждого входного изображения должны быть не меньше **300 px**. Например, файл 270×618 или 480×270 px не подходит; выберите изображение большего размера. Проверка выполняется до платного запуска, маленькие изображения провайдеру не отправляются.

Для Wan 3 и Wan 3 Prime изображения должны иметь стороны 240–8000 px, соотношение не более 8:1 и размер до 20 МБ. Видеореференсы: 1–15 секунд каждый, стороны 240–4096 px, до 100 МБ; не более пяти роликов и 15 секунд суммарно. Входное видео и результат вместе — до 30 секунд. Аудиореференсы: 1–15 секунд каждый, до 15 МБ; не более пяти файлов и 15 секунд суммарно. Эти ограничения проверяются по файлу до списания; если прочитать метаданные не удалось, запуск останавливается с отдельной ошибкой.

Для видеореференсов Seedance 2.5 каждая сторона кадра должна быть 300–6000 px, а площадь кадра — от 407696 до 8295044 пикселей. Соотношение ширины к высоте — от 0,4 до 2,5. Например, 640×360 px не подходит, хотя обе стороны больше 300 px. Неподходящий размер отклоняется до платного запуска.

Nano Banana 2 принимает до **10** изображений-референсов. У Nano Banana 2.1 отдельный лимит — до **14**. Лишние референсы нужно убрать самостоятельно: приложение не удаляет их молча при отправке.

Сообщение о невозможности прочитать файл само по себе не означает проблему iCloud. Если выбранный файл больше недоступен в текущей вкладке, выберите его заново. Для файла из облака сначала сохраните копию на устройство. Оставшиеся входные файлы сохраняются на время уже начатой отправки, даже если окно выбора закрыто.

При загрузке видео неподдерживаемые кодеки, например ProRes в MOV, преобразуются на сервере в MP4 с H.264. Если старый видеореференс отклонён из-за кодека, загрузите исходный файл заново. При ошибке чтения длительности провайдером приложение сообщает, что проблема относится к видеореференсу.

Если выбран сценарий с начальным и последним кадром, последний кадр требует начального. Возможность использовать звук, видео или несколько изображений проверяйте в выбранной модели, а не по сходству с другой. Для элемента персонажа нужно не только выбрать его в библиотеке, но и указать его имя через @ в промпте; элемент должен быть доступен в выбранном проекте.

Подробнее — [особенности моделей](/docs/knowledge/guides/model-specific-settings.md) и [права проекта](/docs/knowledge/guides/projects-and-roles.md).

## Аудио и 3D

Для музыки, речи и других аудиозадач выбирайте подходящую модель в [Аудио](/audio/). Аудиофайл, который вы добавляете к видео или аватару, — входной материал, а не новая задача создания аудио.

Результат зависит от выбранной операции: это может быть звук, видео или текст. Перед запуском проверьте описание результата выбранной модели.

В [3D](/3d/) различаются создание модели по тексту или изображениям и обработка готовой модели. Доступные форматы, текстуры и анимация зависят от выбранной операции. Не переносите настройки одного семейства на другое без проверки.

Если хотите продолжить прежнюю задачу, используйте [«Повторить»](/docs/knowledge/guides/repeat-and-settings.md) и проверьте восстановленные файлы. При ошибке сначала прочитайте [отмену и восстановление](/docs/knowledge/questions/cancellation-and-recovery.md).

Дальше: [выбрать модель](/knowledge/models/) или [загрузить исходный файл](/storage/).

## Для API, CLI и MCP

Число и роль референсов, start/end/audio slot и длительность определяются конкретным продуктом. Последний кадр в first/last-frame сценарии требует начальный. Облачный reference URL не превращает модель автоматически в edit или ref2v. Для элемента персонажа нужны @name в промпте и доступный проект.

Audio API включает музыку, речь, клонирование и другие объявленные операции, а не только Suno. Текущий default audio slug: `suno-v6`; проверяйте конкретный запрос по [audio catalog](/docs/models/audio/index.md). Аудио-URL входа avatar/lipsync и сгенерированная аудиозадача — разные сущности.

3D имеет генерацию по тексту/изображениям и отдельные processing операции. Входы, форматы, topology/texturing/rigging зависят от model-operation. Не переносите Meshy-параметры на другое семейство; смотрите [mesh catalog](/docs/models/mesh/index.md), estimate и доступные поля.

Тип результата audio проверяйте по операции и `output_kind`: это может быть audio, video или text. Для медиа нужны пригодные URL результата; текст возвращается в текстовых `artifacts`, а не как обязательная ссылка на аудиофайл. Асинхронные Audio/mesh задачи ожидайте через polling; не обещайте для них webhook по аналогии с image/video. Upscale и SwitchX — отдельные операции со своими входами, а не универсальные image models.

### Незавершённые возможности

Typed trim/concat виден в контракте, но production media operations пока WIP и возвращает MEDIA_OPERATIONS_WIP до включения feature flag. Наличие инструмента или метода в документации не подтверждает доступность функции в вашем окружении.

Перед отправкой выберите точную [карточку API](/docs/models/index.md), проверьте исключения входов, получите estimate и сохраните task_id.