跳转到主要内容

​
概述

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 字段用于传递模型特有的参数。请查看各模型的文档页面了解详细的参数支持。