概覽/OpenAPI/AI 生圖

AI 生圖

選擇模型、比例和質量生成圖片。

AI 生圖

AI 生圖使用 type: image。先從 GET /capabilities 的 image.models 中選擇一個完整模型組合。

Nano Banana 2

{  "type": "image",  "prompt": "一张简洁的二分查找课程封面,深色科技风格",  "input_file_ids": [],  "image": {    "provider": "gemini",    "model": "nano-banana-2",    "aspect_ratio": "16:9",    "output_quality": "2K",    "style_id": "style_from_capabilities"  }}

GPT Image 2

{  "type": "image",  "prompt": "一张面向开发者的二分查找课程海报,构图清晰",  "image": {    "provider": "azure_openai",    "model": "gpt-image-2",    "aspect_ratio": "3:2",    "output_quality": "2K",    "quality": "medium"  }}

參數說明

  • provider 與 model 必須成組選擇,不能交叉組合。
  • aspect_ratio 和 output_quality 必須屬於該模型組合。
  • quality 是 GPT Image 的原生質量檔位,僅用於 azure_openai + gpt-image-2。
  • style_id 從 capabilities 返回的風格中選擇。
  • 三類產品都支持 input_file_ids;參考圖片或文檔先上傳。
  • AI 生圖當前不聲明 URL Context,不要聲稱已經讀取 prompt 中的網頁。

使用建議

提示詞寫清楚主體、用途、構圖、受眾和視覺方向。若圖片需要準確文字、數據、商標或合規標籤,交付前仍應人工核對。創建後查詢同一個 creation,ready 後再讀取 outputs。