问题排查指南

使用 Get3W 时常见问题的解决方案。

API 问题

401 Unauthorized

现象： API 返回 401 Unauthorized

解决办法：

1. 确认 API Key 正确，并且以 sk_ 开头
2. 检查请求头格式：Authorization: Bearer YOUR_API_KEY
3. 检查复制 Key 时是否带入了多余的空格或换行
4. 确认 Key 未被删除，或重新生成一个

403 Account suspended 与 401 不同 —— 它表示该 Key 关联的账户已被停用，这种情况请联系支持团队。

402 Payment Required

现象： API 返回 402，并带有 Insufficient balance 消息

解决办法：

1. 用 GET /v1/balance 查询余额
2. 充值 —— 每个任务在执行前都会计价，余额不足则被拒绝
3. 注意视频和数字人任务的费用远高于图像
4. 如果你用的是试用额度，请注意部分高端模型需要付费余额

500 Internal Server Error

现象： API 返回 500 Internal Server Error

解决办法：

1. 等几秒后重试请求
2. 检查该模型是否可用
3. 换一个模型试试
4. 若问题持续存在，请联系支持团队

生成问题

任务卡在 "Processing"

现象： 任务状态长时间停留在 processing

预期等待时间：

• 图像：< 30 秒
• 视频：< 5 分钟
• 3D 模型：< 10 分钟

解决办法：

1. 再等一会儿 —— 高负载时排队时间会变长，可以在结果的 timings.queue_wait 中看到
2. 查看该模型的典型处理时间，或参考提交响应里的 estimated_duration
3. 与其无限等待，不如重新提交一个新任务；目前没有取消或删除排队任务的接口
4. 如果持续很慢，请带上 task ID 联系支持团队

任务不会永远卡住。始终没有开始的任务会在 30 分钟后过期，中途停滞的任务会在 60 分钟后过期；两种情况都会以 failed 结束，且不会计费。

输出质量不佳

现象： 生成的内容不符合预期

解决办法：

1. 优化提示词 —— 参见写好提示词
2. 换一个模型 —— 参见选择合适的模型
3. 提高分辨率或质量参数
4. 使用网页界面里的 Prompt Enhancer
5. 尝试不同的 seed 值

任务失败

现象： 任务状态为 failed，并带有错误信息

常见原因：

错误	解决办法
Invalid prompt	检查提示词的格式和内容
Invalid image URL	确认 URL 可访问且有效
Unsupported dimensions	查看该模型支持的尺寸
Content policy violation	修改提示词以符合内容政策
Model unavailable	稍后再试或换一个模型

集成问题

超时错误

同步模式会在整个任务期间保持连接，因此较慢的模型可能超过 HTTP 客户端的默认超时时间。可以调高超时：

requests.post(url, headers=headers, json=payload, timeout=600)

对视频和数字人任务，更好的做法是去掉 ?sync=true 改用轮询 —— 参见异步模式。

网页界面问题

无法登录

1. 清除浏览器缓存和 Cookie
2. 换一个浏览器试试
3. 确认账户是否处于正常状态
4. 联系支持团队

生成无法启动

1. 检查额度余额 —— 点击 Run 按钮之前会显示预估费用
2. 试着刷新页面
3. 查看浏览器控制台是否有报错

还需要帮助？

• 查看常见问题了解高频疑问
• 联系支持团队获取一对一帮助