常见错误

401 Unauthorized

通常表示 API Key 缺失、格式错误或已失效。

• 确认使用 Authorization: Bearer ...。
• 确认启动客户端的进程能读取对应环境变量。
• 检查密钥是否被撤销，不要在终端中直接打印密钥。

403 Forbidden

当前账户、令牌或渠道可能没有目标能力。检查控制台中的令牌权限、账户状态和调用日志。

404 Not Found

检查 Base URL 是否为 https://relay.withrpm.org/v1，以及路径是否重复包含 /v1。模型不存在也可能表现为模型相关的 404 错误，请重新查询 /v1/models。

429 Too Many Requests

可能是并发、速率或额度限制。降低并发，采用带随机抖动的指数退避，并在控制台检查额度与日志。

5xx 或上游错误

保留时间、模型、端点、状态码、请求 ID 和脱敏后的错误正文。先对短暂错误做有限重试；持续失败时换用最小请求排除参数问题。

请求长时间无响应

• 为 HTTP 客户端设置连接和总超时。
• 先关闭流式输出做最小测试。
• 检查代理是否正确传递 SSE，且没有缓冲流式响应。
• 缩短输入，排除超长请求造成的延迟。

视频任务一直未完成

视频接口是异步接口。POST /v1/videos 返回视频 ID 后，应通过 GET /v1/videos/{video_id} 查询状态，而不是一直等待提交请求返回视频文件。

• pending、queued 和 in_progress 表示任务仍在处理。
• 只有 completed 后才能调用 /v1/videos/{video_id}/content。
• failed 时读取响应中的 error.message，不要无限轮询。
• 查询和下载必须继续使用有权访问该任务的 API Key。

完整示例见视频生成。

提交问题前

请准备以下脱敏信息：请求时间、端点、模型、HTTP 状态码、请求 ID、客户端及版本、最小复现请求。不要提交 API Key 或未经处理的私人数据。