Медиа: входы и результат

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

1. Определите, что хотите получить: изображение, видео, аудио или 3D.
2. Выберите модель в каталоге Studio и проверьте, какие исходные материалы она принимает.
3. Добавьте файлы в подходящие поля. Проверьте их порядок и выбранный режим.
4. Проверьте настройки и стоимость, затем дождитесь готового результата.
5. Откройте и скачайте результат. Сбой передачи файла не требует повторной платной генерации.

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

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

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

Подробнее — особенности моделей и права проекта.

Аудио и 3D

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

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

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

Если хотите продолжить прежнюю задачу, используйте «Повторить» и проверьте восстановленные файлы. При ошибке сначала прочитайте отмену и восстановление.

Дальше: выбрать модель или загрузить исходный файл.

Для 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. Аудио-URL входа avatar/lipsync и сгенерированная аудиозадача — разные сущности.

3D имеет генерацию по тексту/изображениям и отдельные processing операции. Входы, форматы, topology/texturing/rigging зависят от model-operation. Не переносите Meshy-параметры на другое семейство; смотрите mesh catalog, 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, проверьте исключения входов, получите estimate и сохраните task_id.