Media & Video

`editImage`

Edit Image

Edit or restyle an existing Studio image from a text prompt (inpaint / restyle).

writeexternal

Arguments

appIdstringrequiredThe Studio app the image belongs to
imageRefstringrequiredThe image asset file id to edit
promptstringrequiredHow to edit or restyle the image
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.

Edits run in the background: returns a jobId + app link immediately: call checkImageGeneration with that jobId to get the new image URL + file id.

The Cloud routes these requests to this verb.

The verbs that finish the job.