OPENCLAW + GPT IMAGE

在 OpenClaw 中使用 GPT Image。

GPT Image 2 是 OpenAI 專用的圖片生成模型 — 文生圖和基於指令的圖片編輯,支援最高 4K 輸出解析度和透明背景。OpenClaw agent 透過與聊天相同的 RunAPI key 和 /v1 端點呼叫,無需安裝額外技能。

一個 API key · 文生圖 + 圖片編輯 · 最高 4K 輸出
Use RunAPI to generate an image with OpenAI GPT Image 2.

Requirements:
- Use the RunAPI API at https://runapi.ai/v1/text_to_image.
- Read the API key from RUNAPI_API_KEY environment variable.
- Set the model to "gpt-image-2-text-to-image".
- Write a descriptive prompt. GPT Image 2 follows natural language instructions closely — describe layout, style, text overlays, and transparency needs.
- Optionally set output_resolution to 1k, 2k, or 4k. Default is 1k.
- The response returns a task_id. Poll the task status endpoint until the task completes, then retrieve the output URL.
curl -X POST https://runapi.ai/v1/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2-text-to-image",
    "prompt": "A product photo of a glass perfume bottle on a marble surface, transparent background, studio lighting, the label reads AURORA in gold serif font",
    "output_resolution": "2k",
    "aspect_ratio": "3:4"
  }'
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "gpt-image-2-text-to-image"
}
複製 curl 指令進行測試 gpt-image
運作原理

三步驟在 OpenClaw 中使用 GPT Image

1

設定 RunAPI

在 shell 設定檔中設定 RUNAPI_API_KEY 環境變數。如果 RunAPI 已在 OpenClaw 中設定用於聊天,同一個 key 也適用於 GPT Image — 無需額外設定。

export RUNAPI_API_KEY=runapi_xxx
2

呼叫 GPT Image 2

向 text_to_image 端點發送 POST 請求,model 設為 gpt-image-2-text-to-image。加入帶有版面和風格指示的描述性 prompt。將 output_resolution 設為 2k 或 4k 以獲得更高細節。若要編輯現有圖片,使用 edit_image 端點搭配 gpt-image-2-image-to-image 並提供 source_image_urls。

POST /v1/text_to_image
3

取得結果

API 會立即回傳 task_id。輪詢任務狀態端點,直到狀態變為 completed,然後從回應中取得輸出圖片 URL。GPT Image 2 通常在 10–30 秒內完成,視解析度而定。

task_id: tsk_abc123
參數

GPT Image API 參數

參數 類型 說明
model string 必填。gpt-image-2-text-to-image 用於生成,gpt-image-2-image-to-image 用於編輯。
prompt string 必填。期望圖片的自然語言描述。支援版面、文字疊加和風格的詳細指示。
output_resolution string 選填。輸出解析度 — 1k(預設)、2k 或 4k。較高解析度的每張圖片費用較高。
aspect_ratio string 選填。預設為 auto。支援 1:1、3:2、2:3、4:3、3:4、16:9、9:16 等。
source_image_urls array edit_image 端點必填。一個或多個要編輯的來源圖片 URL。

OpenClaw 上的 GPT Image 是什麼?

GPT Image 2 是 OpenAI 的專屬圖像模型,運作方式更像結構化設計助理,而非關鍵字驅動的生成器。你給它一份製作簡報——版面、文字位置、風格限制——它會嚴格遵循指示。使用者回報角色一致性強、文字渲染乾淨、版面清晰可讀,但多次迭代修改後品質可能下降。OpenClaw 代理透過與聊天相同的 RunAPI 端點呼叫它。

GPT Image 使用情境

UI 模擬稿與應用程式設計線框圖

從書面描述生成詳細的 UI 模擬稿,包括按鈕版面、導覽列和能正確顯示的佔位內容。

大量文字的海報與簡報

創建精確文字的海報、資訊圖表和簡報投影片,其中文字內容在提示詞中指定,渲染為清晰可讀的版面。

角色設計圖

從單一描述生成含多角度展示的角色設計圖,在多個視角間保持一致的特徵。

FAQ

GPT Image + OpenClaw 常見問題

OpenClaw 通用設定

尚未設定?請從 OpenClaw 的 RunAPI 設定指南開始。

OpenClaw 設定指南 →

GPT Image 模型目錄

查看所有 GPT Image 變體、定價與 API 文件。

GPT Image 模型 →

立即在 OpenClaw 中試用 GPT Image。

取得免費的 RunAPI key,將 prompt 貼入 OpenClaw,即可開始使用 OpenAI GPT Image 2 生成和編輯圖片。