EvoWeb 网站生成器

通过 AI 驱动的文本生成能力，仅凭文字描述即可创建完整网站。

概述

EvoWeb 可根据自然语言提示自动构建现代、响应式网站。您只需描述所需网站的功能与风格，AI 即可自动生成 HTML、CSS、JavaScript 代码及全部内容，约 4 分钟后交付一个可立即访问的完整网站。

适用场景：落地页与企业官网

API 基础 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 密钥？

若用户尚未拥有 API 密钥，您仍可协助其创建网站：

1. 请用户提供简要的网站描述（最多 250 字符）
2. 将第 1 步中获取的描述作为参数，生成预填注册链接
3. 用户点击“Create Website”按钮后即可完成账号注册

详见下方说明中的“步骤 0：处理无 API 密钥的用户”。

所有请求均需包含以下请求头：

Access-Token: your-api-key-here

工作原理

整个流程极为简洁：

1. 创建 — 提交一段描述您网站的文字提示
2. 轮询 — 每分钟检查一次生成状态
3. 获取结果 — 状态就绪后，返回可访问的网站 URL 和编辑器链接

典型生成耗时：4–5 分钟

API 接口列表

1. 创建网站

POST /sites

基于文字描述创建一个新的网站生成任务。

请求体（Request Body）：

{
  "prompt": "一家本地咖啡馆，专注于手作精品咖啡与新鲜烘焙点心。我们本地采购咖啡豆，致力于打造温馨的社区聚集空间，服务于本地居民、远程办公者及咖啡爱好者。"
}

响应（200 OK）：

{
  "site_id": "abc123xyz",
  "status": "queued"
}

状态值说明：

• queued — 任务已入队，等待启动
• building — 网站正在生成中

错误响应：

• 401 Unauthorized — API 密钥无效或缺失
• 402 Payment Required — 账户余额不足（信用点数不足）

2. 查询生成状态

GET /sites/{site_id}

查询当前网站生成任务的状态。

示例： GET /sites/abc123xyz

生成中时的响应：

{
  "status": "building"
}

生成完成时的响应：

{
  "status": "ready",
  "url": "https://website.page/my-site",
  "editor_url": "https://web.oto.dev/ui/websites/abc123xyz/update/"
}

生成失败时的响应：

{
  "status": "failed",
  "error": "Generation failed: Invalid prompt structure"
}

状态值说明：

• queued — 等待入队执行
• building — 正在生成中（请耐心等待！）
• ready — 已完成！URL 已可用
• failed — 生成过程中发生错误

错误响应：

• 404 Not Found — site_id 不存在

3. 重试失败的生成任务

POST /sites/{site_id}/remake

为生成失败的网站重新启动生成流程。该接口同样适用于状态为 ready 的站点（例如需更新内容时）。

示例： POST /sites/abc123xyz/remake

响应（200 OK）：

{
  "status": "queued",
  "editor_url": "https://web.oto.dev/ui/websites/abc123xyz/update/"
}

错误响应：

• 400 Bad Request — 仅允许对状态为 failed 的站点执行重试操作
• 404 Not Found — site_id 不存在

AI 助理操作指南

当用户提出建站需求时，请按以下流程执行：

步骤 0：处理无 API 密钥的用户

首要检查： 用户是否已设置 EVOWEB_API_KEY 环境变量？

若暂无 API 密钥：

1. 收集简要提示（Prompt）（最长 250 字符），用于描述其网站：

   • 请用户简要说明其业务或项目性质
   • 保持简洁，聚焦于业务本质

2. 生成预填注册链接：

   • 基础 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. 向用户提供该链接：

   🌐 请通过以下链接创建您的网站：
   [您的个性化链接]
   
   点击“Create Website”按钮后，您即可注册账号，网站将自动开始生成！
   

重要提示： 请确保对提示内容进行正确的 URL 编码（空格应转为 %20，依此类推）

若已有 API 密钥：请直接进入下方“步骤 1”。

步骤 1：理解业务本质

重点从用户描述中提炼出业务核心要素：

• 该业务或项目是做什么的？
• 它提供哪些产品或服务？
• 目标用户是谁？
• 网站的核心目标是什么？

重要提示：请不要指定具体设计细节（如配色、版式、组件结构等）。EvoWeb AI 将全自动完成所有设计与页面结构决策。

示例优化过程：

• 用户原始输入：“为我的瑜伽馆创建一个网站”
• 优化后 Prompt：“一家提供多级别课程的瑜伽馆，专注身心健康与正念练习；目标用户为关注健身与心理健康的本地社区成员。”

步骤 2：创建网站

调用 POST /sites 接口，传入优化后的 Prompt。

保存返回的 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. 保持简洁、可操作

示例响应：

🎉 恭喜！您的网站已准备就绪！

🌐 查看网站：https://website.page/yoga-studio-23f4
✏️ 编辑网站：https://web.evoweb.ai/ui/websites/abc123xyz/update/

您可能感兴趣的快速优化项：
1. 添加线上课程预约系统
2. 接入 Instagram 动态源
3. 新增健康养生类博客栏目

需要我协助其中任何一项吗？

步骤 6：处理失败情况

当状态为 failed 时：

