이미지 생성

호출별 model 재정의는 해당 공급자/모델만 시도하며 구성된 primary/fallback 또는 자동 감지된 공급자로 계속 진행하지 않습니다.

OpenClaw가 실제로 해당 공급자를 인증할 수 있을 때만 공급자 기본값이 후보 목록에 들어갑니다. 명시적 model, primary, fallbacks 항목만 사용하려면 agents.defaults.mediaGenerationAutoProviderFallback: false를 설정하세요.

느린 이미지 백엔드에는 agents.defaults.imageGenerationModel.timeoutMs를 설정하세요. 호출별 timeoutMs 도구 매개변수는 구성된 기본값보다 우선합니다.

현재 등록된 공급자, 해당 기본 모델, 인증 env-var 힌트를 검사하려면 action: "list"를 사용하세요.

OpenAI 이미지 생성은 기본적으로 openai/gpt-image-2를 사용합니다. openai-codex OAuth 프로필이 구성되어 있으면 OpenClaw는 Codex 구독 채팅 모델에서 사용하는 동일한 OAuth 프로필을 재사용하고 Codex Responses 백엔드를 통해 이미지 요청을 보냅니다. https://chatgpt.com/backend-api 같은 레거시 Codex 기본 URL은 이미지 요청에 대해 https://chatgpt.com/backend-api/codex로 정규화됩니다. OpenClaw는 해당 요청에서 자동으로 OPENAI_API_KEY로 대체하지 않습니다. 직접 OpenAI Images API 라우팅을 강제하려면 API 키, 사용자 지정 기본 URL 또는 Azure 엔드포인트로 models.providers.openai를 명시적으로 구성하세요.

openai/gpt-image-1.5, openai/gpt-image-1, openai/gpt-image-1-mini 모델은 여전히 명시적으로 선택할 수 있습니다. 투명 배경 PNG/WebP 출력에는 gpt-image-1.5를 사용하세요. 현재 gpt-image-2 API는 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 힌트는 공급자 중립적이며, 현재 OpenAI 공급자가 선택되면 동일한 OpenAI background 요청 필드로 매핑됩니다. 배경 지원을 선언하지 않는 공급자는 지원되지 않는 매개변수를 받는 대신 이를 ignoredOverrides로 반환합니다.

OpenAI 이미지 생성을 api.openai.com 대신 Azure OpenAI 배포를 통해 라우팅하려면 Azure OpenAI 엔드포인트를 참조하세요.

OpenRouter 이미지 생성은 동일한 OPENROUTER_API_KEY를 사용하며 OpenRouter의 채팅 완성 이미지 API를 통해 라우팅됩니다. openrouter/ 접두사로 OpenRouter 이미지 모델을 선택하세요.

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

OpenClaw는 prompt, count, 참조 이미지, Gemini 호환 aspectRatio / resolution 힌트를 OpenRouter로 전달합니다. 현재 내장 OpenRouter 이미지 모델 바로 가기에는 google/gemini-3.1-flash-image-preview, google/gemini-3-pro-image-preview, openai/gpt-5.4-image-2가 포함됩니다. 구성된 Plugin이 무엇을 노출하는지 보려면 action: "list"를 사용하세요.

MiniMax 이미지 생성은 번들된 두 MiniMax 인증 경로를 통해 사용할 수 있습니다.

• API 키 설정용 minimax/image-01
• OAuth 설정용 minimax-portal/image-01

번들된 xAI 공급자는 프롬프트 전용 요청에 /v1/images/generations를 사용하고, image 또는 images가 있을 때 /v1/images/edits를 사용합니다.

• 모델: 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는 공유 교차 공급자 image_generate 계약에 해당 컨트롤이 존재하기 전까지 xAI 네이티브 quality, mask, user 또는 추가 네이티브 전용 종횡비를 의도적으로 노출하지 않습니다.