modelApiDoc_getStartedBeforeModelgoogle/gemini-3-pro-image-preview/editmodelApiDoc_getStartedAfterModel modelApiDoc_getStartedMid modelApiDoc_schemaLinkmodelApiDoc_getStartedAfterSchema
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/google/gemini-3-pro-image-preview/edit \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "Change the scene to a modern office, soft daylight, background only.",
"image_urls": [
"https://playgrounds-storage-public.runcomfy.net/tools/7007/media-files/usecase2-2-input.png"
]
}'modelApiDoc_authP1 YOUR_API_TOKEN modelApiDoc_authP2 modelApiDoc_profilemodelApiDoc_authP3 Authorization modelApiDoc_authP4 Authorization: Bearer $YOUR_API_TOKENmodelApiDoc_authP5
modelApiDoc_submitBody
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/google/gemini-3-pro-image-preview/edit \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "Change the scene to a modern office, soft daylight, background only.",
"image_urls": [
"https://playgrounds-storage-public.runcomfy.net/tools/7007/media-files/usecase2-2-input.png"
]
}'modelApiDoc_monitorBody
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
--header "Authorization: Bearer <token>"modelApiDoc_retrieveBody
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
--header "Authorization: Bearer <token>"modelApiDoc_cancelBody
curl --request POST \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
--header "Authorization: Bearer <token>"modelApiDoc_hostedFileBody
{
"type": "object",
"title": "modelApiDoc_navInputSchema",
"required": [
"prompt",
"image_urls"
],
"properties": {
"prompt": {
"title": "提示词",
"description": "描述所需的图片编辑或输出效果。",
"type": "string",
"default": "Change the scene to a modern office, soft daylight, background only."
},
"image_urls": {
"title": "图片",
"description": "包含 1–20 个参考图片 URL 的列表。",
"type": "array",
"items": {
"type": "string",
"format": "image_uri"
},
"maxItems": 20,
"minItems": 1,
"default": [
"https://playgrounds-storage-public.runcomfy.net/tools/7007/media-files/usecase2-2-input.png"
]
},
"aspect_ratio": {
"title": "宽高比(宽:高)",
"description": "生成图片的宽高比。",
"type": "string",
"enum": [
"auto",
"21:9",
"16:9",
"3:2",
"4:3",
"5:4",
"1:1",
"4:5",
"3:4",
"2:3",
"9:16"
],
"default": "auto"
},
"resolution": {
"title": "分辨率",
"description": "生成图片的分辨率。",
"type": "string",
"enum": [
"1K",
"2K",
"4K"
],
"default": "1K"
},
"output_format": {
"title": "输出格式",
"description": "生成图片的文件格式,默认为 `png`。",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
],
"default": "png"
},
"num_images": {
"title": "图片数量",
"description": "要生成的图片数量,默认值为 1。",
"type": "integer",
"default": 1,
"minimum": 1,
"maximum": 4
},
"sync_mode": {
"title": "同步模式",
"description": "设为 `true` 时,媒体以数据 URI 返回,且不会出现在请求历史中。",
"type": "boolean",
"default": false
}
}
}{
"output": {
"type": "object",
"properties": {
"image": {
"type": "string",
"format": "uri",
"description": "modelApiDoc_outDescImage"
},
"video": {
"type": "string",
"format": "uri",
"description": "modelApiDoc_outDescVideo"
},
"images": {
"type": "array",
"description": "modelApiDoc_outDescImages",
"items": {
"type": "string",
"format": "uri"
}
},
"videos": {
"type": "array",
"description": "modelApiDoc_outDescVideos",
"items": {
"type": "string",
"format": "uri"
}
}
}
}
}RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.