Image Generation

Mesh API exposes a standalone OpenAI-compatible image generation endpoint at POST /v1/images/generations, supporting models from OpenAI (gpt-image-*, dall-e-3) and Vertex AI (Imagen).

Endpoint

POST /v1/images/generations

Parameters

Streaming

Setting stream: true returns a text/event-stream response that prevents the connection from closing during long-running generations.

The stream always ends with data: [DONE].

Keep-alive chunk sequence

data: {"id":"img-...","object":"image.chunk","created":...,"model":"...","data":[],"status":"processing"}
: ping
: ping
data: {"id":"...","object":"image.chunk","created":...,"data":[{"url":"..."}]}
data: [DONE]

Response

1
{
2
  "created": 1715356800,
3
  "data": [
4
    {
5
      "url": "https://...",
6
      "revised_prompt": "..."
7
    }
8
  ],
9
  "background": "opaque",
10
  "output_format": "webp",
11
  "quality": "high",
12
  "size": "1024x1024",
13
  "usage": {
14
    "prompt_tokens": 100,
15
    "completion_tokens": 1000,
16
    "total_tokens": 1100
17
  }
18
}

background, output_format, quality, size, and usage are only present when the upstream provider returns them. Vertex AI (Imagen) does not return token usage. Vertex AI always returns b64_json regardless of response_format.

Examples

Standard generation

$
curl -X POST https://api.meshapi.ai/v1/images/generations \
>
  -H "Authorization: Bearer YOUR_MESH_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "model": "openai/gpt-image-1",
>
    "prompt": "A watercolor of a fox in a snowy forest",
>
    "n": 1,
>
    "size": "1024x1024",
>
    "quality": "high",
>
    "output_format": "webp"
>
  }'

Streaming

$
curl -X POST https://api.meshapi.ai/v1/images/generations \
>
  -H "Authorization: Bearer YOUR_MESH_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "model": "openai/gpt-image-1",
>
    "prompt": "A watercolor of a fox in a snowy forest",
>
    "stream": true
>
  }'