Image generation streaming events

💡 Troubleshooting

Running into an error while calling the API? See the API error code reference for a complete list of error types and troubleshooting steps.

Image streaming can return image generation and editing results in real time through Server-Sent Events. When generating images, set stream: true in the request body for POST https://zenmux.ai/api/v1/images/generations.

cURL

curl https://zenmux.ai/api/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ZENMUX_API_KEY" \
  -d '{
    "model": "gpt-image-1.5",
    "prompt": "A cute baby sea otter",
    "n": 1,
    "size": "1024x1024",
    "stream": true
  }' \
  --no-buffer

TypeScript

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://zenmux.ai/api/v1", 
  apiKey: process.env.ZENMUX_API_KEY, 
});

const stream = await client.images.generate({
  model: "gpt-image-1.5",
  prompt: "A cute baby sea otter",
  n: 1,
  size: "1024x1024",
  stream: true,
});

for await (const event of stream) {
  console.log(event);
}

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://zenmux.ai/api/v1",  
    api_key="<ZENMUX_API_KEY>",  
)

stream = client.images.generate(
    model="gpt-image-1.5",
    prompt="A cute baby sea otter",
    n=1,
    size="1024x1024",
    stream=True
)

for event in stream:
    print(event)

text

event: image_generation.partial_image
data: {"type":"image_generation.partial_image","b64_json":"...","partial_image_index":0}

event: image_generation.completed
data: {"type":"image_generation.completed","b64_json":"...","usage":{"total_tokens":100,"input_tokens":50,"output_tokens":50,"input_tokens_details":{"text_tokens":10,"image_tokens":40}}}

image_generation.partial_image

Triggered during image generation streaming when a partial image is available.

b64_json string

Base64-encoded partial image data, which can be rendered directly as an image.

background string

The requested background setting for the image.

Possible values:

• transparent
• opaque
• auto

created_at number

The Unix timestamp when the event was created.

output_format string

The requested output format for the image.

Possible values:

• png
• webp
• jpeg

partial_image_index number

The zero-based index of the partial image (streaming).

quality string

The requested quality setting for the image.

Possible values:

• low
• medium
• high
• auto

size string

The requested image size.

Possible values:

• 1024x1024
• 1024x1536
• 1536x1024
• auto

type string

The event type. Always image_generation.partial_image.

{
  "type": "image_generation.partial_image",
  "b64_json": "...",
  "created_at": 1620000000,
  "size": "1024x1024",
  "quality": "high",
  "background": "transparent",
  "output_format": "png",
  "partial_image_index": 0
}

image_generation.completed

Triggered when image generation has completed and the final image is available.

b64_json string

Base64-encoded image data, which can be rendered directly as an image.

background string

The background setting for the generated image.

Possible values:

• transparent
• opaque
• auto

created_at number

The Unix timestamp when the event was created.

output_format string

The output format of the generated image.

Possible values:

• png
• webp
• jpeg

quality string

The quality setting for the generated image.

Possible values:

• low
• medium
• high
• auto

size string

The size of the generated image.

Possible values:

• 1024x1024
• 1024x1536
• 1536x1024
• auto

type string

The event type. Always image_generation.completed.

usage object

Returned only by GPT image models. Indicates token usage information for image generation.

input_tokens number

The number of image and text tokens in the input prompt.

input_tokens_details object

Input token details for image generation.

• image_tokens number: The number of image tokens in the input prompt.
• text_tokens number: The number of text tokens in the input prompt.

output_tokens number

The number of image tokens in the output image.

total_tokens number

The total number of image and text tokens used for this image generation.

{
  "type": "image_generation.completed",
  "b64_json": "...",
  "created_at": 1620000000,
  "size": "1024x1024",
  "quality": "high",
  "background": "transparent",
  "output_format": "png",
  "usage": {
    "total_tokens": 100,
    "input_tokens": 50,
    "output_tokens": 50,
    "input_tokens_details": {
      "text_tokens": 10,
      "image_tokens": 40
    }
  }
}