v0 API: как создавать, дорабатывать и развёртывать приложения

Что на самом деле даёт v0 API

v0 API превращает запрос на обычном языке в работающее full-stack-приложение, а не просто предлагает фрагмент кода. Он генерирует код, запускает результат в Vercel Sandbox, предоставляет защищённое интерактивное превью и позволяет напрямую перейти к развёртыванию в Vercel.

Каждый чат v0 можно представить как отдельную закрытую мастерскую для одного приложения. ID чата служит ключом от этой мастерской. v0 читает, изменяет и запускает находящиеся в ней файлы, а каждый следующий запрос продолжает работу с текущего состояния. Например, если сначала попросить создать панель для разбора обращений, а затем добавить столбец ответственного, второй запрос изменит уже открытое на рабочем столе приложение.

Именно сохранение состояния делает этот цикл особенно полезным. Обычная модель для написания кода выдаёт текст, а запуск оставляет вам. v0 сам поднимает сервер разработки, проверяет работающий код и по ходу работы может находить и исправлять ошибки.

Новый API v2 построен вокруг четырёх понятных сущностей — разбираться во внутреннем устройстве для работы с ними не нужно:

• Чаты хранят текущие файлы приложения, метаданные, настройки приватности и связь с проектом Vercel.
• Сообщения содержат инструкции и историю. Их упорядоченные parts могут отражать текст, рассуждения, чтение и изменение файлов, поиск, команды оболочки, вызовы инструментов и действия агента.
• Превью — это запущенные сборки, защищённые краткосрочным токеном.
• Развёртывания отправляют текущее состояние чата в Vercel.

Поэтому старые примеры могут сбить с толку. В актуальном руководстве по v2 используется импорт из пакета v0. В прежних примерах для v1 импорт выполняется из v0-sdk, а ID чатов v1 несовместимы с v2.

Как использовать v0 API

Самый короткий и безопасный путь — поставить между своим интерфейсом и v0 небольшой серверный маршрут. Браузер отправляет промпт пользователя на ваш сервер. Сервер хранит API-ключ, обращается к v0, сохраняет полученный ID чата и возвращает только тот результат, который нужен интерфейсу.

1. Выберите подходящий способ интеграции

Есть три варианта:

1. Развернуть готовый интерфейс для генерации приложений командой npx create-v0-sdk-app.
2. Подключить серверный SDK к существующему продукту командой npm install v0.
3. Предоставить существующему агенту доступ через удалённый MCP-сервер v0: он использует OAuth, поэтому API-ключ не придётся указывать в конфигурации MCP.

Стартовый проект — самый быстрый способ увидеть всю схему целиком. В него входят чат-интерфейс на React, серверные прокси-маршруты, просмотр сгенерированных файлов, изолированное приложение для превью и навык агента v0.

2. Создайте ключ и храните его на сервере

Создайте API-ключ в настройках v0 и сохраните его в серверной переменной окружения V0_API_KEY. Не добавляйте ключ в браузерный код и не используйте для него префикс NEXT_PUBLIC_.

Локальную обёртку можно запустить командой npm run dev, но её серверные маршруты всё равно обращаются к облачному v0 API. Это локальная интеграция, а не локальная копия системы v0 для создания приложений.

3. Создавайте отдельный чат для каждого приложения

Первый вызов одновременно начинает диалог и создаёт рабочее пространство приложения:

import { v0 } from 'v0'

const created = await v0.chats.create({
  message: 'Build an issue triage app for a support team.',
})

if (created.error) throw new Error(created.error.message)
const chatId = created.data.chat.id

const changed = await v0.messages.send({
  chatId,
  message: 'Add a priority filter and an assignee column.',
})

if (changed.error) throw new Error(changed.error.message)

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

Начинать с пустого промпта необязательно. Чат можно создать на основе репозитория GitHub, ZIP-архива или набора файлов.

4. Определите, как получать результат

