跳轉到主要內容

​
概述

WaveAPI 支援多種圖像生成模型，統一透過非同步任務介面 /v1/tasks 呼叫。
簡單的同步圖像生成也可以使用 /v1/tasks（OpenAI 相容格式），但建議使用 /v1/tasks 以獲得更多模型和參數支援。

​
請求端點

POST https://qingbo.dev/v1/tasks

​
通用請求參數

參數類型必填說明
modelstring是模型名稱
actionstring否操作類型，預設 "generate"，可選 "edit", "upscale", "variation"
promptstring是圖像描述文字
negative_promptstring否不希望出現的內容
ninteger否生成數量，預設 1
sizestring否圖像尺寸，如 "1024x1024"
aspect_ratiostring否寬高比，如 "16:9"
qualitystring否品質，如 "standard", "hd"
image_urlstring否參考圖片 URL（圖生圖）
image_urlsarray否多張參考圖片 URL
callback_urlstring否完成後的回呼位址
extraobject否模型特定的透傳參數

​
回應格式

任務提交後回傳 task_id，透過 GET /v1/tasks/{task_id} 查詢結果： 
{
  "task_id": "task_xxx",
  "status": "completed",
  "result": {
    "images": [
      {
        "url": "https://...",
        "expires_at": 1720000000
      }
    ]
  }
}

​
支援的模型

GPT-4o Image

OpenAI 圖像生成模型

FLUX Kontext

FLUX 系列圖像生成

Seedream

位元組跳動 Seedream 系列

更多模型

Nano Banana、Gemini Flash 等
每個模型支援的參數不同，extra 欄位用於傳遞模型特有的參數。請查看各模型的文件頁面了解詳細的參數支援。