Images

BVE Gateway supports image generation and image editing.

Image Generation

POST https://api.bve.me/v1/images/generations

Requires Authorization: Bearer sk-bve-YOUR_KEY.

Generates images from a text prompt. Proxies directly to Fuelix.

Request body

{
  "model": "imagen-3",
  "prompt": "A photorealistic red apple on a white background",
  "n": 1
}

Field	Type	Required	Description
model	string	Yes	Image model (see below)
prompt	string	Yes	Text description of the image
n	integer	No	Number of images (default 1)
size	string	No	Image size (model-dependent)
quality	string	No	standard or hd
response_format	string	No	url or b64_json
style	string	No	natural or vivid (model-dependent)

Available image models

Model	Description
imagen-3	Google Imagen 3 — high-quality photorealistic images
imagen-3-fast	Google Imagen 3 Fast — faster generation, similar quality
imagen-4	Google Imagen 4 — latest generation
imagen-4-ultra	Google Imagen 4 Ultra — highest quality
dall-e-3	Listed in models API; availability via this endpoint may vary

Caution

dall-e-3 appears in the models list but may return errors from the /images/generations endpoint. Use imagen-3 or imagen-3-fast for reliable image generation.

Response

{
  "created": 1716288000,
  "data": [
    {
      "url": "https://..."
    }
  ]
}

cURL example

curl https://api.bve.me/v1/images/generations \
  -H "Authorization: Bearer sk-bve-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "imagen-3",
    "prompt": "A photorealistic red apple on a white background",
    "n": 1
  }'

OpenAI SDK

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-bve-YOUR_KEY',
  baseURL: 'https://api.bve.me/v1',
});

const image = await client.images.generate({
  model: 'imagen-3',
  prompt: 'A photorealistic red apple on a white background',
  n: 1,
});

console.log(image.data[0].url);

---

Image Edits

POST https://api.bve.me/v1/images/edits

Requires Authorization: Bearer sk-bve-YOUR_KEY.

Edits an existing image based on a prompt. Accepts multipart/form-data.

Request (multipart/form-data)

Field	Type	Required	Description
image	binary	Yes	PNG image to edit (max 4 MB, must be square)
prompt	string	Yes	Description of the desired edit
mask	binary	No	PNG mask (transparent areas indicate where to edit)
model	string	No	Image model to use
n	integer	No	Number of images
size	string	No	Image size
response_format	string	No	url or b64_json

cURL example

curl https://api.bve.me/v1/images/edits \
  -H "Authorization: Bearer sk-bve-YOUR_KEY" \
  -F image="@image.png" \
  -F prompt="Add a rainbow in the background" \
  -F model="imagen-3"

Notes

• Image variations (POST /v1/images/variations) are not supported by Fuelix and return 404.
• The multipart request is forwarded directly — no re-encoding or buffering.
• Image and mask files must be PNG format.