Platform API 是什么
v0 Platform API 把浏览器里的"对话生成代码"能力开放成了 REST 接口。你可以用代码调 v0，批量生成组件、自动迭代、把 v0 嵌入自己的工具链。
需要 Premium 计划（$20/月）才能用 API，免费版不行。
获取 API Key
- 打开 v0.app/chat/settings/keys
- 点 Create API Key
- 复制 key，存到环境变量里，不要提交到代码仓库
# .env.local
V0_API_KEY=v0_key_xxxxxxxxxxxxxxxxxx
SDK 安装与基础用法
v0 提供官方 TypeScript SDK：
npm install @anthropic-ai/v0-sdk
# 或
pnpm add @anthropic-ai/v0-sdk
最基本的用法——用 Prompt 生成一个 React 组件：
import { V0Client } from '@anthropic-ai/v0-sdk'
const v0 = new V0Client({ apiKey: process.env.V0_API_KEY })
// 创建聊天会话
const chat = await v0.chats.create({
prompt: '创建一个带搜索和分页的用户列表组件',
model: 'v0-1.5-md'
})
// 获取生成结果
console.log(chat.id) // 聊天 ID
console.log(chat.result) // 生成的代码
console.log(chat.files) // 文件列表
多轮迭代
一次生成不满意，可以在同一个聊天里继续发消息迭代：
// 继续迭代
const updated = await v0.chats.update(chat.id, {
prompt: '表格加上排序功能，点击列头切换升序降序'
})
// 再次迭代
const final = await v0.chats.update(chat.id, {
prompt: '加一个导出 CSV 按钮，放在表格右上角'
})
// 获取最终的文件列表
for (const file of final.files) {
console.log(`${file.path}: ${file.content.length} chars`)
}
批量生成组件
API 的真正威力在批量场景。比如你有一套设计规范，需要生成 20 个页面：
const pages = [
'用户登录页，带邮箱和 Google OAuth',
'仪表盘，4 个 KPI 卡片 + 趋势图',
'用户管理列表，支持搜索、筛选、批量操作',
'设置页，个人信息 + 通知偏好 + 安全设置',
'404 页面，带搜索框和热门链接'
]
const results = await Promise.all(
pages.map(prompt =>
v0.chats.create({
prompt,
instructions: '使用 shadcn/ui，品牌色 #6366f1，暗色主题'
})
)
)
// 把生成的文件写入本地项目
for (const result of results) {
for (const file of result.files) {
await fs.writeFile(`src/${file.path}`, file.content)
}
}
5 个页面并行生成，2 分钟搞定，手写至少两天。
集成 CI/CD
把 v0 API 接入 GitHub Actions，实现 PR 里自动生成 UI 预览：
# .github/workflows/v0-preview.yml
name: v0 UI Preview
on:
pull_request:
paths: ['docs/ui-specs/*.md']
jobs:
generate:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: npm install @anthropic-ai/v0-sdk
- run: node scripts/generate-ui.js
env:
V0_API_KEY: ${{ secrets.V0_API_KEY }}
- uses: actions/upload-artifact@v4
with:
name: generated-ui
path: generated/
PM 在 docs/ui-specs/ 里写需求文档，推 PR 后自动生成 UI 代码供开发 review——这是 v0 API 最实用的场景之一。
