Errors

deAPI uses conventional HTTP response codes to indicate the success or failure of an API request. Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error from the provided information (e.g., missing required parameter, unauthorized access). Codes in the 5xx range indicate an error with deAPI servers.

HTTP Status Codes

Code	Status	Description
`200`	OK	Request succeeded. Response contains requested data.
`401`	Unauthorized	Invalid or missing API key.
`404`	Not Found	The requested resource (job, model) does not exist.
`422`	Unprocessable Entity	Request validation failed. Check the `errors` array for details.
`429`	Too Many Request	Rate limit exceeded.
`500`	Internal Server Error	Something went wrong on our end. Try again later.

Error Response Format

All error responses follow a consistent JSON structure:

{
  "data": null,
  "message": "Error general message",
  "errors": [],
  "statusCode": 401
}

object | null

Always null for error responses.

string

Human-readable error description.

array

Additional error details. For validation errors (422), contains field-specific messages.

integer

HTTP status code (matches the response status).

Error Types

401 Unauthorized

Returned when authentication fails. Common causes:

Missing Authorization header
Invalid API key
Expired API key

{
  "data": null,
  "message": "Unauthorized user.",
  "errors": [],
  "statusCode": 401
}

Solution: Verify your API key is correct and included in the Authorization: Bearer <API_KEY> header.

404 Not Found

Returned when the requested resource doesn’t exist. Common causes:

Invalid request_id when polling results
Model name doesn’t exist
Request ID not found

{
  "data": null,
  "message": "Request not found.",
  "errors": [],
  "statusCode": 404
}

Solution: Verify the resource identifier (request_id, model name) is correct. Use the Model Selection endpoint to get valid model names.

422 Unprocessable Entity

Returned when request validation fails. The errors array contains field-specific details. Common causes:

Missing required parameters
Invalid parameter values (out of range, wrong type)
Invalid image/video URL or format

{
  "data": null,
  "message": "Validation failed",
  "errors": [
    {
      "field": "width",
      "messages": ["The width must be between 64 and 2048."]
    },
    {
      "field": "model",
      "messages": ["The selected model does not exist."]
    }
  ],
  "statusCode": 422
}

Solution: Check the errors array to identify which fields failed validation and correct them according to the API documentation.

500 Internal Server Error

Returned when an unexpected error occurs on our servers.

{
  "data": null,
  "message": "Internal server error",
  "errors": [],
  "statusCode": 500
}

Solution: Wait a moment and retry your request. If the problem persists, check status.deapi.ai or contact support on Discord.

Best Practices

Handle all error codes

Implement error handling for all possible status codes in your application.

Parse the errors array

For 422 responses, iterate through the errors array to display field-specific messages to users.

Implement retry logic

For 500 errors, implement exponential backoff retry (e.g., 1s, 2s, 4s delays).

Log error responses

Log full error responses for debugging. Include request_id if available.

Example Error Handling

import requests

response = requests.post(
    "https://api.deapi.ai/api/v2/images/generations",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json"
    },
    json={
        "prompt": "a cat",
        "model": "Flux1schnell",
        "width": 512,
        "height": 512,
        "steps": 4,
        "guidance": 0,
        "seed": -1,
        "loras": []
    }
)

if response.status_code == 200:
    data = response.json()
    request_id = data["data"]["request_id"]
    print(f"Job started: {request_id}")
elif response.status_code == 401:
    print("Authentication failed. Check your API key.")
elif response.status_code == 422:
    error_data = response.json()
    print(f"Validation error: {error_data['message']}")
    for error in error_data.get("errors", []):
        print(f"  Field '{error['field']}': {error['messages']}")
elif response.status_code == 500:
    print("Server error. Retrying...")
else:
    print(f"Unexpected error: {response.status_code}")

const response = await fetch("https://api.deapi.ai/api/v2/images/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
    "Accept": "application/json"
  },
  body: JSON.stringify({
    prompt: "a cat",
    model: "Flux1schnell",
    width: 512,
    height: 512,
    steps: 4,
    guidance: 0,
    seed: -1,
    loras: []
  })
});

if (response.ok) {
  const data = await response.json();
  const requestId = data.data.request_id;
  console.log(`Job started: ${requestId}`);
} else if (response.status === 401) {
  console.error("Authentication failed. Check your API key.");
} else if (response.status === 422) {
  const errorData = await response.json();
  console.error(`Validation error: ${errorData.message}`);
  errorData.errors?.forEach(err => {
    console.error(`  Field '${err.field}': ${err.messages.join(", ")}`);
  });
} else if (response.status === 500) {
  console.error("Server error. Retrying...");
} else {
  console.error(`Unexpected error: ${response.status}`);
}

Overview

Images

Videos

Audio

Embeddings

Prompt Enhancement

Utilities

HTTP Status Codes

Error Response Format

Error Types

401 Unauthorized

404 Not Found

422 Unprocessable Entity

500 Internal Server Error

Best Practices

Handle all error codes

Parse the errors array

Implement retry logic

Log error responses

Example Error Handling

​HTTP Status Codes

​Error Response Format

​Error Types

​401 Unauthorized

​404 Not Found

​422 Unprocessable Entity

​500 Internal Server Error

​Best Practices

Handle all error codes

Parse the errors array

Implement retry logic

Log error responses

​Example Error Handling

HTTP Status Codes

Error Response Format

Error Types

401 Unauthorized

404 Not Found

422 Unprocessable Entity

500 Internal Server Error

Best Practices

Example Error Handling