OpenAI · 圖像

OpenClaw x GPT Image

GPT Image 是 OpenAI 的圖片生成模型,支援文字生成圖片與圖片編輯。透過 RunAPI,所有 GPT Image 端點共用一組金鑰,並按次計費。

1 variants 起價 $0.12 / 次呼叫 可商用

Prerequisite: npx runapi mcp install

Prompt

Prompt 模型

任務合適時使用 gpt-image-1.5:圖片生成與編輯,具備出色的構圖控制。

You have access to RunAPI task tools for GPT Image.

Available GPT Image models:
- gpt-image-1.5: 圖片生成與編輯,具備出色的構圖控制
  endpoints: /api/v1/gpt_image/edit_image, /api/v1/gpt_image/text_to_image
  request fields: model, prompt, aspect_ratio, quality

Use the model ID and endpoint that match the user's request.
Example prompt: 生成一張扁平化設計插畫:一個團隊圍著白板協作,色彩鮮明,線條俐落。
/api/v1/gpt_image/edit_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/gpt_image/edit_image,並儲存回傳的 Task ID。
GET /api/v1/gpt_image/edit_image/<task-id>,直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。
/api/v1/gpt_image/text_to_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/gpt_image/text_to_image,並儲存回傳的 Task ID。
GET /api/v1/gpt_image/text_to_image/<task-id>,直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。

公開版本與端點

模型 ID 端點 起始價格 模型目錄
gpt-image-1.5
/api/v1/gpt_image/edit_image /api/v1/gpt_image/text_to_image
$0.12 / 次呼叫 模型詳情

驗證

輪詢,直到 Task 進入終態

POST /api/v1/gpt_image/text_to_image,並儲存回傳的 Task ID。
GET /api/v1/gpt_image/text_to_image/<task-id>,直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。

設定

指南端點: /api/v1/gpt_image/text_to_image

export RUNAPI_API_KEY=your_api_key

curl -X POST https://runapi.ai/api/v1/gpt_image/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-1.5",
  "prompt": "A cobalt vase on white marble.",
  "aspect_ratio": "1:1",
  "quality": "high"
}'
使用流程

三步開始使用

  1. 選擇模型 ID

    選擇公開模型 ID,並查看其端點與目前起始價格。

  2. 設定 RunAPI

    呼叫端點前設定 RUNAPI_API_KEY。

  3. 驗證結果

    對非同步端點輪詢同一路徑,直到 Task 進入終態。

使用 OpenClaw + GPT Image 可以打造什麼

  • 行銷與商品圖片

    根據文字需求產生行銷活動圖片、商品圖和社群媒體素材。

  • 批次素材變體

    一次執行產生同一創意的多個版本,比較風格、版面和尺寸。

  • 編輯與局部重繪

    當模型提供編輯端點時,描述對背景、物件或細節的修改即可調整現有圖片。

為什麼透過 RunAPI + OpenClaw 使用 GPT Image

  • 1 個變體,一個 API 金鑰

    透過一個 RunAPI 連線選擇可用的模型變體,無需變更現有整合。

  • 清楚的用量價格

    送出請求前查看目錄中的目前價格,無需訂閱或最低消費。

  • 自動化工作流程

    透過一致的工作流程提交工作、查詢狀態並收集非同步結果,無需撰寫手動輪詢程式碼。

OpenClaw + GPT Image 常見問題

GPT Image 支援哪些端點?

文生圖和圖片編輯。兩者皆接受包含構圖指令的詳細文字提示。

構圖控制如何運作?

GPT Image 會遵循提示詞中的空間配置指示——你可以指定物件出現的位置、相對大小,以及在畫面中的排列方式。

有哪些輸出尺寸可選?

3 種固定尺寸,最大 1536 像素。

GPT Image 和 GPT Image 2 相比如何?

GPT Image 2 是較新的模型,多語言文字呈現近乎完美,並支援最高 4K 輸出。GPT Image 是上一代模型,具備出色的構圖控制能力。

可以用 GPT Image 進行編輯嗎?

可以——圖片編輯端點接受一張來源圖片,並依你的文字提示詞進行修改,可作為圖片編輯工具使用。

應該使用哪個模型 ID?

從版本表選擇公開模型 ID。每個 ID 可用的端點都列在對應資料列。

本指南會設定聊天模型嗎?

不會。此 Model Line 使用頁面所示的端點流程,不會被描述為 Agent 聊天模型。

開始在 OpenClaw 中使用 GPT Image

正在與團隊一起打造?

我們可以協助企業接入、整合與技術問題。

聯絡我們