Images

Use Images for native image generation and editing. Voxvey accepts provider-prefixed model IDs and routes each request to the provider that supports the selected image model.

POST /v1/images/generations
POST /v1/images/edits

Generate an image

curl https://api.voxvey.com/v1/images/generations \
  -H "Authorization: Bearer $VOXVEY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-1",
    "prompt": "A clean product icon for a developer API gateway",
    "size": "1024x1024"
  }'

Example response shape:

{
  "created": 1780711561,
  "data": [
    {
      "b64_json": "..."
    }
  ],
  "usage": {
    "total_tokens": 120
  }
}

Edit an image

OpenAI-style image edits use multipart form data:

curl https://api.voxvey.com/v1/images/edits \
  -H "Authorization: Bearer $VOXVEY_TOKEN" \
  -F "model=openai/gpt-image-1" \
  -F "image[][email protected]" \
  -F "prompt=Remove the background and keep the subject centered"

xAI image edits can also be sent as JSON when the selected xAI model supports that shape.

Model routing

Provider prefix	Notes
openai/	Forwards to OpenAI image generation and edit routes.
xai/	Forwards to xAI image generation and edit routes.
byte/	Forwards image generation models through the supported media backend.
gemini/	Adapts Gemini image generation through native Gemini content generation.

Use /v1/models to discover the currently available image model IDs.