---
title: "Generate images from a text prompt"
method: POST
path: "/v2/generative/images"
tags: ["generative"]
---

# Generate images from a text prompt

`POST /v2/generative/images`

## Request

- Base URL: `https://api.shutterstock.com`
- URL: `https://api.shutterstock.com/v2/generative/images`
- Auth: OAuth 2
  - Authorization code: `https://accounts.shutterstock.com/oauth/authorize`
  - Token URL: `https://api.shutterstock.com/v2/oauth/access_token`
- TypeScript: <https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer/docs/v2/generative/images/post.ts> (a function with typed inputs; its response is checked against the schema)

Starts an image generation request and returns a tracking ID.

## Request body

- object
  - `prompt` string, required: The text prompt to generate images from. Must contain at least one non-whitespace character and be at most 1800 characters.
  - `aspect_ratio` '1:1' | '9:16' | '16:9' | '4:3' | '3:4': The aspect ratio of the generated images.
  - `style_id` string: The style identifier to apply to the generated images. Use an id from text_to_image.styles returned by GET /v2/generative/inputs.
  - `model` string: The image generation model identifier. Use an id from text_to_image.models returned by GET /v2/generative/inputs. If omitted, the backend selects the default model.

## Response `201`

Image generation request accepted

- object
  - `id` string, required: The UUID of the generation request.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

- **2026-10-14** `b43cab3aaaaa`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer/changes/v2/generative/images/post.md)

---

[API](https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer.md) - [All operations](https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer/llms.txt) - [OpenAPI document](https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer/revisions/b43cab3aaaaa?raw)