Windsurf теперь умеет генерировать видео
Windsurf уже работает в вашем редакторе. С помощью DreamUtopia REST API та же сессия может превратить фотографию продукта в короткий клип, анимировать портрет или связать готовое изображение с видео по первому кадру. Вставьте один файл навыка, задайте вопрос на простом английском, и агент выполнит загрузку, запрос и опрос статуса. Вы продолжаете работать в том же диалоге, пока рендеринг выполняется на наших серверах.
Генерация видео в Windsurf без выхода из редактора
Генерация видео в Windsurf становится обычной частью сессии программирования, когда агент может напрямую вызывать медиа-API. Агенты для программирования хорошо справляются с выполнением команд, чтением JSON-ответов и повторными попытками с рассуждением — именно это и нужно API преобразования изображения в видео. Вместо того чтобы покидать редактор и открывать веб-приложение, вы можете попросить Windsurf превратить ./photo.png в пятисекундный клип 720p и получить подписанный URL результата обратно в том же разговоре. Именно по этой причине мы создали DreamUtopia API как обычный REST. Здесь нет MCP-сервера для настройки и нет плагина для установки. Один файл навыка учит агента базовому URL, заголовку аутентификации, multipart-загрузке референсных изображений, эндпоинту создания видео, общему эндпоинту задания и правилам терминальных состояний. Один вставленный навык и одна переменная окружения — это вся настройка. Тот же ключ также работает из ваших собственных скриптов, поэтому агент и ваш конвейер сборки используют одну интеграцию и один баланс кредитов. Задание видео выполняется медленнее, чем задание изображения, обычно от одной до трёх минут, поэтому цикл опроса имеет значение. Навык велит агенту ждать с экспоненциальной задержкой, останавливаться при терминальной ошибке и никогда не повторять попытку при отказе по политике контента или при пустом балансе. Он также различает задание, которое всё ещё в очереди, и задание, которое перестало продвигаться. Это различие — разница между спокойным ожиданием и штормом повторных попыток. Цикл опроса, который повторяет попытки без разбора, может израсходовать лимит до завершения первого рендера, тогда как цикл, который останавливается слишком рано, бросает задание, которое всё ещё продвигалось. Для репозитория, который поставляет медиа вместе с кодом, практическая выгода в том, что человек, пишущий компонент, также может создать нужный для него клип, не теряя контекста изменения и не копируя файлы между инструментами. Агент может объяснить неудачный рендер тем же голосом, которым он пользуется для падающего теста, и может хранить результат рядом с кодом, который на него ссылается.
Что вы получаете
Один навык копирования и вставки
Вставьте блок навыка ниже в чат Windsurf. Агент следует рецепту на протяжении всего дальнейшего разговора без дополнительных подсказок. Текст достаточно короткий, чтобы прочитать его за один раз, и достаточно конкретный, чтобы агент не импровизировал с именами полей. В нём указаны точные значения, которые принимает каждое поле, поэтому некорректный запрос исправляется до того, как достигнет API. Ничего не записывается в ваш репозиторий и ничего не устанавливается.
Локальные фотографии обработаны
Попросите агента использовать файл в проекте. Он отправляет multipart-загрузку, получает upload id и использует этот id как первый кадр. Принимаются JPEG, PNG и WebP размером до 30 МБ. Файлу в репозитории никогда не нужен предварительный публичный URL, что избавляет приватные снимки продуктов от отдельного шага хостинга.
Каждый формат видео
Преобразование изображения в видео, преобразование текста в видео и переходы от первого к последнему кадру используют один ключ. Выберите 480p, 720p или 1080p и длительность от пяти до пятнадцати секунд. Уровень Lite ограничен 720p и десятью секундами; Medium и Pro достигают 1080p и пятнадцати секунд. Навык считывает эти ограничения из актуального списка моделей, а не угадывает их.
Работа, которая переживает чат
Каждый рендер выполняется на наших серверах. Если сеанс завершается, агент может перечислить последние задания по id и забрать результат позже. Подписанная ссылка остаётся действительной семь дней — достаточно долго, чтобы скачать файл или скопировать его в артефакт сборки. Неудачное задание сохраняет свой код ошибки, поэтому следующий сеанс сможет объяснить, что произошло. Забрать результат позже также безопаснее, чем держать терминал открытым несколько минут, пока рендер завершается, особенно на удалённой машине или при нестабильном соединении.
Простое описание движения
Опишите кадр, а не API: медленный наезд, смещение вправо, волосы, развевающиеся на ветру. Навык сопоставляет ваши слова с уровнем модели, разрешением, длительностью и соотношением сторон, а затем проверяет актуальную матрицу цен, прежде чем потратить средства. Вы по-прежнему можете указать точные настройки, когда задача этого требует, а агент сообщает выбранные им настройки, чтобы неожиданный результат было проще диагностировать. Неоднозначный запрос разрешается одним уточняющим вопросом вместо спекулятивного рендера, который тратит кредиты на неверную длительность.
Один прайс-лист
API и веб-приложение списывают одинаковые кредиты. GET /v1/models возвращает актуальную матрицу разрешений, длительности и кредитов, так что агент может сравнить пятисекундный клип с десятисекундным, прежде чем что-либо создавать. Кредиты списываются при создании задачи и автоматически возвращаются в случае неудачи.
Другие инструменты
Выберите инструмент для следующего шага.
Дайте Windsurf инструмент для работы с видео
Создайте ключ, вставьте навык и запросите свой первый клип. Документация API охватывает каждое поле, статус и код ошибки.

