v0의 앱 빌딩 에이전트에 프로그래밍 방식으로 접근할 수 있는 헤드리스(headless) 인터페이스, v0 API를 공개합니다. 프롬프트를 전송하면 v0가 앱을 생성하고 Vercel Sandbox에서 개발 서버를 실행한 뒤, 원하는 UI에 바로 임베드할 수 있는 미리보기 URL을 반환합니다.
오늘 v0 API를 공개합니다. v0의 앱 빌딩 에이전트에 프로그래밍 방식으로 접근할 수 있는 헤드리스 인터페이스입니다. 프롬프트를 전송하면 v0가 앱을 생성하고 Vercel Sandbox에서 개발 서버를 실행한 뒤, 원하는 UI에 바로 임베드할 수 있는 미리보기 URL을 반환합니다.
각 채팅은 앱 하나를 위한 독립된 작업 공간으로, v0가 파일을 읽고 수정하고 실행할 수 있습니다. 후속 메시지는 현재 상태에서 이어집니다. v0는 샌드박스에서 실행 중인 코드를 직접 검증하기 때문에, 앱 오류를 실시간으로 감지하고 수정할 수 있습니다.
새 API는 현재 퍼블릭 베타로 제공됩니다.
내 인터페이스에서 바로 채팅을 시작하고, 작업 과정을 스트리밍하며, 라이브 미리보기를 렌더링할 수 있습니다. 먼저 v0 SDK를 설치하세요.
다음으로 채팅을 생성합니다. 프롬프트를 전송하면 v0가 앱을 만들어 냅니다.
같은 채팅에 후속 메시지를 보내면 앱 개발을 이어갈 수 있습니다. 매 메시지는 현재 상태에서 연속적으로 진행됩니다.
이제 앱을 임베드하세요.
프롬프트를 넣으면 실행 중인 앱이 나옵니다. 샌드박스, 개발 서버, 미리보기는 v0가 알아서 처리합니다. 준비가 되면 API 호출 한 번으로 Vercel에 배포할 수 있으며, 전체 파이프라인은 v0가 관리합니다.
새 API를 활용하면 v0의 앱 빌더를 내 제품이나 파이프라인 안에서 직접 실행할 수 있습니다. 대표적인 활용 사례는 다음과 같습니다.
화이트 레이블 앱 빌더: 사용자가 원하는 앱을 설명하면 내 제품 안에서 바로 완성된 앱을 받아볼 수 있습니다.
앱 자동 변경: 스크립트, CI 작업, 또는 웹훅으로 v0를 트리거해 새 앱을 생성하거나 기존 앱을 업데이트합니다.
에이전트용 빌드 도구: 에이전트가 코드 스니펫 대신 동작하는 앱을 직접 반환합니다.
아래에서 이 워크플로를 구성하는 API 기본 요소들을 자세히 살펴보겠습니다.
채팅 하나가 곧 앱 하나의 상태를 담으며, 하나의 리포지토리나 Vercel 프로젝트에 여러 채팅을 연결할 수 있습니다. 각 채팅의 ID를 저장해두고, 이후 메시지를 보낼 때 해당 ID를 사용하세요. 채팅 메타데이터를 활용하면 고객, 워크스페이스, 앱, 또는 제품에서 이미 사용 중인 키 기준으로 채팅을 그룹화할 수 있습니다.
메시지에 대해 자세히 알아보기
요청을 전송한 뒤 미리보기가 업데이트되기까지의 과정을 인터페이스에서 보여줄 수 있어야 합니다.
모든 메시지에는 순서가 있는 parts이 포함됩니다. 텍스트, 사고 과정, 파일 읽기 및 편집, 검색, bash 명령, 툴 호출, 에이전트 액션 등이 여기에 해당합니다. 같은 객체로 한 줄짜리 상태 표시, 변경된 파일 목록, 또는 전체 트레이스 뷰를 모두 구현할 수 있습니다.
사용량은 채팅 및 메시지 응답과 함께 반환되므로, 작업이 완료된 후 처리량을 정확히 집계할 수 있습니다.
채팅 생성과 메시지 전송은 동기, 비동기, 스트리밍 응답을 모두 지원합니다. 호출자가 완료된 응답을 즉시 받아야 할 때는 동기 방식을 사용하세요. 작업을 큐에 넣고 나중에 웹훅으로 업데이트를 받거나 직접 폴링하려면 비동기 방식을 선택하세요. v0의 작업 과정을 실시간으로 렌더링하려면 스트리밍을 사용하면 됩니다.
리포지토리, ZIP 아카이브, 또는 파일 세트를 기반으로 채팅을 시작할 수도 있습니다.
각 채팅에는 단기 미리보기 토큰이 발급됩니다. 서버 라우트에서 토큰을 가져와 브라우저 요청을 프록시로 전달하면, v0 API 키가 브라우저에 노출되지 않습니다. 미리보기가 준비되면 트래픽이 해당 미리보기로 포워딩되고, 샌드박스가 기동 중일 때는 요청이 로딩 라우트로 폴백됩니다. iframe을 프록시 라우트로 연결하고, 만료 전까지 미리보기 정보를 캐시해두세요.
문서에서 미리보기 접근 방법을 자세히 확인하세요.
특정 MCP 서버를 채팅에 활성화하거나, 기본값을 그대로 사용할 수 있습니다.
Design Systems 2.0은 디자인 시스템을 스킬로 저장합니다. 요청에 포함하면 해당 컴포넌트, 토큰, 설정, 스타터 앱이 함께 로드됩니다.
요청당 최대 세 개의 스킬을 전달할 수 있으며, 팀 또는 사용자 메모리, skills.sh, 연결된 리포지토리에서 가져오거나, 에이전트가 팀 스킬을 자동으로 불러오도록 설정할 수도 있습니다.
에이전트를 개발 중이라면 v0를 도구로 제공하세요. 텍스트 답변이나 코드 대신 실제 앱이 필요한 작업이 생기면, 에이전트가 v0를 호출해 채팅을 생성하거나 이어가고, 필요한 질문이나 승인을 처리한 뒤 실행 중인 미리보기나 배포 결과를 받아옵니다. 코드와 런타임은 v0가 샌드박스 안에서 처리하고, 에이전트는 워크플로와 최종 응답에 대한 제어권을 유지합니다.
연결 방법은 세 가지입니다.
MCP를 지원하는 IDE, 데스크톱 어시스턴트, 또는 에이전트 런타임에 v0 MCP 서버를 연결하세요.
최초 연결 시 OAuth 플로가 시작됩니다. MCP 서버는 채팅 생성, 채팅 목록 조회, 채팅 상세 조회, 메시지 목록 조회 및 전송, 대기 중인 작업 처리, 미리보기 URL 조회를 위한 도구를 제공합니다.
AI SDK로 TypeScript 에이전트를 개발 중이라면 @v0-sdk/ai-tools를 사용해 v0의 API 작업을 에이전트 루프 안에서 도구로 노출할 수 있습니다.
채팅을 생성하거나 이어갈 시점은 에이전트가 판단합니다. AI SDK 실행 흐름은 오케스트레이션과 최종 응답에 대한 제어권을 유지합니다.
eve 에이전트를 사용하는 경우, OpenAPI 연결 파일을 추가하세요. eve는 허용된 작업을 도구로 변환하고, 모델 컨텍스트 외부에서 실행 시점에 API 키를 자동으로 연결합니다.
채팅을 위한 Vercel 프로젝트를 생성하고, 환경 변수, 인테그레이션, 설정은 Vercel API로 관리하세요. 앱에는 엔터프라이즈급 보안 및 옵저버빌리티 도구가 기본으로 포함됩니다.
배포 준비가 되면 채팅을 Vercel에 배포하세요.
이전 버전 v0 API의 채팅은 새 API에서 그대로 실행되지 않으므로 마이그레이션이 필요합니다. 유지하고 싶은 버전을 선택해 ZIP으로 다운로드한 뒤, 해당 ZIP으로 새 채팅을 생성하세요. 추적이 필요하다면 기존 식별자를 새 채팅의 메타데이터에 저장해두세요.
전체 매핑은 마이그레이션 가이드를 참고하세요. 주요 변경 사항은 다음과 같습니다.
새 요청에는 https://api.v0.dev/v2 을 사용하세요.
채팅은 앱의 현재 상태를, 메시지는 히스토리를 담습니다.
버전 워크플로는 채팅 파일 워크플로로, v0 프로젝트 조직 체계는 채팅 메타데이터로 대체하세요.
프로젝트 작업에는 vercelProjectId 와 Vercel API를 함께 사용하세요.
최종 텍스트만이 아닌 메시지 parts도 렌더링하세요.
v0 설정에서 API 키를 발급받고 SDK를 설치하세요.
또는 전체 앱을 스캐폴딩할 수도 있습니다.
문서와 마이그레이션 가이드를 확인하세요.
