错误参考
每个 Draftly 错误代码 —— 含义以及如何解决。
网站生成错误
| 代码 | 消息 | 原因 | 解决方法 |
|---|---|---|---|
insufficient_credits | 积分不足 | 已达月度限额 | 升级套餐或等待月度重置 |
prompt_too_vague | 提示词太简短 | 少于 10 个词或无实质内容 | 添加更多具体细节 |
server_busy | 服务器繁忙，请重试 | AI 提供商 503（Google / Anthropic） | 等待 60 秒后重试 |
model_timeout | 生成超时 | AI 用时超过 5 分钟 | 重试；如反复出现则简化提示词 |
auth_error | 需要身份验证 | 会话已过期 | 刷新页面并重新登录 |
firestore_error | 保存失败 | 数据库写入错误 | 检查连接；重试 |
generation_failed | 生成失败 | 意外 AI 错误 | 重试一次；如持续出现请联系支持 |
unknown | 意外错误 | 未分类 | 刷新并重试；联系支持时提供项目 ID |
积分与套餐错误
| 错误 | 原因 | 解决方法 |
|---|---|---|
| 对话中出现"积分不足" | 会话中途积分耗尽 | 升级以继续；或等待月度重置 |
| "已达网站限额" | 本月已达套餐最大网站数 | 等待重置或升级套餐 |
| "已达对话限额" | 已用完月度对话编辑次数 | 内联编辑和代码编辑仍然免费 |
| "分辨率不可用" | Basic/Pro 上请求 2K/4K | 2K/4K 需要 Premium+ |
| "视频不可用" | Free 套餐已用完 1 个片段 | 升级到 Basic 获得无限视频 |
视频与帧错误
| 错误 | 原因 | 解决方法 |
|---|---|---|
| 帧提取跳过 —— 超时 | 视频编解码器问题或解码缓慢 | 网站回退到静态视差；重新生成视频以重试 |
| 视频生成超时 | Veo 队列过载 | 使用宽松质量重试（更多队列容量） |
| "视频卡顿" | 浏览器中视频解码不可用 | 使用 Chrome；Safari 可能有解码器限制 |
| 视频 URL 过期 | 签名 URL 在提取前过期 | 重新打开项目 —— 系统自动重新获取 |
身份验证错误
| 错误 | 原因 | 解决方法 |
|---|---|---|
| "需要身份验证" | JWT 过期或缺失 | 刷新并重新登录 |
| "用户不匹配" | Token / 请求体 UID 冲突 | 登出并重新登录 |
| 会话过期 | Firebase 会话超时 | 重新登录 —— 工作已自动保存 |
| "订阅未激活" | 付款失败，宽限期已结束 | 在设置 → 账单中更新付款方式 |
发布错误
| 错误 | 原因 | 解决方法 |
|---|---|---|
| "子域名已被占用" | 另一个用户拥有此标识符 | 选择不同的子域名 |
| "子域名无效" | 包含无效字符或保留词 | 仅限字母、数字、连字符；避免保留词 |
| "发布失败" | Firebase Storage 或 Cloudflare 错误 | 重试；如持续出现请联系支持 |
| 自定义域名无法解析 | DNS 未传播 | 等待最多 48 小时；验证 CNAME 设置是否正确 |
获取帮助
如果按上述步骤操作后错误仍然存在：
1.复制您的项目 ID —— 在浏览器 URL 中可见：
?projectId=proj_XXXXX2.记录错误消息以及触发它的操作
3.发送邮件至支持 support@draftly.business，附上您的项目 ID 和描述
支持团队通常在工作日 24 小时内回复。