Синхронный вызов подходит, если вызывающая сторона может дождаться готового результата. Асинхронный — для скриптов, вебхуков и CI-задач, которым нужно поставить работу в очередь и проверить её позже. Потоковый режим нужен, когда за процессом следит человек, а интерфейс должен показывать, как агент читает файлы, изменяет код, выполняет команды и сообщает о ходе работы.

Ответы на запросы к чатам и сообщениям содержат данные об использовании, поэтому после завершения каждой задачи можно записывать количество токенов и стоимость в кредитах.

5. Проксируйте превью, не открывайте его напрямую

API возвращает URL превью и краткосрочный токен. Браузерный iframe не может безопасно прикрепить этот токен самостоятельно, поэтому рекомендованная архитектура направляет запросы iframe через подконтрольный вам серверный прокси.

Размещайте прокси на отдельном сайте для превью с другим регистрируемым доменом, не совпадающим с доменом основного приложения. Сгенерированные превью могут выполнять недоверенный код. Кроме того, прокси обязан аутентифицировать текущего пользователя и проверять его право доступа к запрошенному чату. Вспомогательный модуль v0 для превью не выполняет такую авторизацию за вас.

6. Развёртывайте приложение только после собственных проверок

Когда приложение готово, вызов v0.chats.deploy({ chatId }) разворачивает текущее состояние чата в Vercel. Переменные окружения относятся к подключённому проекту Vercel и управляются через Vercel API, поэтому учётные данные базы данных и ключи сторонних сервисов нужно настраивать отдельно и осознанно.

Сколько стоит v0 API

v0 списывает кредиты, а не устанавливает единую цену за каждое сгенерированное приложение. Во входные токены входят промпт, загруженные материалы, история чата, исходные файлы и другой контекст, который читает v0. Выходные токены — это то, что генерирует агент. Поэтому по мере роста истории и кодовой базы долгие чаты могут обходиться дороже.

Тариф Free стоит $0 в месяц, включает $5 ежемесячных кредитов и ограничивает использование семью сообщениями в день. Plus стоит $30 за пользователя в месяц, а Business — $100 за пользователя в месяц; оба тарифа включают $30 ежемесячных кредитов на пользователя. Когда доступные кредиты заканчиваются, генерация приостанавливается.

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

Семь сценариев использования — от самых выгодных

Лучше всего v0 работает внутри уже существующего процесса, где продукт знает пользователя, его данные и тип приложения, которое требуется создать.

Если вы решаете, нужен ли вам v0 как внутренний движок или как готовый продукт целиком, сравните его с лучшими ИИ-конструкторами приложений 2026 года. Разница существенна: API полезен, когда вы хотите сами контролировать взаимодействие с клиентом, правила, оплату и проверку результата.

Три продукта, которые стоит создать

Спрос есть, но рынок универсальных конструкторов приложений уже переполнен. Возможность заключается не в очередном пустом поле для промпта, а в конструкторе, который особенно хорошо решает одну ценную задачу.

1. Лучший вариант: отраслевой конструктор внутри существующего SaaS

Создайте специализированный генератор для одной профессии и продавайте его как дополнение к программе, которой эти клиенты уже пользуются. Платформа для управления недвижимостью могла бы генерировать кабинеты владельцев, логистическая платформа — панели отклонений при доставке, а франчайзинговая — трекеры открытия новых точек.

Спрос достаточно велик, чтобы поддерживать целую категорию. Запрос ai app builder набирает около 12,100 поисков в Google по США в месяц, а набор данных показывает годовой рост на 50%. Пользователи обращаются к ИИ-ассистентам с запросом build an app with ai примерно 392 раза в месяц — против 231 в августе 2025 года, то есть рост составляет около 70%. Существующие конструкторы приложений уже берут от $16 до $160 в месяц, а значит, покупатели готовы регулярно платить за такую программу.

Минимальной версии, которую уже можно продавать, нужны два или три утверждённых типа приложений, структурированная форма сбора требований, отдельный чат v0 для каждого клиентского приложения, экран потокового просмотра, безопасный прокси для превью и кнопка развёртывания под контролем человека. Защиту от конкурентов обеспечивают модель данных, права доступа, шаблоны и каналы распространения основного продукта.

