v0의 새 API가 정식 출시됐다. 프롬프트를 전송하면 v0가 앱을 생성하고, Vercel Sandbox에서 개발 서버를 실행한 뒤 미리보기 URL을 반환한다. TypeScript SDK, MCP, AI SDK, eve 세 가지 에이전트 연결 방식을 제공해 기존 에이전트 파이프라인에 앱 빌더를 도구로 붙일 수 있다.
핵심 포인트- chat 단위로 앱 상태를 관리 — 생성부터 파일 수정, 오류 자동 수정까지 한 chat 안에서 반복
- sync / async / streaming 세 가지 호출 방식 지원 — 완료 대기, 비동기 큐잉, 실시간 스트림 선택 가능
- MCP·AI SDK·eve 세 가지 에이전트 연결 방식 제공 — IDE, TypeScript 에이전트 루프, OpenAPI 연결 각각 지원
- Design Systems 2.0의 skill 기능으로 커스텀 컴포넌트·토큰을 chat에 주입해 앱 생성 가능
- v0.chats.deploy 한 번으로 preview chat을 Vercel prod 배포로 승격 가능
상세 정리- API 기본 구조: v0 SDK 설치 후 v0.chats.create({ message }) 로 chat 생성 → chatId 반환 → 이후 v0.messages.send({ chatId, message }) 로 연속 빌드
- Sandbox 통합: v0가 Vercel Sandbox에서 dev server를 실행하며 코드 오류를 실시간 감지·수정하는 피드백 루프를 내장함
- preview 임베딩: chat마다 단명 preview token 발급 → 서버에서 토큰 fetch 후 브라우저 요청을 proxy — API 키가 클라이언트에 노출되지 않는 구조
- 스트리밍: v0.messages.sendStream으로 텍스트·파일 편집·bash 명령·에이전트 액션 등의 part 스트림을 실시간 수신. usage도 함께 반환돼 비용 추적 가능
- 비동기 모드: createAsync가 chatId/messageId를 즉시 반환 → 나중에 poll하거나 webhook으로 결과 수신
- 기존 코드 연결: repo URL, ZIP, 파일 셋을 createFromRepo로 chat에 붙여 기존 앱 베이스에서 이어 빌드 가능
- MCP 연결: mcpServers 설정에 url 하나 추가로 IDE·에이전트 런타임에서 v0를 도구로 사용 가능. 첫 연결 시 OAuth 흐름
- AI SDK 연결: @v0-sdk/ai-tools로 TypeScript 에이전트 루프 안에 chats/messages 연산을 tool로 노출. OpenAI·Claude 등 모델과 조합 가능
- eve 연결: OpenAPI connection 파일에 spec URL과 허용 operation 목록만 정의하면 eve가 API 키를 모델 컨텍스트 밖에서 주입
- 디자인 시스템: team/user memory에 저장된 skill을 skills 배열로 전달하면 해당 컴포넌트·토큰 사용 앱 생성
- Vercel 배포: createVercelProject로 프로젝트 생성 → deploy로 chat 상태를 prod 배포로 승격 — 환경변수·integration은 Vercel API로 관리
- 마이그레이션 주의: 구버전 API chat은 v2와 호환 안 됨. ZIP 다운로드 후 새 chat 생성 필요. base URL이 v2로 변경, 버전 워크플로우 → chat 파일 워크플로우로 대체
왜 읽나AI 에이전트 또는 SaaS 제품에 앱 빌더 기능을 임베드하거나 자동화 파이프라인에서 앱 생성을 연결하려는 개발자에게 실전 API 설계와 에이전트 연동 패턴을 제공한다.
Vercel Blog·
원티드랩·
Cloudflare Blog·