第1章 v0 API 入门:通过 Agent 实现全栈应用生成与部署
概述
v0 API 让你的产品获得 v0 的应用构建 agent 能力,包括代码生成、安全的实时预览、集成,以及部署到 Vercel。
只需一次 API 调用,就能从一个 prompt 创建全栈应用:
```ts import { v0 } from 'v0'
const result = await v0.chats.create({ message: 'Create a project management dashboard with a kanban board', })
if (result.error) { throw new Error(result.error.message) }
console.log('Created chat:', result.data.chat.id) ```
为什么选择 v0 API?
构建应用生成体验不只是生成代码那么简单。你需要一个能够规划和迭代的 agent,一个运行其工作的安全环境,以及一条从 prompt 到生产应用的完整路径。v0 API 通过一个 API 提供了完整的工作流。
主要优势包括:
Agentic 应用生成:通过自然语言创建全栈应用,并可通过后续消息持续迭代。 安全的实时预览:运行生成的应用并嵌入预览,无需向浏览器暴露凭证。 可扩展的工作流:连接 MCP server、集成、环境变量和设计系统。 内置部署:无需单独搭建部署基础设施,即可将生成的应用部署到 Vercel。
v0 API 支持以下核心工作流:
- 通过 Chats 和 Messages API 生成并迭代应用。 - 使用 @v0-sdk/react 和 AI SDK 构建自定义聊天界面。 - 通过经过认证的 iframe URL,在产品中安全嵌入实时预览。 - 通过 v0 MCP server 或 AI SDK 工具为 agent 添加应用生成能力。
快速开始
从一个完整的应用生成前端入手:
```bash npx create-v0-sdk-app ```
该 starter 包含带有实时预览的完整聊天界面。按照 Quickstart 配置 starter,或将 v0 添加到现有应用中。
错误处理
在同步创建 chat、发送消息或解析任务时,如果模型策略拒绝响应,会返回 HTTP 422,响应体如下:
```json { "message": "The selected model declined to respond to this request. Try rephrasing your request or choosing a different model." } ```
不要用相同的模型自动重试未修改的请求。可以尝试改写请求或换用其他模型。意外的服务器故障会返回 HTTP 500,响应体为:
```json { "message": "An unexpected error occurred" } ```
参考与迁移
- 从 v1 迁移到 v2 - 浏览端点参考
下一篇:Quickstart