Images

Generate or edit an image

Text-to-image, or edit / combine your reference images, with the model you pick (Nano Banana 2.1 by default, Pro for the strongest, Lite for the cheapest). Any aspect ratio, 512px–4K (512px runs on Nano Banana 2). The image is hosted for you.

Billing: By the image tokens the model reports (≈ list price per image) · Rate limit: 30/min

post/v1/ai/image

Request

  • Base URL: https://apihub.co.il
  • URL: https://apihub.co.il/v1/ai/image
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Replay-safe: the same execution is returned instead of charging twice

X-Tagstring

Group calls into one job (e.g. one video) — see GET /v1/usage?tag=…

Request body

model'auto' | 'gemini-3.1-flash-image' | 'gemini-nano-banana-2.1' | 'gemini-3.1-flash-lite-image' | 'gemini-3-pro-image'

A model id (GET /v1/ai/models) or "auto" — then quality decides: fast=gemini-3.1-flash-lite-image, balanced=gemini-nano-banana-2.1, best=gemini-3-pro-image

ultraboolean

ULTRA: true = the image is made with Nano Banana Pro (gemini-3-pro-image) at 2K or larger, whatever model, quality and resolution are sent, at 3× the credits of the same request without ULTRA (the estimate's ultra block shows both prices — POST …/estimate before you run it). Only for accounts that have bought credits at least once (402 ultra_paid_only, with the account's top-up page in details.top_up) and where ULTRA is switched on (else 403 ultra_unavailable). Nothing is charged when it is refused.

promptstring required
quality'fast' | 'balanced' | 'best'

Which model auto picks: fast (cheapest) · balanced (default) · best (strongest, costs more)

resolution'512px' | '1K' | '2K' | '4K'
aspect_ratio'1:1' | '4:5' | '3:4' | '2:3' | '9:16' | '16:9' | '4:3' | '3:2' | '21:9'
reference_imagesstring[]

Images to edit or to take style/characters from

Response

Completed

idstring

Execution id — stable across internal retries; use it with GET /v1/executions/{id}

status'pending' | 'processing' | 'completed' | 'partial' | 'failed' | 'cancelled' | 'timeout'
operationstring
tagstring nullable

Your X-Tag, if sent

created_atstring date-time
completed_atstring date-time nullable
outputobject

Operation result (see each operation). While a Studio render is processing: stage (queued · transcribing · downloading · preparing · cleaning_voice · mixing_audio · rendering · finishing), phase (the engine's: download · prepare · voice · audio · encode · qa · upload, or null), progress (a percent, 0–100) and progress_fraction (0–1), eta_seconds (seconds left, never below 0) and estimate_seconds

errorstring nullable

Changes

No recorded changes to this operation across all 2 revisions of this API.