メインコンテンツへスキップ

​
概要

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

ByteDance Seedream シリーズ

その他のモデル

Nano Banana、Gemini Flash など
各モデルで対応するパラメータが異なります。extra フィールドはモデル固有のパラメータを渡すために使用します。各モデルのドキュメントページで詳細なパラメータサポートをご確認ください。