การสร้างรูปภาพ

การ override model ต่อการเรียกใช้จะลองเฉพาะ provider/model นั้นเท่านั้น และ จะไม่ดำเนินต่อไปยัง primary/fallback ที่กำหนดค่าไว้หรือ provider ที่ตรวจพบอัตโนมัติ

ค่าเริ่มต้นของ provider จะเข้าสู่รายการ candidate เฉพาะเมื่อ OpenClaw สามารถ authenticate provider นั้นได้จริง ตั้งค่า agents.defaults.mediaGenerationAutoProviderFallback: false เพื่อใช้เฉพาะ รายการ model, primary และ fallbacks ที่ระบุไว้อย่างชัดเจน

ตั้งค่า agents.defaults.imageGenerationModel.timeoutMs สำหรับ backend รูปภาพที่ช้า พารามิเตอร์เครื่องมือ timeoutMs ต่อการเรียกใช้จะ override ค่าเริ่มต้นที่กำหนดค่าไว้ และค่าเริ่มต้นที่กำหนดค่าไว้จะ override ค่าเริ่มต้นของ provider ที่ Plugin กำหนด provider รูปภาพที่โฮสต์โดย Google และ OpenRouter ใช้ค่าเริ่มต้น 180 วินาที การสร้างภาพของ Microsoft Foundry MAI, xAI และ Azure OpenAI ใช้ 600 วินาที การเรียกใช้ dynamic-tool ของ Codex ใช้ค่าเริ่มต้น bridge image_generate 120 วินาที และเคารพงบเวลา timeout เดียวกันเมื่อกำหนดค่าไว้ โดยถูกจำกัดด้วยค่าสูงสุดของ dynamic-tool bridge ของ OpenClaw ที่ 600000 ms

ใช้ action: "list" เพื่อตรวจสอบ provider ที่ลงทะเบียนอยู่ในปัจจุบัน model เริ่มต้นของแต่ละรายการ และคำใบ้ env-var สำหรับ auth

การสร้างภาพของ OpenAI มีค่าเริ่มต้นเป็น openai/gpt-image-2 หากกำหนดค่า โปรไฟล์ OAuth ของ openai ไว้ OpenClaw จะใช้โปรไฟล์ OAuth เดียวกันกับที่ใช้โดย model แชตแบบสมัครสมาชิกของ Codex และส่งคำขอรูปภาพผ่าน backend Codex Responses URL ฐาน Codex แบบ legacy เช่น https://chatgpt.com/backend-api จะถูก canonicalize เป็น https://chatgpt.com/backend-api/codex สำหรับคำขอรูปภาพ OpenClaw จะไม่ fallback แบบเงียบไปยัง OPENAI_API_KEY สำหรับคำขอนั้น - หากต้องการบังคับ routing ไปยัง OpenAI Images API โดยตรง ให้กำหนดค่า models.providers.openai อย่างชัดเจนด้วย API key, URL ฐานแบบกำหนดเอง หรือ endpoint ของ Azure

ยังสามารถเลือก model openai/gpt-image-1.5, openai/gpt-image-1 และ openai/gpt-image-1-mini ได้อย่างชัดเจน ใช้ gpt-image-1.5 สำหรับเอาต์พุต PNG/WebP ที่มีพื้นหลังโปร่งใส API ปัจจุบันของ gpt-image-2 ปฏิเสธ background: "transparent"

gpt-image-2 รองรับทั้งการสร้างภาพจากข้อความและ การแก้ไขรูปภาพอ้างอิงผ่านเครื่องมือ image_generate เดียวกัน OpenClaw ส่งต่อ prompt, count, size, quality, outputFormat และรูปภาพอ้างอิงไปยัง OpenAI OpenAI จะไม่ได้รับ aspectRatio หรือ resolution โดยตรง เมื่อเป็นไปได้ OpenClaw จะ map สิ่งเหล่านั้นเป็น size ที่รองรับ มิฉะนั้นเครื่องมือจะรายงานว่าเป็น override ที่ถูกละเว้น

ตัวเลือกเฉพาะของ OpenAI อยู่ภายใต้ออบเจ็กต์ openai:

{  "quality": "low",  "outputFormat": "jpeg",  "openai": {    "background": "opaque",    "moderation": "low",    "outputCompression": 60,    "user": "end-user-42"  }}

openai.background รับค่า transparent, opaque หรือ auto; เอาต์พุตโปร่งใสต้องใช้ outputFormat เป็น png หรือ webp และ model รูปภาพ OpenAI ที่รองรับความโปร่งใส OpenClaw route คำขอพื้นหลังโปร่งใสของ gpt-image-2 เริ่มต้นไปยัง gpt-image-1.5 openai.outputCompression ใช้กับเอาต์พุต JPEG/WebP และจะถูกละเว้น สำหรับเอาต์พุต PNG

คำใบ้ background ระดับบนสุดเป็นกลางต่อ provider และปัจจุบันจะ map ไปยังฟิลด์คำขอ background เดียวกันของ OpenAI เมื่อเลือก provider OpenAI provider ที่ไม่ได้ประกาศการรองรับพื้นหลังจะส่งคืนค่านี้ใน ignoredOverrides แทนที่จะได้รับพารามิเตอร์ที่ไม่รองรับ

หากต้องการ route การสร้างภาพของ OpenAI ผ่าน deployment ของ Azure OpenAI แทน api.openai.com โปรดดู endpoint ของ Azure OpenAI

การสร้างภาพของ Microsoft Foundry ใช้ชื่อ deployment รูปภาพ MAI ที่ deploy แล้ว ภายใต้ prefix provider microsoft-foundry/ ไม่มี model เริ่มต้นระดับ provider เพราะ MAI API คาดหวังชื่อ deployment ของคุณในฟิลด์ model:

