Skip to main content

Error codes

code in an error body names the specific failure, in the form PREFIX_NUMBER. Handle errors by type (see Errors) and log the code. Codes not listed here can appear; treat them by their type and HTTP status. The same codes appear as error_code on a job that ends FAILED.

PrefixArea
GATEWAY_, CUSTOM_API_GATEWAY_Routing, authentication and rate limiting at the API edge
AUTH_Accounts, API keys and permissions
GENERATION_Generation requests and jobs
AI_MODEL_The model catalog
CREDIT_Balance and charges
BILLING_Payments and plans
NOTIFICATION_Webhooks and notifications

All codes​

CodeTypeUsual status
CUSTOM_API_GATEWAY_400invalid_request400
AUTH_1001authentication_error401
AUTH_1002permission_denied403
AUTH_1003authentication_error401
AUTH_1004authentication_error401
AUTH_1005permission_denied403
AUTH_1006conflict409
AUTH_1007conflict409
AUTH_1008permission_denied403
AUTH_1009authentication_error401
AUTH_1010authentication_error401
AUTH_1011permission_denied403
AUTH_1012authentication_error401
AUTH_1013authentication_error401
AUTH_1014internal_error500
AUTH_1015invalid_request400
AUTH_1016not_found404
AUTH_1017invalid_request400
AUTH_1018invalid_request400
AUTH_1019authentication_error401
AUTH_1020invalid_request400
AUTH_1021internal_error500
AUTH_1022service_unavailable503
AUTH_1024not_found404
AUTH_1025permission_denied403
AUTH_1026permission_denied403
AUTH_1029rate_limited429
AUTH_1030invalid_request400
GENERATION_2000invalid_request400
GENERATION_2001insufficient_quota402
GENERATION_2002model_not_found404
GENERATION_2003internal_error500
GENERATION_2004not_found404
GENERATION_2005invalid_request400
GENERATION_2006provider_unavailable503
GENERATION_2007not_found404
GENERATION_2008provider_error502
GENERATION_2009not_found404
GENERATION_2010internal_error500
GENERATION_2011invalid_request400
GENERATION_2012internal_error500
GENERATION_2013service_unavailable503
GENERATION_2014model_unavailable503
GENERATION_2015provider_unavailable503
GENERATION_2016model_not_found404
GENERATION_2017timeout504
GENERATION_2018content_policy400
CREDIT_3000invalid_request400
CREDIT_3001insufficient_quota402
CREDIT_3002internal_error500
CREDIT_3003not_found404
CREDIT_3004invalid_request400
CREDIT_3005invalid_request400
CREDIT_3006not_found404
CREDIT_3007quota_exceeded429
CREDIT_3008internal_error500
CREDIT_3009internal_error500
CREDIT_3030service_unavailable503
FILE_4000invalid_request400
FILE_4001not_found404
FILE_4002internal_error500
FILE_4003payload_too_large413
FILE_4004invalid_request400
FILE_4005internal_error500
FILE_4006internal_error500
FILE_4007not_found404
FILE_4008conflict409
FILE_4009invalid_request400
FILE_4010conflict409
AI_MODEL_5000invalid_request400
AI_MODEL_5001model_not_found404
AI_MODEL_5002internal_error500
AI_MODEL_5003invalid_request400
AI_MODEL_5004model_not_found404
AI_MODEL_5005provider_error502
NOTIFICATION_6000invalid_request400
NOTIFICATION_6001not_found404
NOTIFICATION_6002provider_error502
NOTIFICATION_6003invalid_callback_url400
NOTIFICATION_6004not_found404
ANALYTICS_8000invalid_request400
ANALYTICS_8001internal_error500
ANALYTICS_8002not_found404
SOCIAL_9000invalid_request400
SOCIAL_9001not_found404
SOCIAL_9002not_found404
SOCIAL_9003conflict409
SOCIAL_9004conflict409
SUPPORT_10000invalid_request400
SUPPORT_10001not_found404
SUPPORT_10002internal_error500
SUPPORT_10003not_found404
BILLING_11000invalid_request400
BILLING_11001provider_error502
BILLING_11002not_found404
BILLING_11003not_found404
BILLING_11004invalid_request400
BILLING_11005internal_error500
BILLING_11006internal_error500
BILLING_11007internal_error500
BILLING_11008internal_error500
MONITORING_12000invalid_request400
MONITORING_12001internal_error500
MONITORING_12002internal_error500
GATEWAY_13000invalid_request400
GATEWAY_13001service_unavailable503
GATEWAY_13002timeout504
GATEWAY_13003service_unavailable503
GATEWAY_13004not_found404
GATEWAY_13005invalid_request400
GATEWAY_13006authentication_error401
GATEWAY_13029rate_limited429
CONTENT_MODERATION_14000internal_error500
CONTENT_MODERATION_14001invalid_request400
CONTENT_MODERATION_14002authentication_error401
CONTENT_MODERATION_14003permission_denied403
CONTENT_MODERATION_14004not_found404
CONTENT_MODERATION_14005conflict409
CONTENT_MODERATION_14006invalid_request400
CONTENT_MODERATION_14007rate_limited429
CONTENT_MODERATION_14008provider_error502
CONTENT_MODERATION_14009service_unavailable503
CONTENT_MODERATION_14010timeout504
CONTENT_MODERATION_14011content_policy400
CONTENT_MODERATION_14012content_policy400
CONTENT_MODERATION_14013content_policy400
CONTENT_MODERATION_14014content_policy400
CONTENT_MODERATION_14015invalid_request400
CONTENT_MODERATION_14016invalid_request400
CONTENT_MODERATION_14017internal_error500
CONTENT_MODERATION_14018not_found404
CONTENT_MODERATION_14019invalid_request400
CONTENT_MODERATION_14020internal_error500
CONTENT_MODERATION_14021not_found404
CONTENT_MODERATION_14022not_found404
CONTENT_MODERATION_14023conflict409
CONTENT_MODERATION_14031not_found404
CONTENT_MODERATION_14032conflict409
CONTENT_MODERATION_14033invalid_request400
CONTENT_MODERATION_14034invalid_request400
CONTENT_MODERATION_14035internal_error500
CONTENT_MODERATION_14036invalid_request400
CONTENT_MODERATION_14051not_found404
CONTENT_MODERATION_14052conflict409
CONTENT_MODERATION_14053conflict409
CONTENT_MODERATION_14054invalid_request400
CONTENT_MODERATION_14055conflict409
CONTENT_MODERATION_14056internal_error500
CONTENT_MODERATION_14071conflict409
CONTENT_MODERATION_14072not_found404
CONTENT_MODERATION_14073not_found404
CONTENT_MODERATION_14074internal_error500
CONTENT_MODERATION_14075conflict409
CONTENT_MODERATION_14076not_found404
CONTENT_MODERATION_14086internal_error500
CONTENT_MODERATION_14087service_unavailable503
CONTENT_MODERATION_14088internal_error500
CONTENT_MODERATION_14089internal_error500

When you contact support, include the request_id and the full error body.