Generate Image
generation_image_createQueue an AI image generation into the BlitzReels media library. Spends AI credits and returns a job to poll with generation_jobs_get.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prompt": "<prompt>"
},
"name": "generation_image_create"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | Exact output size as WIDTHxHEIGHT, for example 1920x2304. Only models whose parameters.size.supported is true in generation_options_list; it replaces aspectRatio, and credits scale with pixel count. | |
| model | No | Image model. Call generation_options_list for costs. | fal-ai/nano-banana-2 |
| prompt | Yes | What the image should show (8-5000 characters). | |
| folderId | No | Optional media library folder ID. | |
| background | No | Background of the generated image: auto (the model decides), opaque or transparent (an RGBA PNG for cut-outs and overlays). Only models whose parameters.background.supported is true in generation_options_list accept opaque or transparent. | auto |
| resolution | No | Native image resolution. Call generation_options_list for model support and resolution pricing. Unsupported settings are rejected. | |
| aspectRatio | No | Output aspect ratio. | 1:1 |
| characterId | No | Workspace character to keep consistent (characters_list). Its reference images or trained weights and description are added; they count toward the model reference limit. | |
| workspaceId | No | Optional workspace ID. Defaults to the user's default workspace. UUID string. | |
| enhancePrompt | No | Enhance using BlitzReels model grammar and actual input context. | |
| idempotencyKey | No | Retry key. Reuse only with identical inputs. | |
| referenceAssetIds | No | Ordered image references. Model-specific limits are listed in generation_options_list; unsupported references fail. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| generation | Yes |