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

画像

OpenAI Images 形式のテキスト→画像生成および画像編集エンドポイントです。利用可能なモデル（DALL·E 3、GPT-Image、Seedream など）はチャネルによって異なります — 以下のフィールドは共通のものです。

画像の生成​

POST /v1/images/generations
RequestREQUEST
POSThttps://test.kailin.com.cn/v1/images/generations
The returned `url` is temporary — re-host promptly. b64_json mode returns large payloads and may render slowly.
ResponseRESPONSE
Fill in the request and hit Send — the response shows up here

リクエスト​

curl https://test.kailin.com.cn/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-token" \
  -d '{
    "model": "dall-e-3",
    "prompt": "A cyberpunk city at night, neon lights, reflections after rain",
    "n": 1,
    "size": "1024x1792"
  }'

リクエストボディ​

パラメーター型必須説明
modelstringいいえデフォルトは dall-e-2。dall-e-3、gpt-image-1 なども指定可
promptstringはい画像の説明 — DALL·E 3 では最大 4000 文字
nintegerいいえ生成枚数 1–10（DALL·E 3 は 1 のみ対応）
sizestringいいえ解像度：1024x1024 / 1792x1024 / 1024x1792（DALL·E 3）；256/512/1024x1024（DALL·E 2）；auto/1024x1536/1536x1024（GPT-Image）
qualitystringいいえstandard / hd（DALL·E 3）；low/medium/high/auto（GPT-Image）
response_formatstringいいえurl（デフォルト）または b64_json（GPT-Image は常に b64 を返す）
stylestringいいえDALL·E 3 のみ：vivid / natural
seedintegerいいえランダムシード

レスポンス​

{
  "created": 1730000000,
  "data": [
    {
      "url": "https://oss.example.com/img/abc.png",
      "revised_prompt": "A cyberpunk city at night…"
    }
  ]
}

response_format: "b64_json" を指定した場合、data[].b64_json に Base64 の画像データが入ります。url の結果は上流の一時的な場所を指します — すぐにダウンロードして再ホストしてください。

画像の編集​

POST /v1/images/edits

元画像を multipart/form-data でアップロードし、プロンプトで修正します（GPT-Image / DALL·E 2 が対応）：

curl https://test.kailin.com.cn/v1/images/edits \
  -H "Authorization: Bearer sk-your-token" \
  -F "model=gpt-image-1" \
  -F "prompt=Replace the background with a seaside at dusk" \
  -F "image=@/path/to/input.png"
フィールド型必須説明
imagefileはい元画像（png/jpeg/webp。GPT-Image は複数の image[] を受け付けます）
promptstringはい編集指示
maskfileいいえ透明部分が編集可能になるマスク（DALL·E 2）
modelstringいいえgpt-image-1 / dall-e-2
n / size / quality-いいえ生成エンドポイントと同じ

レガシーエンドポイント​

POST /v1/images/variations（画像バリエーション、DALL·E 2）と POST /v1/edits（レガシーパス）もプロキシされています — パラメーターは上記と同じです。古いコードベースでのみ使用してください。

ヒント

Nano Banana（Gemini 画像）などのモデルも OpenAI 形式で利用できます — model に対応する名前を設定するだけで、認識されないパラメーターはそのまま上流に渡されます。