Skip to main content
POST
/
images
/
generations
Create image
curl --request POST \
  --url https://api.xtrix.workers.dev/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "dall-e-3",
  "prompt": "<string>"
}'
{
  "created": 123,
  "data": [
    {
      "b64_json": "<string>",
      "revised_prompt": "<string>"
    }
  ]
}

​
Request Body

​
model
string
required
Model to use (e.g., dall-e-3).
​
prompt
string
required
Text description of the image to generate.
​
n
integer
default:1
Number of images to generate (1-10).
​
size
string
default:"1024x1024"
Image size. Options: 256x256, 512x512, 1024x1024, 1792x1024, 1024x1792.

​
Example Request

curl https://api.xtrix.workers.dev/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "dall-e-3",
    "prompt": "A serene landscape with mountains",
    "n": 1,
    "size": "1024x1024"
  }'

​
Response

{
  "created": 1677858242,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
      "revised_prompt": "A serene landscape featuring majestic mountains"
    }
  ]
}

​
Working with Base64 Images

The API returns images as base64-encoded strings. To display in HTML: 
<img src="data:image/png;base64,{b64_json_value}" alt="Generated image" />
To save as a file in Python: 
import base64
from PIL import Image
import io

image_data = base64.b64decode(response.data[0].b64_json)
image = Image.open(io.BytesIO(image_data))
image.save("generated_image.png")

Authorizations

​
Authorization
string
header
required

API key authentication

Body

application/json
​
model
string
required

ID of the model to use

Example:

"dall-e-3"

​
prompt
string
required

Text description of the desired image(s)

Maximum length: 4000
​
n
integer
default:1

Number of images to generate

Required range: 1 <= x <= 10
​
size
enum<string>
default:1024x1024

Size of the generated images

Available options:
256x256,
512x512,
1024x1024,
1792x1024,
1024x1792
​
response_format
enum<string>
default:b64_json
Available options:
b64_json
​
user
string

Unique identifier for end-user

Response

Successful response

​
created
integer

Unix timestamp of creation

​
data
object[]