Prism API Error Codes and Response Format

Reference Prism API error response bodies, HTTP status codes, validation failures, authentication problems, credit errors, and common recovery steps.

All errors return a consistent JSON body with an error code and a human-readable message.

Error format

{
  "error": "error_code",
  "message": "Human-readable description of what went wrong"
}

Error codes

HTTP Status	Error Code	Description
400	validation_error	The request body or parameters are invalid
400	pricing_error	No pricing available for the model configuration
401	unauthorized	The API key is missing, invalid, or expired
402	insufficient_credits	Not enough credits for the requested generation
403	forbidden	The API key does not have the required scope
404	not_found	The requested resource does not exist
422	invalid_template	The template has an invalid or incomplete configuration
500	server_error	An unexpected error occurred on the server
500	generation_error	An unexpected error occurred during generation

Common scenarios

Missing API key

curl https://www.prismvideos.com/api/templates
# 401: { "error": "unauthorized", "message": "Invalid or missing API key" }

Invalid character search query

curl "https://www.prismvideos.com/api/characters?q=a" \
  -H "Authorization: Bearer prism_sk_your_key_here"
# 400: { "error": "validation_error", "message": "Query parameter 'q' must be at least 2 characters" }

Revoked API key

A revoked key returns the same 401 response as an invalid key. Create a new key if yours has been revoked.

Template not found

curl https://www.prismvideos.com/api/templates/nonexistent_id \
  -H "Authorization: Bearer prism_sk_your_key_here"
# 404: { "error": "not_found", "message": "Template not found" }