Troubleshooting

Start with read-only checks:

Missing API key

Start with browser login:

For remote or headless terminals:

Manual API-key setup and environment variables are available for CI and server automation:

Wrong API base

Check local configuration:

The current production API base is:

Job created but no result yet

Jobs are async. Poll status:

Fetch the result only after completion:

If a local wait timed out, inspect the job before submitting another paid job.

Image / Video / Music CLI command missing

There is no sume image, sume video, or sume music subcommand in the shipped CLI. Submit those families through the Developer API (Image, Video, Music), then recover with sume jobs status / sume jobs result.

Local MCP not launched

Current releases report coming_soon. Use hosted MCP at https://mcp.sume.com/mcp for Cursor/Claude, or drive the CLI commands directly.

Media input rejected

Avatar media fields expect public HTTPS image URLs. For Avatar 1.0 photo input, use --type photo --image-url https://.... For Avatar Video, use --product-image https://... or --scene-image-url https://... where needed.

Common causes:

  1. The URL is not HTTPS.
  2. The URL points to localhost or a private network.
  3. The response is not an image.
  4. The URL requires cookies, auth headers, or a short-lived signature that expires before Sume can fetch it.

Do not paste private media URLs, signed URLs, or auth headers into public logs.

Report an issue

Include:

  • command name and flags, with secrets redacted;
  • sume version;
  • sanitized error code/message;
  • request id if present;
  • job id if the issue is job-specific;
  • whether auth came from env or local config.

Do not include API keys, signed URLs, private media URLs, raw provider payloads, emails, or workspace/user ids.