Generate or edit an image with ChatGPT
generate_imageCreates or edits images through your own signed-in ChatGPT account in Chrome: pass a prompt, aspect ratio and optional reference images to receive saved files. No API key needed.
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.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | Yes | Full image description or edit instructions, in any language. | |
| 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. | |
| 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 PNG with a transparent background (stickers, logos, icons, sprites). The result says whether the saved image really has transparent pixels. |