POST /image/generate — AI Image Generation API

The Nexus Image Generation endpoint lets you create AI-generated images directly from a text description. You specify what the image should contain and optionally control the visual style, output dimensions, and how many images to produce in a single request. The API returns a list of image URLs hosted on the Verbosec CDN that you can download or embed immediately. Endpoint

POST https://api.verbosec.com/v1/image/generate

Request parameters

string

required

A text description of the image you want to generate. The more descriptive and specific your prompt, the more accurately the output will reflect your intent.

string

The visual style applied to the generated image. Accepted values are "photorealistic", "illustration", and "abstract". Defaults to "photorealistic".

string

The pixel dimensions of the output image. Accepted values are "512x512", "1024x1024", and "1024x1792". Defaults to "1024x1024". Choose "1024x1792" for portrait-format images.

integer

The number of images to generate in this request. Accepts an integer between 1 and 4 inclusive. Defaults to 1. Each image consumes tokens separately.

Example request

generate-image.sh

curl -X POST https://api.verbosec.com/v1/image/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A sunlit mountain lake at dawn with mist rising off the water",
    "style": "photorealistic",
    "size": "1024x1024",
    "count": 2
  }'

Example response

response.json

{
  "id": "img_xyz789",
  "images": [
    {
      "url": "https://cdn.verbosec.com/images/img_xyz789_1.png",
      "size": "1024x1024"
    },
    {
      "url": "https://cdn.verbosec.com/images/img_xyz789_2.png",
      "size": "1024x1024"
    }
  ],
  "created_at": "2025-01-15T10:31:00Z"
}

Response fields

string

A unique identifier for this image generation request.

array

An array of image objects, one for each image generated. The length of this array matches the count value you specified in the request.

Show Image object fields

string

The CDN URL where the generated image is hosted. Use this URL to download or embed the image.

string

The pixel dimensions of this specific image, reflecting the size parameter you passed.

string

An ISO 8601 timestamp indicating when the images were generated.

Image URLs are available for 24 hours after generation. If you need to retain the images beyond that window, download them to your own storage immediately after the request completes.

Error responses

400 Bad Request — Missing or invalid parameters

Returned when the prompt field is missing or a parameter value falls outside its accepted range (for example, count: 5).

400-response.json

{
  "error": {
    "code": "invalid_parameter",
    "message": "The 'count' parameter must be between 1 and 4."
  }
}

401 Unauthorized

Returned when your API key is missing or invalid. See the Authentication guide for help.

401-response.json

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key."
  }
}

429 Too Many Requests — Rate limited

Returned when you have exceeded your plan’s rate limit. Check the Retry-After header and wait before resending the request.

429-response.json

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "You have exceeded your plan's rate limit. Please wait before retrying."
  }
}

Overview

Nexus AI API

Starhost API

POST /image/generate — AI Image Generation API

Request parameters

Example request

Example response

Response fields

Error responses

​Request parameters

​Example request

​Example response

​Response fields

​Error responses

Request parameters

Example request

Example response

Response fields

Error responses