常见问题

接入失败时，先检查三件事：地址有没有填错、API Key 是否完整、模型名称是否已替换。

按错误提示处理

你看到的提示	先怎么做
401、Key 无效或认证失败	重新复制完整 API Key；确认它没有过期或停用，不要填网页登录密码
403、没有权限	检查这把 Key 是否允许使用该模型；仍不清楚时联系平台支持
404、页面不存在，或返回一段网页 HTML	检查接口地址，特别是是否多写或少写 /v1
400、参数不正确	确认已替换模型名称，先只使用教程里的基本字段
模型不存在或当前不可用	去模型广场重新选择准确的可用模型
余额不足	到钱包查看可用余额
429、请求太频繁	稍等后再试，减少同时发出的请求
503、维护中	按平台提示等待恢复，不要连续点击重试

错误码只是初步线索，请同时阅读接口返回的具体文字说明。

Python 运行不起来

• 出现 No module named requests：先按 Python 准备教程安装请求工具。
• 提示找不到文件：在保存示例的文件夹打开终端，确认后缀为 .py。
• 输入 API Key 时没有显示文字：可能是隐藏输入，粘贴后按回车即可。
• 连接失败：核对代码里的接口地址，确认网络可以访问平台；不要通过关闭 HTTPS 校验来处理。

cURL 或 PowerShell 报语法错误

文档里的 cURL 多行命令使用 Bash 写法，PowerShell 使用单独的示例。

如果你在 Windows PowerShell 中粘贴了带反斜杠换行的 Bash 命令，请改用同一篇教程的 PowerShell 段落。复制代码块时，不需要复制代码块外面的标题或解释。

图片或视频没有结果

问题	处理方式
文本可以用，图片或视频不行	选择对应类型的模型，使用对应教程里的接口
图片生成超时	先查看使用记录，不要马上重复生成
视频一直排队	保留任务 ID，隔一段时间继续查询
视频任务失败	查看 error 中的原因，停止查询后再决定下一步
下载的视频打不开	确认任务完成、下载命令成功，文件不是错误信息
图片或视频链接过期	生成后及时保存；已经过期时联系平台支持

已经收到视频任务 ID，就查询该任务，不要重新运行整段提交程序。原窗口关闭后，也可以用已保存的 ID 继续查询。

WorkBuddy 连不上

按 WorkBuddy 配置步骤逐项核对：

1. 使用自定义模型入口。
2. 地址按教程复制。
3. Key 来自本平台。
4. 模型名称从模型广场复制。
5. 保存后，在对话界面选中该模型再测试。

去哪里看使用情况？

• 使用记录：查看请求和已记录费用。
• 仪表盘：查看汇总信息，最新数据可能稍后更新。
• 钱包：查看可用余额和个人充值记录。

需要联系平台支持时，提供错误说明、调用时间、模型名称，以及视频任务 ID（如果有）。不要发送 API Key、登录密码或带访问凭据的完整结果链接。