Skip to content

GPT 画像生成

天枢の GPT 画像モデル(gpt-image シリーズ)は、テキストからの画像生成画像編集に使用し、生图专用(画像生成専用)グループに属します。

準備

  1. コンソール生图专用 グループのトークンを一つ作成します。
  2. モデル広場生图专用 グループで、利用可能な画像モデル名を確認します(以下では gpt-image-2 を例とします)。

直結回線を使う

画像生成は長時間リクエストにあたるため、インターフェースアドレスには直結回線 https://api.tian-shu.org を使い、ゲートウェイのタイムアウトを回避してください。

方法 1:API 呼び出し(推奨)

画像生成には Images API を使います。テキストからの画像生成と画像編集の 2 つのインターフェースに分かれています。

テキストからの画像生成 /v1/images/generations

bash
curl 'https://api.tian-shu.org/v1/images/generations' \
  -H 'Authorization: Bearer your-image-group-token' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-image-2",
    "prompt": "an orange cat wearing an orange scarf hugging an otter, warm illustration style",
    "size": "1024x1024",
    "quality": "high",
    "output_format": "png",
    "response_format": "url",
    "n": 1
  }'

画像編集 / 画像から画像 /v1/images/edits

multipart/form-data で画像をアップロードし、prompt にどう変更するかを明確に書きます:

bash
curl 'https://api.tian-shu.org/v1/images/edits' \
  -H 'Authorization: Bearer your-image-group-token' \
  -F 'model=gpt-image-2' \
  -F 'prompt=Keep the subject, add a red stamp in the top-right corner reading DEMO' \
  -F 'image=@/path/to/your-image.jpg' \
  -F 'size=1024x1024' \
  -F 'quality=high' \
  -F 'output_format=png' \
  -F 'response_format=url'

よく使うパラメータ

パラメータ説明
model画像モデル名を固定で入力します。例:gpt-image-2
prompt画像の説明。主体、シーン、スタイル、比率、文字内容を明確に書きます。
n1 のみ対応。一度に 1 枚の画像を返します。
sizeauto と一般的なサイズに対応。例:1024x10241536x10241024x1536
qualitylow / medium / high / auto。下書きには low、本番には high
response_formaturl または b64_json。デフォルトは url を推奨。
output_formatpng または jpeg を推奨。webp は推奨しません。
stream非対応。有効化しないでください。

方法 2:Cherry Studio で画像生成

  1. 生图专用 グループのトークンを作成してコピーします。
  2. Cherry Studio → 設定 → モデルサービス → OpenAI タイプのプロバイダーを一つ追加します:
    • API アドレス:https://api.tian-shu.org
    • API キー:あなたの画像生成グループのトークン
  3. 「管理」で画像モデル(gpt-image-2 など)を追加します。
  4. 必ず「ストリーミング出力」を無効化してください(画像インターフェースはストリーミングを使いません)。さもないと画像生成に失敗することがあります。
  5. 画像モデルを選択すれば、画像生成を始められます。

呼び出し方法についての注意

gpt-image での画像生成には Images API(/v1/images/generations/v1/images/edits)を使ってください。Chat Completions / Responses インターフェースは画像生成の入口にはなりません。