When interacting with the Soup.video API, you might encounter standard HTTP error codes.

Standard Error Codes

• 400 Bad Request: Missing or invalid parameters (e.g., missing prompt, unsupported resolution).
• 401 Unauthorized: Invalid or missing API key.
• 402 Payment Required: Insufficient credit balance to execute the requested generation.
• 403 Forbidden: You don’t have access to this resource (e.g., querying someone else’s Job ID, or calling a draft workflow that has not been published).
• 404 Not Found: The requested Job ID or endpoint does not exist.
• 500 Internal Server Error: An upstream provider or internal kitchen error occurred.

Automatic Refunds for Failed Jobs

Because AI generation is computationally intensive, jobs can occasionally fail due to upstream model timeouts, temporary network drops, or safety filter flags.

Our Guarantee: You are only billed for successful generations. If a job fails during processing and returns status: "failed" from the Status endpoint, the exact credit cost deducted at the start of that generation is automatically refunded back to your wallet.

No manual intervention is required on your part. You can verify these refunds in your account’s Ledger page.