Generate image from text (OpenAI SDK)

API Reference

Generate images from text prompts using the OpenAI SDK client.images.generate() method.

Setup

from openai import OpenAI
client = OpenAI(api_key='sk-snap-xxx', base_url='https://api.snapedit.app/v1')

Supported Models

Model	Description	Credit
`snapedit/z-image`	Text to Image (Z-Image)	9
`snapedit/qwen-image`	Text to Image (Qwen)	4

Examples

Python:

result = client.images.generate(
    model='snapedit/z-image',
    prompt='a cute cat sitting on a cloud',
    size='1024x1024'
)
print(result.data[0].url)

Node.js:

const result = await client.images.generate({
    model: 'snapedit/z-image',
    prompt: 'a cute cat sitting on a cloud',
    size: '1024x1024'
});
console.log(result.data[0].url);

Size Mapping

size is auto-converted to aspect_ratio:
- 1024x1024 → 1:1
- 1792x1024 → 16:9
- 1024x1792 → 9:16
- 1536x1024 → 3:2
- 1024x1536 → 2:3

post/v1/images/generations (OpenAI SDK)

Authorization — This endpoint requires an API key. Pass it in the api-key header on every request. Learn more

Responses

Image generated successfullySingleImageResponse

Field	Type	Description
`created`	integer	Unix timestamp of when the response was created
`data`	object[]
`url`	string	URL to download the result image

curl -X POST "https://api.snapedit.app/v1/images/generations (OpenAI SDK)" \
  -H "api-key: YOUR_API_KEY"

Response

{
  "created": 1745827200,
  "data": [
    {
      "url": "https://outputs.snapedit.app/outputs/abc123.png"
    }
  ]
}