Imagine Turbo

Generate rapid, high-quality images with speed and precision. Ideal for quick conceptual designs and visualizations.

Endpoint

The endpoint for Text to Image API is

$
POST https://api.vyro.ai/v2/image/generations

Headers

You need to pass the following headers along with the request.

Request Body Parameters

Below are the parameters for multipart/form-data that allow for a high degree of customization when generating videos.

Example API Call

Here’s a sample curl request that uses the parameters above:

$
curl --location --request POST 'https://api.vyro.ai/v2/image/generations' \
--header 'Authorization: Bearer {{API_TOKEN}}' \
--form 'prompt="A futuristic cityscape at night with neon lights"' \
--form 'style="imagine-turbo"' \
--form 'aspect_ratio="1:1"'

Response

Upon a successful request, the API returns a binary image file which can be directly rendered or saved.

$
<image-file>

Error Handling

This section provides an in-depth explanation of errors encountered while interacting with Imagine’s system. Errors are categorized to help you pinpoint issues and apply effective solutions.

Error Schema

In case of any error, the API will return a response in the following JSON format:

$
{
  "status": "error",
  "code": "<error-code>",
  "error": "<error-name>",
  "message": "<detailed-error-description>"
}

This structure ensures consistency in error handling and provides clear information for debugging and resolution.

Errors in the Imagine system are grouped into four main categories:

• Authorization Errors
• Validation Errors
• Service Errors
• General Errors

Each category is explored in detail below.

Authorization Errors

Authorization errors relate to user authentication and access privileges. Common errors include:

Validation Errors

Validation errors occur when submitted data does not meet criteria. Example:

Service Errors

Service errors can arise due to server or connectivity issues:

General Errors

General errors are broad error categories covering multiple issues:

If you face Service Error or General Errors, please reach out to Imagine Support as soon as possible.