v0新API发布
内容提要
v0发布新API，允许开发者以编程方式调用其应用构建代理。用户发送提示词即可生成应用，并在Vercel沙箱中运行，获得可嵌入的预览URL。API支持同步、异步和流式响应，可从现有代码库创建聊天，并支持MCP、AI SDK和eve等代理集成。该API处于公开测试阶段，可构建白标应用生成器或自动化应用修改。
延伸解读
API 的三种响应模式
新 API 支持同步、异步和流式三种响应模式。同步模式适合需要立即获取完整结果的场景；异步模式可将任务排队，通过 webhook 或轮询获取结果，适合耗时较长的任务；流式模式则能实时展示代理的工作过程，提升用户体验。开发者可根据实际需求灵活选择，以平衡响应速度和资源消耗。
从现有代码库开始
除了从零开始创建应用，API 还支持从 GitHub 仓库、ZIP 归档或文件集创建聊天。这意味着开发者可以基于现有代码库进行迭代，v0 能够读取、编辑和运行这些文件，实现自动化修改或功能增强。这一特性对于维护大型项目或快速原型开发尤为有用。
代理集成方式
v0 API 提供了多种代理集成方式：通过 MCP 服务器连接 IDE 或桌面助手；通过 AI SDK 工具包将 v0 操作集成到 TypeScript 代理中；通过 OpenAPI 连接文件集成到 eve 代理。这些方式让代理能够调用 v0 生成或修改应用，而无需直接处理代码细节，从而扩展了代理的能力边界。
迁移注意事项
旧版 v0 API 的聊天无法直接在新版上运行，需要迁移。迁移过程包括下载旧聊天为 ZIP，再通过新 API 创建新聊天，并将旧标识符存入元数据以便追溯。主要变化包括 API 端点更新、聊天状态与消息历史的分离、项目组织方式的调整等。开发者应参考迁移指南，确保平滑过渡。
Q&A
v0新API是什么？它有什么主要功能？
v0新API是v0应用构建代理的编程接口，允许开发者通过发送提示词来生成应用，并在Vercel沙箱中运行，获得可嵌入的预览URL。它支持同步、异步和流式响应，可以从现有代码库创建聊天，并支持MCP、AI SDK和eve等代理集成。
如何使用v0 API创建一个应用？
首先安装v0 SDK（pnpm add v0@latest），然后调用v0.chats.create方法，传入提示词（如'Build an issue triage app'），即可创建聊天并生成应用。之后可以通过发送后续消息来迭代应用，最后可以嵌入预览或部署到Vercel。
v0 API支持哪些响应模式？
v0 API支持同步、异步和流式响应。同步模式会等待完成并返回结果；异步模式将工作排队，通过webhook或轮询获取结果；流式模式可以实时接收代理的工作过程。
v0 API如何与现有代码库集成？
可以通过v0.chats.createFromRepo方法，传入仓库URL、分支等信息，从现有代码库创建聊天。也可以从ZIP归档或文件集创建。
v0 API支持哪些代理集成方式？
v0 API支持三种代理集成方式：MCP（通过配置MCP服务器连接）、AI SDK（使用@v0-sdk/ai-tools将v0操作暴露为工具）、eve（通过OpenAPI连接文件注册）。
v0 API的典型使用场景有哪些？
典型使用场景包括：构建白标应用生成器（用户描述应用即可获得应用）、自动化应用修改（通过脚本、CI或webhook触发）、作为构建工具供代理使用（代理返回可运行的应用而非代码片段）。
如何将v0生成的应用部署到Vercel？
首先为聊天创建Vercel项目（v0.chats.createVercelProject），然后调用v0.chats.deploy方法进行部署，返回deploymentId和vercelProjectId。
v0 API的预览功能是如何工作的？
每个聊天会获得一个短期的预览令牌，开发者通过服务器路由获取并代理浏览器请求，这样API密钥不会暴露在浏览器中。当预览就绪时，流量会转发到预览；在沙箱启动时，请求会回退到加载路由。
