Generate an image - Yelu AI API

curl https://api.yelu.ai/v1/images/generations \
  -H "Authorization: Bearer $YELU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "An isometric illustration of a calm API gateway routing beams of light between model clouds, violet and indigo palette",
    "size": "1024x1024",
    "n": 1,
    "response_format": "url"
  }'

const response = await fetch('https://api.yelu.ai/v1/images/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.YELU_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'dall-e-3',
    prompt: 'An isometric illustration of a calm API gateway routing beams of light between model clouds, violet and indigo palette',
    size: '1024x1024',
    n: 1,
    response_format: 'url',
  }),
});

if (!response.ok) throw new Error(await response.text());
console.log((await response.json()).data[0].url);

import os
import requests

response = requests.post(
    "https://api.yelu.ai/v1/images/generations",
    headers={"Authorization": f"Bearer {os.environ['YELU_API_KEY']}"},
    json={
        "model": "dall-e-3",
        "prompt": "An isometric illustration of a calm API gateway routing beams of light between model clouds, violet and indigo palette",
        "size": "1024x1024",
        "n": 1,
        "response_format": "url",
    },
    timeout=180,
)
response.raise_for_status()
print(response.json()["data"][0]["url"])

{
  "created": 1783900800,
  "data": [
    {
      "url": "https://cdn.example.invalid/generated/image-01.png",
      "revised_prompt": "An isometric technical illustration of a reliable AI gateway..."
    }
  ]
}

{
  "error": {
    "message": "The requested size is not supported by this model.",
    "type": "invalid_request_error",
    "param": "size",
    "code": "invalid_value"
  }
}

POST

images

generations

curl https://api.yelu.ai/v1/images/generations \
  -H "Authorization: Bearer $YELU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "An isometric illustration of a calm API gateway routing beams of light between model clouds, violet and indigo palette",
    "size": "1024x1024",
    "n": 1,
    "response_format": "url"
  }'

const response = await fetch('https://api.yelu.ai/v1/images/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.YELU_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'dall-e-3',
    prompt: 'An isometric illustration of a calm API gateway routing beams of light between model clouds, violet and indigo palette',
    size: '1024x1024',
    n: 1,
    response_format: 'url',
  }),
});

if (!response.ok) throw new Error(await response.text());
console.log((await response.json()).data[0].url);

import os
import requests

response = requests.post(
    "https://api.yelu.ai/v1/images/generations",
    headers={"Authorization": f"Bearer {os.environ['YELU_API_KEY']}"},
    json={
        "model": "dall-e-3",
        "prompt": "An isometric illustration of a calm API gateway routing beams of light between model clouds, violet and indigo palette",
        "size": "1024x1024",
        "n": 1,
        "response_format": "url",
    },
    timeout=180,
)
response.raise_for_status()
print(response.json()["data"][0]["url"])

{
  "created": 1783900800,
  "data": [
    {
      "url": "https://cdn.example.invalid/generated/image-01.png",
      "revised_prompt": "An isometric technical illustration of a reliable AI gateway..."
    }
  ]
}

{
  "error": {
    "message": "The requested size is not supported by this model.",
    "type": "invalid_request_error",
    "param": "size",
    "code": "invalid_value"
  }
}

Generates one or more images from a text prompt. Supported fields, sizes, output formats, and quality controls depend on the selected image model.

Endpoint

POST https://api.yelu.ai/v1/images/generations

Headers

Authorization

string

required

API key using the format Bearer $YELU_API_KEY.

Content-Type

string

required

Must be application/json.

Request body

model

string

required

An image-capable model ID available to your account.

prompt

string

required

Description of the image to create. Prompt length limits are model-specific.

integer

default:"1"

Number of images to generate when supported. Validate this value to control cost.

size

string

Requested dimensions such as 1024x1024. Accepted values depend on the model.

quality

string

Model-specific quality setting such as standard or hd, when supported.

style

string

Model-specific style control, when supported.

response_format

string

default:"url"

url or b64_json, subject to model support. URLs can expire; download them promptly.

user

string

Stable, non-sensitive end-user identifier for abuse monitoring and attribution.

Response

created

integer

required

Unix timestamp for generation.

data

array

required

Generated image objects. Each object contains url or b64_json, and can include revised_prompt.

curl https://api.yelu.ai/v1/images/generations \
  -H "Authorization: Bearer $YELU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "An isometric illustration of a calm API gateway routing beams of light between model clouds, violet and indigo palette",
    "size": "1024x1024",
    "n": 1,
    "response_format": "url"
  }'

const response = await fetch('https://api.yelu.ai/v1/images/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.YELU_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'dall-e-3',
    prompt: 'An isometric illustration of a calm API gateway routing beams of light between model clouds, violet and indigo palette',
    size: '1024x1024',
    n: 1,
    response_format: 'url',
  }),
});

if (!response.ok) throw new Error(await response.text());
console.log((await response.json()).data[0].url);

import os
import requests

response = requests.post(
    "https://api.yelu.ai/v1/images/generations",
    headers={"Authorization": f"Bearer {os.environ['YELU_API_KEY']}"},
    json={
        "model": "dall-e-3",
        "prompt": "An isometric illustration of a calm API gateway routing beams of light between model clouds, violet and indigo palette",
        "size": "1024x1024",
        "n": 1,
        "response_format": "url",
    },
    timeout=180,
)
response.raise_for_status()
print(response.json()["data"][0]["url"])

{
  "created": 1783900800,
  "data": [
    {
      "url": "https://cdn.example.invalid/generated/image-01.png",
      "revised_prompt": "An isometric technical illustration of a reliable AI gateway..."
    }
  ]
}

{
  "error": {
    "message": "The requested size is not supported by this model.",
    "type": "invalid_request_error",
    "param": "size",
    "code": "invalid_value"
  }
}

Error codes

Status	Code or type	Meaning
`400`	`invalid_request_error`	Invalid prompt, size, quality, count, or model capability.
`401`	`authentication_error`	Missing or invalid API key.
`403`	`permission_denied`	Image generation or the selected model is not enabled.
`404`	`model_not_found`	The image model is unavailable.
`429`	`rate_limit_error`	Request limit reached.
`500`–`504`	`server_error`	Temporary gateway or provider generation failure.

The response URL above uses the reserved .invalid domain to illustrate the response shape. Real successful responses contain a provider or Yelu delivery URL, or base64 image data when requested and supported.

Last modified on July 13, 2026

Create a response Create embeddings

​Endpoint

​Headers

​Request body

​Response

​Error codes

Endpoint

Headers

Request body

Response

Error codes