Error Codes

Cause: Invalid or missing parameters

Fix: Check the request body against the endpoint schema. Common issues: missing model field, duration out of range, unsupported resolution value.

Cause: Missing or invalid API key

Fix: Ensure the Authorization header is present and formatted as "Bearer YOUR_API_KEY". Verify the key is active and not revoked.

Cause: Insufficient credits or no active subscription

Fix: Check your credit balance at /dashboard or upgrade at /pricing. If you have a subscription, your credits may have been exhausted for this billing cycle.

Cause: API access not available on your plan

Fix: API access requires Pro or Premium. Upgrade at /pricing.

Cause: Job ID does not exist or does not belong to your account

Fix: Verify the job ID. Job IDs from other accounts are not accessible.

Cause: Input validation failed (Zod)

Fix: The request body parsed correctly but failed validation. Response body includes a "errors" array with field-level details.

Cause: Rate limit exceeded

Fix: Check the Retry-After response header and wait before retrying. See /docs/rate-limits for per-plan limits.

Cause: Unexpected server error

Fix: Retry the request after a short delay. If the error persists, contact support with the job ID or request timestamp.

Cause: Upstream generation service unavailable

Fix: The generation infrastructure is temporarily unavailable. Check /status for service status. Retry with exponential backoff.