Skip to main content

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[]=@input.png" \
  -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 prefixNotes
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.