---
title: "Generate an image"
method: POST
path: "/generate-image"
tags: ["Platform"]
---

# Generate an image

`POST /generate-image`

## Request

- Base URL: `https://blitzreels.com/api/v1`
- URL: `https://blitzreels.com/api/v1/generate-image`
- Auth: API key in header `Authorization`

Generate an image.

## Request body

- object
  - `prompt` string, required
  - `model` 'fal-ai/gpt-image-1' | 'fal-ai/gpt-image-1.5' | 'fal-ai/gpt-image-2' | 'fal-ai/gpt-image-2.5-flare' | 'fal-ai/gpt-image-2.5-sunburst' | 'xai/grok-imagine-image-2.0' | 'bfl/flux-3-image' | 'fal-ai/bytedance/seedream/v5/lite/text-to-image' | 'bytedance/seedream/v5/pro/text-to-image' | 'fal-ai/krea-2/turbo' | 'fal-ai/krea/v2/medium/turbo/text-to-image' | 'fal-ai/krea/v2/medium/text-to-image' | 'fal-ai/nano-banana-2' | 'google/nano-banana-2.1' | 'google/nano-banana-2-lite' | 'fal-ai/nano-banana-pro'
  - `aspect_ratio` '1:1' | '16:9' | '9:16' | '4:3' | '3:4' | '3:2' | '2:3' | '5:4' | '4:5' | '21:9'
  - `resolution` '0.5k' | '1k' | '2k' | '4k', nullable: Native image resolution. See generation options for model support and pricing; unsupported settings are rejected.
  - `reference_asset_ids` string[]
  - `folder_id` string, uuid, nullable
  - `enhance_prompt` boolean

## Response `200`

Successful response

- object
  - `job_id` string, uuid, required
  - `kind` 'image' | 'video' | 'voiceover' | 'music' | 'sound' | 'faceless', required
  - `status` 'queued', required
  - `status_url` string, uri, required
  - `cancel_url` string, uri, required
  - `project_id` string, uuid, nullable, required
  - `media_id` string, uuid, nullable, required
  - `estimated_credits` number, nullable, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `500`: Internal server error

---

[API](https://skmtc.dev/blitzreels/apis/blitzreels-api.md) · [All operations](https://skmtc.dev/blitzreels/apis/blitzreels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blitzreels/apis/blitzreels-api/revisions/35608b12471d?raw)