{  agents: {    defaults: {      imageGenerationModel: {        primary: "microsoft-foundry/<deployment-name>",        timeoutMs: 600_000,      },    },  },}

provider ใช้ MAI API ของ Microsoft Foundry ไม่ใช่ OpenAI Images API:

• endpoint การสร้าง: /mai/v1/images/generations
• endpoint การแก้ไข: /mai/v1/images/edits
• Auth: AZURE_OPENAI_API_KEY / API key ของ provider หรือ Entra ID ผ่าน az login
• เอาต์พุต: รูป PNG หนึ่งรูป
• ขนาด: ค่าเริ่มต้น 1024x1024; ความกว้างและความสูงต้องอย่างน้อย 768 px แต่ละด้าน และจำนวนพิกเซลรวมต้องไม่เกิน 1,048,576
• การแก้ไข: รูปภาพอ้างอิง PNG หรือ JPEG หนึ่งรูป รองรับเฉพาะโดย deployment MAI-Image-2.5-Flash และ MAI-Image-2.5

การสร้างจาก prompt อย่างเดียวสามารถใช้ชื่อ deployment แบบกำหนดเองได้โดยมีเพียง endpoint ของ Foundry ที่กำหนดค่าไว้ การแก้ไขด้วยชื่อ deployment แบบกำหนดเองต้องใช้ metadata การ onboarding/model เพื่อให้ OpenClaw ตรวจสอบได้ว่า deployment นั้น รองรับโดย MAI-Image-2.5-Flash หรือ MAI-Image-2.5

model รูปภาพ MAI ปัจจุบันคือ MAI-Image-2.5-Flash, MAI-Image-2.5, MAI-Image-2e และ MAI-Image-2 ดู Plugin Microsoft Foundry สำหรับการตั้งค่า และพฤติกรรมของ chat-model

การสร้างภาพของ OpenRouter ใช้ OPENROUTER_API_KEY เดียวกัน และ route ผ่าน chat completions image API ของ OpenRouter เลือก model รูปภาพ OpenRouter ด้วย prefix openrouter/:

{  agents: {    defaults: {      imageGenerationModel: {        primary: "openrouter/google/gemini-3.1-flash-image-preview",      },    },  },}

OpenClaw ส่งต่อ prompt, count, รูปภาพอ้างอิง และ คำใบ้ aspectRatio / resolution ที่เข้ากันได้กับ Gemini ไปยัง OpenRouter shortcut ของ model รูปภาพ OpenRouter ที่มีในตัวปัจจุบันรวมถึง google/gemini-3.1-flash-image-preview, google/gemini-3-pro-image-preview และ openai/gpt-5.4-image-2 ใช้ action: "list" เพื่อดูว่า Plugin ที่คุณกำหนดค่าไว้เปิดเผยอะไรบ้าง

model Krea 2 บน fal ใช้ schema Krea native ของ fal แทน schema image_size ทั่วไปที่ Flux ใช้ OpenClaw ส่ง:

• aspect_ratio สำหรับคำใบ้ aspect-ratio
• creativity โดยมีค่าเริ่มต้นเป็น medium
• image_style_references เมื่อมีการระบุ image หรือ images

เลือก Krea 2 Medium สำหรับภาพประกอบเชิงสื่อสารที่เร็วกว่า และ Krea 2 Large สำหรับลุค photoreal และพื้นผิวที่ช้ากว่าและละเอียดกว่า:

{  agents: {    defaults: {      imageGenerationModel: {        primary: "fal/krea/v2/medium/text-to-image",      },    },  },}

ปัจจุบัน Krea 2 ส่งคืนหนึ่งรูปต่อคำขอ ควรใช้ aspectRatio สำหรับ Krea; OpenClaw map size ไปยัง aspect ratio ของ Krea ที่รองรับซึ่งใกล้ที่สุด และ ปฏิเสธ resolution สำหรับ Krea แทนที่จะทิ้งค่าไป ใช้ fal.creativity เมื่อคุณต้องการระดับความสร้างสรรค์ native ของ Krea:

{  "model": "fal/krea/v2/medium/text-to-image",  "prompt": "A cyber zine portrait with risograph texture",  "aspectRatio": "9:16",  "fal": {    "creativity": "high"  }}

การสร้างภาพของ MiniMax พร้อมใช้งานผ่านเส้นทาง auth ของ MiniMax ที่ bundled ทั้งสองแบบ:

• minimax/image-01 สำหรับการตั้งค่าด้วย API key
• minimax-portal/image-01 สำหรับการตั้งค่าด้วย OAuth

provider xAI ที่ bundled ใช้ /v1/images/generations สำหรับคำขอที่มีเพียง prompt และ /v1/images/edits เมื่อมี image หรือ images

• Model: xai/grok-imagine-image, xai/grok-imagine-image-quality
• จำนวน: สูงสุด 4
• ข้อมูลอ้างอิง: image หนึ่งรายการ หรือ images สูงสุดห้ารายการ
• Aspect ratio: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• ความละเอียด: 1K, 2K
• เอาต์พุต: ส่งคืนเป็นไฟล์แนบรูปภาพที่ OpenClaw จัดการ

OpenClaw ตั้งใจไม่เปิดเผย quality, mask, user หรือ aspect ratio native-only เพิ่มเติมของ xAI จนกว่าการควบคุมเหล่านั้นจะมีอยู่ ใน contract image_generate แบบข้าม provider ที่ใช้ร่วมกัน