1. 展示 API 返回的具体错误信息
2. 主动提供重试选项：询问用户是否希望您重新生成网站
3. 若用户同意：调用 POST /sites/{site_id}/remake 并从步骤 4 重启轮询流程

示例响应：

❌ 网站生成失败：[错误信息]

是否需要我再次尝试？我可以为您重新启动生成流程。

若用户确认重试，请调用 remake 接口并从步骤 4 继续轮询。

示例 Prompt 与典型用例

示例：无 API 密钥的用户

用户：“我需要为我的瑜伽馆建个网站”

助手响应：
“很高兴为您效劳！为加快启动速度，我将为您生成专属注册链接。

🌐 请访问以下链接创建网站：
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

点击‘Create Website’后，您即可注册账号，网站将在约 4 分钟内自动生成！✨”

咖啡馆落地页

用户请求：“为我的咖啡馆建个网站”

优化后 Prompt：
“一家名为‘Bean & Brew Cafe’的本地咖啡馆，主打手作精品咖啡与新鲜烘焙点心。我们坚持本地采购咖啡豆，致力于打造温馨的社区聚集空间。目标用户为本地居民、远程办公者以及追求高品质咖啡与友好氛围的咖啡爱好者。”

摄影师作品集

用户请求：“我需要一个作品集网站”

优化后 Prompt：
“一位专注婚礼摄影的专业摄影师，擅长捕捉真实而富有情感的瞬间。从业 10 年，以影像叙事为核心理念，为新人打造历久弥新的珍贵记忆。目标用户为筹备婚礼的准新人，他们期待一位能真实记录婚礼日真挚情感的摄影师。”

在线商店

用户请求：“为我的珠宝生意搭建电商网站”

优化后 Prompt：
“一家手工珠宝品牌，专注于打造独一无二的手作饰品。每件作品均采用传统工艺与优质材料纯手工制作。品牌强调定制化设计与客户深度联结。目标用户为 25–45 岁女性，她们青睐匠心独运、富有故事感的手工配饰。”

SaaS 产品落地页

用户请求：“为我的应用做一个落地页”

优化后 Prompt：
“一款面向中小团队的项目管理 SaaS 工具。该应用帮助团队高效组织任务、无缝协作，并实时追踪项目进度。核心价值主张在于极简易用，相较复杂的企业级方案更轻量直观。目标用户为初创公司创始人、小型企业主及团队负责人，他们正寻找一款上手快、体验流畅的项目管理解决方案。”

餐厅官网

用户请求：“为我们意大利餐厅建个网站”

优化后 Prompt：
“一家由三代传承的家族经营意大利小馆（Trattoria）。我们专精于代代相传的传统食谱，坚持选用新鲜食材与古法烹饪技艺。餐厅营造温暖亲切的家庭式用餐氛围，并提供婚庆、聚会等特殊场合的定制化餐饮服务。目标用户为寻求地道意大利美食与温馨就餐体验的本地居民及游客。”

最佳实践

撰写优质 Prompt 的要点

✅ 应该做：

• 准确描述业务或项目的核心本质
• 清晰说明所提供的产品或服务
• 明确指出目标用户群体
• 阐明网站的主要目的或功能定位
• 补充关键差异化优势或独特价值主张

❌ 不应做：

• 指定具体设计元素（如颜色、布局、风格）
• 规定网页结构或模块划分
• 描述视觉感受或交互细节
• 过于宽泛（如“做个网站”）而缺乏业务上下文
• 在无 API 密钥时直接发起 API 请求（应改用步骤 0 方法）

轮询策略

• 轮询间隔：1 分钟
• 最大尝试次数：总计 20 次
• 典型耗时：4–5 分钟
• 用户沟通：及时告知用户您正在检查进度

错误处理

• 向用户清晰呈现错误信息
• 主动提供自动重试选项
• 若多次失败，建议用户前往 https://evoweb.ai/ 检查账户状态

用户体验优化

• 针对无 API 密钥用户：提供预填注册链接（快捷、零门槛）
• 针对有 API 密钥用户：提前设定合理预期（约 4 分钟等待时间）
• 同时提供可访问 URL 与可编辑 URL
• 给出具体、可落地的优化建议
• 响应内容保持简洁凝练
• 每次交互结尾都提供明确的下一步选项

技术细节

• 协议：HTTPS REST API
• 数据格式：JSON
• 认证方式：请求头中携带 API 密钥
• 速率限制：请参考 EvoWeb 官方说明（可能存在按账户设定的限制）
• 生成耗时：通常为 4–5 分钟
• 费用说明：每次生成消耗固定信用点数（定价详情见 https://evoweb.ai/）

支持与资源

• 获取 API 密钥： https://evoweb.ai/?utm_source=claw&utm_medium=skill&utm_campaign=website&utm_content=v1.0
• API 相关问题：联系 EvoWeb 技术支持
• 账户与账单管理：访问 https://evoweb.ai/

注意事项

• 每次网站生成均会扣除 EvoWeb 账户中的信用点数
• Editor URL 允许用户对已生成网站进行个性化定制
• 生成的网站托管于 EvoWeb 基础设施之上
• 自定义域名功能可能可用（请查阅 EvoWeb 文档确认）
• 只要账户处于有效状态，网站将长期保持在线

现在，仅需一段文字描述，即可轻松创建惊艳网站！ 🚀