Generate or edit an image with ChatGPT
generate_imageCreate or edit images through your logged-in ChatGPT account in Chrome, with no API key or extra cost, while keeping your active browser tab and input untouched.
Instructions
Generate or edit an image with ChatGPT through the user's own logged-in ChatGPT account in Google Chrome (no OpenAI API key, no extra cost). A new chat is started inside the user's selected ChatGPT Project, in a background tab: the user's active tab, window focus, mouse and keyboard are never touched. Waits up to wait_seconds (default 45) and returns: SUCCESS with the saved file path(s) (always kept in the images folder), a preview and the conversation link; NEEDS REFERENCE IMAGE / CHATGPT REPLIED WITHOUT AN IMAGE together with ChatGPT's own reply text; or, while ChatGPT is still working, STILL RUNNING / QUEUED with a job id: then keep calling job_status with that job_id. Use it whenever the user asks for an image, visual, illustration or concept art with ChatGPT, in any language. Write a detailed, self-contained prompt (subject, style, composition, colors, mood); give the shape in aspect_ratio rather than in the prompt. To edit an image or keep a character consistent, pass the image file(s) in reference_images: a fresh chat with reference_images is the most reliable way to edit. To use one of the user's saved reference collections (see list_collections), pass reference_collection.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prompt": "<prompt>"
},
"name": "generate_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| motion | No | Preset GIF movement: idle, walk, run, jump, wave, dance, bounce, wiggle, spin. Also enables animated when omitted or false; frame count is only a hint. | |
| prompt | Yes | Full image description or edit instructions, in any language. | |
| animated | No | Ask for a short animation (animated GIF). For best results use one subject, one clear motion, a still camera and no small text in the scene. aspect_ratio is not applied to the GIF. The result reports the frame count and duration. Pass motion for a preset movement. | |
| output_dir | No | Optional folder to also copy the image(s) into, e.g. the current project's assets folder (absolute path preferred). The central images folder always keeps a copy. | |
| send_as_is | No | Send the prompt verbatim, without the short instruction the bridge adds (useful to answer a question ChatGPT asked). | |
| aspect_ratio | No | Optional shape as W:H, e.g. 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 4:5, 5:2 (Discord banner) or 3:1 (header). Any W:H with whole numbers between 1:4 and 4:1 works (not 1.5:1: use 3:2). ChatGPT draws 1:3 to 3:1 itself; wider or taller shapes are drawn at 3:1 / 1:3 and cropped. An image more than 1% off is cropped from the centre to this ratio (to the nearest pixel), and the full image is kept too. | |
| wait_seconds | No | Return within this many seconds. The default 45 keeps each call under the 60-second tool limit some clients have. If the job has not finished by then, the result says STILL RUNNING or QUEUED: call job_status with its job_id again. | |
| auto_reattach | No | If ChatGPT answers that it can't access the image and asks for it to be uploaded, attach the chat's latest image (or reference_images) automatically and ask once more. | |
| filename_hint | No | Optional few words naming the subject (e.g. 'red fox mascot'), used for the saved file name instead of the start of the prompt. Pass it when the prompt opens with something else, such as instructions about the reference images. | |
| include_preview | No | Attach a downscaled preview of the result so you can check it. | |
| reference_files | No | Optional file names from list_collections to attach only those images of reference_collection, instead of the newest. | |
| conversation_url | No | Optional ChatGPT conversation link from an earlier result: the prompt is sent in that chat instead of a new one. Fine for quick follow-ups; for exact edits prefer reference_images in a fresh chat. | |
| reference_images | No | Optional local image files (png/jpg/webp/gif, up to 16) attached to the message, e.g. the image to edit or a character sheet. Paths saved by earlier calls work directly. | |
| reference_collection | No | Optional name of one of the user's Backdraw reference collections (see list_collections; matched loosely). Its images are attached after any reference_images, up to 16 references in total: over the limit the newest are used, unless reference_files picks others. | |
| transparent_background | No | Ask for a transparent background (stickers, logos, icons, sprites). A PNG is checked for transparent pixels; a GIF's first frame too (GIF requests do not ask ChatGPT for transparency). |