generate_image
Generate an image from a model and prompt, returning the local file path and HTTP URL. Blocks until the image is ready.
Instructions
Generate one image synchronously and return the finished asset with both its local filesystem path and its HTTP URL. Blocks until the image exists. Batch generation is not supported.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| n | No | Fixed at 1; batch generation is not supported. | |
| seed | No | ||
| size | No | Explicit pixel dimensions, e.g. '1920x1080'. Authoritative: a conflicting resolution or aspect_ratio is rejected. | |
| model | Yes | Model ID from list_models. | |
| prompt | Yes | Passed to the provider verbatim. | |
| project | No | Project slug. Defaults to 'unsorted', which always exists. | unsorted |
| quality | No | ||
| resolution | No | ||
| aspect_ratio | No | ||
| output_format | No | ||
| input_reference_asset_ids | No | Asset IDs previously returned by upload_asset, get_media or a generation tool, used as image references. |