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

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

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

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

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

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

Подробнее — [особенности моделей](/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.