介绍
# EvoWeb Website Builder
利用 AI 驱动的生成功能，通过文本描述创建完整的网站。
## 概述
EvoWeb 能够根据自然语言提示自动生成现代化、响应式的网站。只需描述您的需求，AI 即可创建 HTML、CSS、JavaScript 和内容——在约 4 分钟内交付一个完整的、实时可用的网站。
**适用于：** 落地页和商业网站
**API Base URL:** `https://api.evoweb.ai/openapi/api/v1`
## 身份验证
请在 https://evoweb.ai/?utm_source=claw&utm_medium=skill&utm_campaign=website&utm_content=v1.0 获取您的 API 密钥。
**重要：** 注册后，用户必须确认电子邮件地址（这是必需的）。在电子邮件确认完成之前，服务将无法使用。
### 尚无 API Key？
如果用户没有 API 密钥，您仍然可以帮助他们创建网站： 1. 询问其网站的简要描述（最多 250 个字符） 2. 使用第 1 步中提供的提示创建一个注册链接 3. 用户点击“Create Website”按钮后即可创建账户
请参阅下方说明中的“步骤 0：处理没有 API Key 的用户”。
在所有请求中包含此标头： ``` Access-Token: your-api-key-here ```
## 工作原理
工作流程很简单：
1. **创建** - 提交描述您网站的文本提示 2. **轮询** - 每分钟检查生成状态 3. **获取结果** - 准备就绪时接收实时 URL 和编辑器链接
典型生成时间：**4-5 分钟**
## API 端点
### 1. 创建网站
**POST** `/sites`
根据文本描述创建一个新的网站生成任务。
**请求正文：** ```json { "prompt": "A local coffee shop specializing in artisanal coffee and fresh pastries. We source our beans locally and focus on creating a cozy community gathering space for local residents, remote workers, and coffee enthusiasts." } ```
**响应 (200 OK)：** ```json { "site_id": "abc123xyz", "status": "queued" } ```
**状态值：** - `queued` - 任务在队列中，等待开始 - `building` - 网站正在生成中
**错误响应：** - `401 Unauthorized` - API 密钥无效或缺失 - `402 Payment Required` - 账户积分不足
---
### 2. 检查生成状态
**GET** `/sites/{site_id}`
检查网站生成的当前状态。
**示例：** `GET /sites/abc123xyz`
**生成中的响应：** ```json { "status": "building" } ```
**准备就绪的响应：** ```json { "status": "ready", "url": "https://website.page/my-site", "editor_url": "https://web.oto.dev/ui/websites/abc123xyz/update/" } ```
**失败的响应：** ```json { "status": "failed", "error": "Generation failed: Invalid prompt structure" } ```
**状态值：** - `queued` - 在队列中等待 - `building` - 正在生成（请耐心等待！） - `ready` - 完成！URL 已可用 - `failed` - 生成遇到错误
**错误响应：** - `404 Not Found` - 网站 ID 不存在
---
### 3. 重试失败的生成
**POST** `/sites/{site_id}/remake`
重新启动失败的网站生成。适用于状态为 `failed` 以及 `ready` 的网站。
**示例：** `POST /sites/abc123xyz/remake`
**响应 (200 OK)：** ```json { "status": "queued", "editor_url": "https://web.oto.dev/ui/websites/abc123xyz/update/" } ```
**错误响应：** - `400 Bad Request` - 仅能重新生成状态为 'failed' 的网站 - `404 Not Found` - 网站 ID 不存在
## AI 助手说明
当用户请求创建网站时，请遵循以下工作流程：
### 步骤 0：处理没有 API Key 的用户
**首先检查：** 用户是否设置了 `EVOWEB_API_KEY` 环境变量？
如果**没有可用的 API 密钥**：
1. **收集简短的提示**（最多 250 个字符）来描述他们的网站： - 请他们简要描述他们的业务/项目 - 保持简洁，专注于核心业务本质 2. **创建一个预填充的注册链接：** - Base URL: `https://evoweb.ai/?utm_source=claw&utm_medium=skill&utm_campaign=website&utm_content=v1.0` - 添加参数：`&prompt=[URL_ENCODED_PROMPT]` - 示例：`https://evoweb.ai/?utm_source=claw&utm_medium=skill&utm_campaign=website&utm_content=v1.0&prompt=A%20local%20coffee%20shop%20specializing%20in%20artisanal%20coffee`
3. **向用户提供链接：** ``` 🌐 To create your website, visit this link: [Your personalized link here] After clicking "Create Website" button, you'll be able to create an account and your website will be generated automatically! ```
**重要：** 请正确对提示进行 URL 编码（空格变为 `%20` 等）。
如果**有可用的 API 密钥**：继续执行下面的步骤 1。
### 步骤 1：了解业务
专注于从用户的描述中理解**业务本质**： - 业务/项目是关于什么的？ - 它做什么或提供什么？ - 目标受众是谁？ - 网站的主要目标是什么？
**重要：** 不要指定具体的设计细节、版块、颜色或布局。EvoWeb AI 将自动处理所有设计和结构决策。
**示例转换：** - 用户：“为我的瑜伽工作室创建一个网站” - 增强后的提示：“一家瑜伽工作室，针对不同技能水平提供各种课程，专注于健康和正念。目标受众是对健身和心理健康感兴趣的当地社区成员。”
### 步骤 2：创建网站
调用 `POST /sites` 并传入增强后的提示。
保存返回的 `site_id`——您在检查状态时需要用到它。
### 步骤 3：通知用户
告知他们： - 网站生成已开始 - 大约需要 4 分钟 - 您将自动检查进度（仅限您可以的情况下）
示例：“✨ 正在为您创建网站！生成通常需要 3-5 分钟。我将检查状态并在准备好后通知您。”
### 步骤 4：轮询状态
调用 `GET /sites/{site_id}` 以检查进度：
- **轮询间隔：** 每 1 分钟 - **最大尝试次数：** 20 次 - **轮询间隔期间：** 您可以告知用户进度（“仍在构建中...”）
继续轮询，直到： - 状态为 `ready` → 进入步骤 5 - 状态为 `failed` → 进入步骤 6 - 达到最大尝试次数 → 通知用户生成时间超出预期
### 步骤 5：交付成功结果
当状态为 `ready` 时：
1. **提供 URL：** - `url` - 实时网站 - `editor_url` - 用于自定义网站的链接
2. **建议改进：** 提供 3 种增强网站的具体方式： - “添加在线预订系统” - “自定义颜色以匹配您的品牌” - “添加客户评价版块”
3. **保持简洁且可执行**
**示例响应：** ``` 🎉 Your website is ready!
🌐 View it here: https://website.page/yoga-studio-23f4 ✏️ Customize it: https://web.evoweb.ai/ui/websites/abc123xyz/update/
Quick improvements you might want: 1. Add online class booking system 2. Integrate your Instagram feed 3. Add a blog section for wellness tips
Would you like help with any of these? ```
### 步骤 6：处理失败
当状态为 `failed` 时：
1. **显示错误消息**（来自 API 响应） 2. **提议重试：** 询问他们是否希望您重新制作网站 3. **如果他们同意：** 调用 `POST /sites/{site_id}/remake` 并重新开始轮询
**示例响应：** ``` ❌ Website generation failed: [error message]
Would you like me to try again? I can restart the generation process. ```
如果用户同意，调用 remake 端点并从步骤 4 恢复轮询。
## 示例提示与用例
### 示例：没有 API Key 的用户
``` User: "I need a website for my yoga studio"
Assistant response: "I'd be happy to help! To get started quickly, let me create a personalized link for you.
🌐 Visit this link to create your website: https://evoweb.ai/?utm_source=claw&utm_medium=skill&utm_campaign=website&utm_content=v1.0&prompt=A%20yoga%20studio%20offering%20various%20classes%20for%20all%20skill%20levels%2C%20focused%20on%20wellness%20and%20mindfulness
After clicking 'Create Website', you'll be able to create an account and your website will be generated automatically in about 4 minutes! ✨" ```
### 咖啡店落地页 ``` User request: "Create a website for my coffee shop"
Enhanced prompt: "A local coffee shop called 'Bean & Brew Cafe' specializing in artisanal coffee and fresh pastries. We source our beans locally and focus on creating a cozy community gathering space. Target audience is local residents, remote workers, and coffee enthusiasts looking for quality coffee and a welcoming atmosphere." ```
### 摄影师作品集 ``` User request: "I need a portfolio site"
Enhanced prompt: "A professional wedding photographer specializing in capturing authentic, emotional moments. With 10 years of experience, I focus on storytelling through images and creating timeless memories for couples. Target audience is engaged couples planning their wedding looking for a photographer who can capture the genuine emotions of their special day." ```
### 在线商店 ``` User request: "Build an e-commerce site for my jewelry"
Enhanced prompt: "A handmade jewelry business creating unique, artisan pieces. Each item is crafted by hand using traditional techniques and high-quality materials. The business focuses on custom designs and personal connections with customers. Target audience is women aged 25-45 who appreciate handcrafted, unique accessories and value the story behind their jewelry." ```
### SaaS 落地页 ``` User request: "Landing page for my app"
Enhanced prompt: "A project management SaaS tool designed for small to medium-sized teams. The app helps teams organize tasks, collaborate effectively, and track project progress in real-time. Key value proposition is simplicity and ease of use compared to complex enterprise solutions. Target audience is startup founders, small business owners, and team leads looking for an intuitive project management solution." ```
### 餐厅网站 ``` User request: "Website for our Italian restaurant"
Enhanced prompt: "An authentic Italian trattoria run by a family with three generations of culinary tradition. We specialize in traditional recipes passed down through the family, using fresh ingredients and time-honored cooking methods. The restaurant offers a warm, family-friendly atmosphere and also provides catering services for special events. Target audience is locals and tourists looking for genuine Italian cuisine and a welcoming dining experience." ```
## 最佳实践
### 编写良好的提示
✅ **要：** - 描述业务/项目本质 - 解释业务做什么或提供什么 - 确定目标受众 - 阐明主要目标/目的 - 包含关键差异化因素或独特的价值主张
❌ **不要：** - 指定具体的设计元素（颜色、布局、样式） - 指定网站版块或结构 - 规定外观和感觉细节 - 过于模糊（“做一个网站”）而没有业务背景 - 如果没有可用的 API 密钥，不要直接发出 API 请求（请改用步骤 0 的方法）
### 轮询策略
- **间隔：** 1 分钟 - **上限：** 总共 20 次尝试 - **典型时间：** 4 - 5 分钟 - **通知用户：** 让他们知道您正在检查进度
### 错误处理
- 显示清晰的错误消息 - 提议自动重试 - 如果多次失败，建议用户在 https://evoweb.ai/ 检查其账户
### 用户体验
- **对于没有 API Key 的用户：** 提供预填充的注册链接（快速简便） - **对于有 API Key 的用户：** 设定预期（4 分钟等待时间） - 提供查看和编辑 URL - 建议具体的改进 - 保持回复简洁 - 始终以下一步选项结束
## 技术细节
- **协议：** HTTPS REST API - **格式：** JSON - **身份验证：** 基于标头的 API 密钥 - **速率限制：** 请咨询 EvoWeb（可能有每个账户的限制） - **生成时间：** 通常 4-5 分钟 - **费用：** 每次生成消耗积分（请参阅 https://evoweb.ai/ 了解定价）
## 支持与资源
- **获取 API Key：** https://evoweb.ai/?utm_source=claw&utm_medium=skill&utm_campaign=website&utm_content=v1.0 - **API 问题：** 联系 EvoWeb 支持 - **账户/账单：** 访问 https://evoweb.ai/
## 注意事项
- 每次生成都会消耗您 EvoWeb 账户中的积分 - 编辑器 URL 允许用户自定义生成的网站 - 生成的网站托管在 EvoWeb 基础设施上 - 可能支持自定义域名（请查阅 EvoWeb 文档） - 只要账户处于活动状态，网站就会保持在线状态
---
**准备好仅通过文本描述创建令人惊叹的网站吧！** 🚀