Недостаток суров, но показателен: у универсальной обёртки почти нет конкурентной защиты. Если нельзя объяснить, что продукт знает о работе клиента такого, чего не знает сам v0, создавать его не стоит.

2. White-label-конструктор сайтов и кампаний для агентств

Предложите агентству брендированную форму сбора требований, фиксированный набор типов страниц, собственный навык дизайн-системы, очередь правок и передачу результата на развёртывание. Клиенты будут взаимодействовать с продуктом под брендом агентства, а v0 возьмёт на себя рабочее пространство приложения и интерактивное превью.

Запрос ai website builder набирает около 40,500 поисков в Google по США в месяц, а годовой рост в наборе данных составляет 49%. Это крупнейший заметный сегмент спроса в рамках исследования — и одновременно признак того, что на рынке уже много сильных конкурентов. Перспективная ниша — не «создать любой сайт», а «создать сайт, типичный для этого агентства, на этом стеке, с этими компонентами и по этому процессу согласования».

Для MVP достаточно одной конфигурации бренда, трёх шаблонов страниц, загрузки материалов, комментариев к превью и утверждения развёртывания. Главная сложность — поддержка: если сгенерированный текст, макет, доступность или интеграции потребуют исправлений, клиент будет оценивать агентство, а не v0.

3. Бот, который превращает запрос на новую функцию в превью

Превращайте одобренную задачу в работающий вариант изменения. GitHub App или внутренний вебхук импортирует репозиторий, запускает асинхронный чат v0, сохраняет ID чата и публикует превью обратно в задаче. Перед слиянием или развёртыванием результат проверяет человек.

Google фиксирует около 390 поисков в месяц по США для запроса how to build an app with ai, а набор данных показывает годовой рост на 86%. Количество ежемесячных запросов build an app with ai к ИИ-ассистентам достигло 392 в июле 2026 года. Это подтверждает интерес к полноценным работающим приложениям, но не доказывает существование отдельного рынка CI-решений. Такой продукт разумнее развивать как функцию для команд или дополнение к платформе разработчиков, а не как массовый самостоятельный сервис.

MVP включает вебхук, список разрешённых репозиториев, обработчик асинхронных задач, хранилище чатов v0, изолированное превью и статус утверждения. Главная сложность — риски. Код сгенерированного превью не заслуживает доверия, доступ к репозиторию чувствителен, а убедительная демонстрация ещё не доказывает корректность тестов, безопасности, миграций и пограничных сценариев. Никогда не делайте развёртывание в продакшен действием по умолчанию.

Чтобы увидеть место v0 среди агентов для программирования и инструментов, превращающих промпт в приложение, изучите лучшие инструменты для вайб-кодинга 2026 года.

Чего v0 API не решает

API предоставляет агента-разработчика и его рабочее пространство. Всё окружение продукта по-прежнему остаётся вашей ответственностью.

• Он не решает, что именно нужно создать. Из расплывчатого запроса всё равно может получиться безупречно оформленное, но не то приложение. Поэтому важны форма сбора требований, шаблоны, ограничения и этапы проверки.
• Он не авторизует ваших клиентов. Вспомогательный модуль превью передаёт трафик, но именно ваше приложение должно решать, кому доступен каждый чат.
• Он не делает сгенерированный код доверенным. Отдавайте превью с отдельного сайта на другом регистрируемом домене и проверяйте код до его выхода в продакшен.
• Он не переносит чаты v1 в v2. Выберите версию в v1, скачайте её в ZIP-архиве и создайте из этого состояния новый чат v2.
• Он не заменяет Vercel API. Переменные окружения и некоторые операции с проектом относятся к подключённому проекту Vercel.
• Он не фиксирует стоимость. На расход токенов влияют исходные файлы, история диалога, промпты и вывод.
• Он не является локальным движком для создания приложений. Интеграцию можно запустить локально, но описанный процесс обращается к облачному API v0, а превью выполняются в инфраструктуре Vercel.

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

Если вашей компании нужен надёжный конструктор на базе v0, я создаю готовые к продакшену ИИ-системы.