Media & Video

`generateImage`

Generate Image

Generate an image from a text prompt and save it as a real asset inside a Studio app (Private by default).

writeexternal

Arguments

promptstringrequiredWhat to generate
appIdstringoptionalOptional Studio app to save into; a new app is made if absent
namestringoptionalName for the new app when appId is absent
engineIdstringoptionalOptional engine: nano-banana (Google Gemini) or higgsfield-soul (premium: needs the user's own key). Both support editing. Defaults to the user's preferred engine, else Higgsfield then Nano Banana.
widthnumberoptionalOutput width in px (pair with height, e.g. 1024)
heightnumberoptionalOutput height in px (e.g. 1024)
aspectRatiostringoptionalAspect ratio like "1:1" or "16:9"
transparentBackgroundbooleanoptionalRender on a transparent background (icons/cutouts)
variantsnumberoptionalHow many variations to produce (1-4)
allowFallbackbooleanoptionalIf the chosen engine is unavailable, capped, or fails, produce on the next connected engine and note the substitution
internalAssetbooleanoptionalADMIN ONLY. Generate a Teka internal asset on Teka's platform premium key instead of your own (HD Digi icons, waiting-room landscapes, brand marks). Refused for non-admins; ignore for normal generations.

Returns

Generation runs in the background (it can take a while and never blocks past the tool timeout): returns a jobId + app link immediately: call checkImageGeneration with that jobId to get the finished…

Ask for it

The Cloud routes these requests to this verb.

make an image of X
generate a photo of Y

Pair it with

The verbs that finish the job.