generate_image
Queue an AI image job via posterly using Nano Banana (Gemini) or Grok Imagine Image 2.0 (xAI). Returns job_id. Poll list_jobs with type=image for urls. Thinking high does not change the credit price. COSTS CREDITS - confirm subject + style + aspect_ratio + quality + provider with the user before calling.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Google-only: lite (8 credits, 1K only), flash (Nano Banana 2.1, 15 at 1K), or pro (30 at 1K). Ignored for xAI. | flash |
| style | No | photographic | |
| prompt | Yes | ||
| confirm | Yes | Must be true after the user explicitly confirms subject, style, aspect ratio, quality, and credit use. | |
| quality | No | Google: high turns on Gemini thinking. low/medium leave thinking minimal unless thinking_level is set. xAI: low or medium credit tiers. | |
| provider | No | google for Nano Banana or xai for Grok Imagine Image 2.0. | |
| resolution | No | xAI supports 1K/2K only. Google flash (Nano Banana 2.1) bills 15/23/35 for 1K/2K/4K. 512 is no longer available. Pro bills 30 at 1K-2K and 55 at 4K. | 1K |
| variations | No | ||
| aspect_ratio | No | 1:1 | |
| workspace_id | No | Optional. The workspace this acts in and whose plan pays (from whoami). Needed only when your connection can act in several workspaces. | |
| thinking_level | No | Google flash/lite. Gemini image quality control. minimal is fastest; high is for infographics and harder layouts. Overrides quality when both are set. | |
| reference_image_urls | No | Google only. Up to 14 HTTPS image URLs used as references (logo, product, style lock). |