Operations
Troubleshooting
Connection, authorization, job, output, and credit failures.
Connection problems
| Symptom | Check |
|---|---|
| Client cannot discover OAuth | Open the protected-resource and authorization-server well-known URLs directly |
| Redirect URI rejected | Use the exact registered HTTPS URI or a loopback HTTP URI |
| 401 from MCP | Refresh the token, verify Bearer header, and ensure the token audience is this resource |
| CLI callback never arrives | Check browser, loopback firewall, and that the CLI process is still running |
Generation problems
| Symptom | Action |
|---|---|
| Job remains queued | Keep the original ID, check worker health, and do not resubmit automatically |
| Job failed | Read its error, adjust unsupported inputs, and estimate before retrying |
| No output URL | Poll until succeeded; queued and running jobs intentionally have no final asset |
| Insufficient credits | Reduce duration, resolution, quality, or batch size, or add credits |