What does editImage do?

Edit or restyle an existing Studio image from a text prompt (inpaint / restyle). It is one of the tools The Cloud MCP server gives every connected AI.

How do I use editImage from Claude or ChatGPT?

Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "make this photo look like X", and it calls editImage.

Is editImage safe to let an AI call?

editImage changes your workspace. What an AI creates is Private until you share it. It reaches a system outside The Cloud on your behalf.

Media & Video

`editImage`

Edit Image

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

writeexternal

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "make this photo look like X", and it calls editImage.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "appId": "<appId>",
    "imageRef": "<imageRef>",
    "prompt": "<prompt>"
  },
  "name": "editImage"
}

Arguments

appIdstringrequiredThe Studio app the image belongs to
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.
imageRefstringrequiredThe image asset file id to edit
promptstringrequiredHow to edit or restyle the image
allowFallbackbooleanoptionalIf the chosen engine is unavailable, capped, or fails, produce on the next connected engine and note the substitution
aspectRatiostringoptionalAspect ratio like "1:1" or "16:9"
backgroundstringoptionalThe background colour you asked for, as a word ("cream", "white", "beige", "mustard") or a hex ("#FFFDF0"). The server samples the finished image's border, reruns ONCE by itself if the mean is far from what you asked for, and reports the…
heightnumberoptionalOutput height in px (e.g. 1024)
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.
transparentBackgroundbooleanoptionalRender on a transparent background (icons/cutouts)
variantsnumberoptionalHow many variations to produce (1-4)
widthnumberoptionalOutput width in px (pair with height, e.g. 1024)

Returns

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

Ask for it

The Cloud routes these requests to this verb.

make this photo look like X
add Y to this image

Pair it with

The verbs that finish the job.

Questions

What does editImage do?
Edit or restyle an existing Studio image from a text prompt (inpaint / restyle). It is one of the tools The Cloud MCP server gives every connected AI.
How do I use editImage from Claude or ChatGPT?
Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "make this photo look like X", and it calls editImage.
Is editImage safe to let an AI call?
editImage changes your workspace. What an AI creates is Private until you share it. It reaches a system outside The Cloud on your behalf.

Connect

One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.