Skip to main content
All errors return specific HTTP status codes and detailed error messages in the detail field.

​
Error Categories

  • User Errors
  • Version Errors
  • Generation Errors
  • System Errors
Issues caused by invalid requests or insufficient resources.
HTTP Status: 402 Payment RequiredDescription: Not enough credits to complete the requestSolution: Add more credits to your account
{
  "detail": "INSUFFICIENT_CREDITS"
}
HTTP Status: 404 Not FoundDescription: Generation with specified ID does not existSolution: Verify the generation ID is correct
{
  "detail": "Generation not found"
}
HTTP Status: 401 UnauthorizedDescription: API key not provided or invalidSolution: Include valid Bearer token in Authorization header
{
  "detail": "Missing credentials"
}
HTTP Status: 422 Validation ErrorDescription: Request parameters are invalid or missing required fieldsSolution: Check parameter values and types
{
  "detail": "Validation error: prompt is required"
}

​
HTTP Status Code Reference

​
201
Created
Generation created successfully
​
200
OK
Request successful
​
400
Bad Request
Invalid parameters or request format
​
401
Unauthorized
Invalid or missing API key
​
402
Payment Required
Insufficient credits
​
404
Not Found
Generation not found
​
422
Validation Error
Invalid input format or missing required fields
​
500
Internal Server Error
Server-side error
​
503
Service Unavailable
Service temporarily unavailable

​
Model Compatibility Matrix

Use this matrix to understand which features are supported by each model version.
Feature1.62.1 Pro2.1 Master2.5 Turbo2.6
Text-to-VideoYesNoYesYesYes
Image-to-VideoYesYesYesYesYes
Audio SupportNoNoNoNoYes
Negative PromptYesYesYesNoNo
CFG ScaleYesNoNoNoNo
Standard ModeYesNoYesYesNo
Professional ModeYesYesYesYesAlways
Priority ProcessingNoNoNoNoYes

​
Webhook Error Codes

When using webhooks with Kling 2.6 or O1 Photo, you may receive these error codes in the message field:
​
TIMEOUT
Generation Error
Generation exceeded 15-minute timeout limit (automatic refund)
​
CONTENT_POLICY_VIOLATION
Content Error
Content violates usage policies
​
TASK_FAILED
System Error
Generation failed due to system error (automatic refund)
​
INVALID_IMAGE
User Error
Provided image is not valid or corrupted
​
IMAGE_INACCESSIBLE
User Error
Image URL is inaccessible or invalid
Always check model compatibility before making requests to avoid validation errors.