การสร้างภาพ

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

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

ตั้งค่า agents.defaults.imageGenerationModel.timeoutMs สำหรับแบ็กเอนด์รูปภาพที่ช้า พารามิเตอร์เครื่องมือ timeoutMs ต่อการเรียกจะแทนที่ค่าเริ่มต้นที่กำหนดค่าไว้

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

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

ยังสามารถเลือกโมเดล 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 จะแมป ค่าเหล่านั้นเป็น size ที่รองรับ ไม่เช่นนั้นเครื่องมือจะรายงานค่าเหล่านั้นเป็น การแทนที่ที่ถูกละเว้น

ตัวเลือกเฉพาะของ 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 และ โมเดลภาพของ OpenAI ที่รองรับความโปร่งใส OpenClaw กำหนดเส้นทางคำขอ พื้นหลังโปร่งใสของ gpt-image-2 ค่าเริ่มต้นไปยัง gpt-image-1.5 openai.outputCompression ใช้กับเอาต์พุต JPEG/WebP

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

หากต้องการกำหนดเส้นทางการสร้างภาพของ OpenAI ผ่านการปรับใช้ Azure OpenAI แทน api.openai.com โปรดดู เอนด์พอยต์ Azure OpenAI

การสร้างภาพของ OpenRouter ใช้ OPENROUTER_API_KEY เดียวกัน และ กำหนดเส้นทางผ่าน API ภาพของแชตคอมพลีชันของ OpenRouter เลือก โมเดลภาพ OpenRouter ด้วยคำนำหน้า openrouter/:

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

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

การสร้างภาพ MiniMax พร้อมใช้งานผ่านเส้นทางการยืนยันตัวตน MiniMax ที่รวมมาให้ทั้งสองแบบ:

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

ผู้ให้บริการ xAI ที่รวมมาให้ใช้ /v1/images/generations สำหรับคำขอที่มีเฉพาะพรอมต์ และใช้ /v1/images/edits เมื่อมี image หรือ images

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

OpenClaw ตั้งใจไม่เปิดเผย quality, mask, user ที่เป็นของ xAI โดยเฉพาะ หรืออัตราส่วนภาพเพิ่มเติมที่มีเฉพาะแบบเนทีฟ จนกว่าตัวควบคุมเหล่านั้นจะมีอยู่ในสัญญา image_generate ข้ามผู้ให้บริการที่ใช้ร่วมกัน