Requesty supports image generation through two different endpoints: the dedicated Images API (/v1/images/generations and /v1/images/edits) for standard image workflows, and the Chat Completions API (/v1/chat/completions) for models that return images alongside text.
Images API (/v1/images/generations)
The dedicated images endpoint follows the OpenAI Images API format and is the recommended way to generate images with supported models.
Parameters
| Parameter | Type | Required | Description |
|---|
model | string | Yes | The model to use for image generation |
prompt | string | Yes | A text description of the desired image |
n | integer | No | Number of images to generate (default: 1) |
size | string | No | Image dimensions (e.g., 1024x1024, 1536x1024, 1024x1536) |
quality | string | No | Image quality (auto, high, medium, low) |
response_format | string | No | Output delivery format: url or b64_json (default: url) |
background | string | No | Background type: auto, transparent, or opaque |
output_format | string | No | File format: png, jpeg, or webp |
The response returns a data array containing the generated images:
When response_format is set to b64_json:
Supported Models
| Model | Description |
|---|
azure/openai/gpt-image-1 | OpenAI’s GPT Image 1 model via Azure |
azure/openai/gpt-image-1.5 | OpenAI’s GPT Image 1.5 model via Azure |
Image Edits API (/v1/images/edits)
The image edits endpoint applies a text prompt to one or more input images. It is OpenAI compatible, so you can use client.images.edit() directly.
The endpoint accepts both multipart/form-data (the OpenAI SDK default for file uploads) and application/json (with image references as base64 data URLs or file IDs).
JSON variant:
Parameters
| Parameter | Type | Required | Description |
|---|
model | string | Yes | The model to use for image editing |
prompt | string | Yes | A text description of the desired edit |
image[] / images | file[] or ImageReference[] | Yes | The input images. Use image[] form fields for file uploads, or images with file_id or image_url in JSON. Up to 16 images. |
mask | file or ImageReference | No | Optional mask. Transparent pixels mark the area that will be regenerated. |
n | integer | No | Number of edited images to generate (default: 1) |
size | string | No | Output size (auto, 1024x1024, 1536x1024, 1024x1536) |
quality | string | No | Image quality (auto, high, medium, low) |
input_fidelity | string | No | Fidelity to the input image (high or low) |
background | string | No | Background type (auto, transparent, opaque) |
output_format | string | No | File format (png, jpeg, webp) |
output_compression | integer | No | Compression level (0 to 100) for webp or jpeg |
response_format | string | No | Output delivery format (url or b64_json) |
Python Example
JavaScript/TypeScript Example
Masked Edits
Pass a mask image to restrict edits to a specific region. Transparent pixels in the mask mark the area that will be regenerated.
Supported Models
| Model | Description |
|---|
azure/openai/gpt-image-1 | OpenAI’s GPT Image 1 model via Azure |
azure/openai/gpt-image-1.5 | OpenAI’s GPT Image 1.5 model via Azure |
Chat Completions API (/v1/chat/completions)
Google Gemini image models generate images natively through the standard chat completions endpoint. Images are returned alongside text in the response, and you can control aspect ratio and resolution with the image_config parameter.
Parameters
All standard chat completions parameters apply. The additional image_config object controls the generated image output:
| Parameter | Type | Required | Description |
|---|
image_config | object | No | Controls the aspect ratio and resolution of generated images |
image_config.aspect_ratio | string | No | Aspect ratio of the output image. Supported values: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 |
image_config.image_size | string | No | Resolution tier. Supported values: 1K (default), 2K, 4K |
When image_config is omitted, the model defaults to a 1:1 aspect ratio at 1K resolution.
The response includes both the standard text content and an array of generated images:
Python Example
JavaScript/TypeScript Example
Supported Models
| Model | Description |
|---|
vertex/google/gemini-2.5-flash-image-preview | Gemini 2.5 Flash image generation via Vertex AI |
vertex/gemini-3.1-flash-image-preview | Gemini 3.1 Flash image generation via Vertex AI |
vertex/google/gemini-3-pro-image-preview | Gemini 3 Pro image generation via Vertex AI |
Supported Aspect Ratios & Resolutions
| Aspect Ratio | 1K | 2K | 4K |
|---|
1:1 | 1024×1024 | 2048×2048 | 4096×4096 |
2:3 | 848×1264 | 1696×2528 | 3392×5056 |
3:2 | 1264×848 | 2528×1696 | 5056×3392 |
3:4 | 896×1200 | 1792×2400 | 3584×4800 |
4:3 | 1200×896 | 2400×1792 | 4800×3584 |
4:5 | 928×1152 | 1856×2304 | 3712×4608 |
5:4 | 1152×928 | 2304×1856 | 4608×3712 |
9:16 | 768×1376 | 1536×2752 | 3072×5504 |
16:9 | 1376×768 | 2752×1536 | 5504×3072 |
21:9 | 1584×672 | 3168×1344 | 6336×2688 |
These match the aspect ratios and resolutions supported by Google’s Gemini image models.
Choosing an Endpoint
| Feature | Images Generate | Images Edit | Chat Completions API |
|---|
| Endpoint | /v1/images/generations | /v1/images/edits | /v1/chat/completions |
| OpenAI SDK support | client.images.generate() | client.images.edit() | client.chat.completions.create() |
| Accepts input images | No | Yes (up to 16) | Yes (as chat content) |
| Mask support | No | Yes | No |
| Text + image response | No | No | Yes |
| Conversational context | No | No | Yes |
| Aspect ratio control | No | No | Yes (image_config.aspect_ratio) |
| Resolution control | Via size | Via size | Yes (image_config.image_size: 1K, 2K, 4K) |
| Background control | Yes | Yes | No |
| Output format control | Yes (png, jpeg, webp) | Yes (png, jpeg, webp) | No |
Image generation models may have different pricing compared to text models. Check the model library for specific pricing information.
Limitations
- Image size and resolution depend on the specific model capabilities
- Some models may have content filtering or safety restrictions
- Response size limits apply to the combined text and image data