Tạo hình ảnh

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Bắt đầu nhanh

{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "openai/gpt-image-2",
        timeoutMs: 180_000,
      },
    },
  },
}

​

Tuyến phổ biến

​

Nhà cung cấp được hỗ trợ

/tool image_generate action=list

​

Khả năng của nhà cung cấp

​

Tham số công cụ

​

Cấu hình

​

Chọn mô hình

{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "openai/gpt-image-2",
        timeoutMs: 180_000,
        fallbacks: [
          "openrouter/google/gemini-3.1-flash-image-preview",
          "google/gemini-3.1-flash-image-preview",
          "fal/fal-ai/flux/dev",
        ],
      },
    },
  },
}

​

Thứ tự chọn nhà cung cấp

1. Tham số model từ lệnh gọi công cụ (nếu tác tử chỉ định).
2. imageGenerationModel.primary từ cấu hình.
3. imageGenerationModel.fallbacks theo thứ tự.
4. Tự động phát hiện — chỉ các mặc định nhà cung cấp có xác thực:
   • nhà cung cấp mặc định hiện tại trước;
   • các nhà cung cấp tạo hình ảnh đã đăng ký còn lại theo thứ tự provider-id.

​

Chỉnh sửa hình ảnh

"Generate a watercolor version of this photo" + image: "/path/to/photo.jpg"

​

Tìm hiểu sâu về nhà cung cấp

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

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

​

Ví dụ

/tool image_generate action=generate model=openai/gpt-image-2 prompt="A clean editorial poster for OpenClaw image generation" size=3840x2160 count=1

/tool image_generate action=generate model=openai/gpt-image-1.5 prompt="A simple red circle sticker on a transparent background" outputFormat=png background=transparent

openclaw infer image generate \
  --model openai/gpt-image-1.5 \
  --output-format png \
  --background transparent \
  --prompt "A simple red circle sticker on a transparent background" \
  --json

/tool image_generate action=generate model=openai/gpt-image-2 prompt="Two visual directions for a calm productivity app icon" size=1024x1024 count=2

/tool image_generate action=generate model=openai/gpt-image-2 prompt="Keep the subject, replace the background with a bright studio setup" image=/path/to/reference.png size=1024x1536

/tool image_generate action=generate model=openai/gpt-image-2 prompt="Combine the character identity from the first image with the color palette from the second" images='["/path/to/character.png","/path/to/palette.jpg"]' size=1536x1024

​

Liên quan

• Tổng quan công cụ — tất cả công cụ agent có sẵn
• ComfyUI — thiết lập quy trình làm việc ComfyUI cục bộ và Comfy Cloud
• fal — thiết lập nhà cung cấp ảnh và video fal
• Google (Gemini) — thiết lập nhà cung cấp ảnh Gemini
• MiniMax — thiết lập nhà cung cấp ảnh MiniMax
• OpenAI — thiết lập nhà cung cấp OpenAI Images
• Vydra — thiết lập ảnh, video và giọng nói Vydra
• xAI — thiết lập ảnh Grok, video, tìm kiếm, thực thi mã và TTS
• Tham chiếu cấu hình — cấu hình imageGenerationModel
• Mô hình — cấu hình mô hình và chuyển đổi dự phòng