APIリファレンス

画像生成と編集

OpenAI互換の画像APIで画像を生成または編集します。

画像APIは生成と編集をサポートしています。正確なサイズ、品質値、フォーマット、ストリーミングのサポートはモデルとアップストリームチャネルによって異なります。

エンドポイント

メソッドパス説明
POST/v1/images/generations画像を生成します
POST/v1/images/edits画像を編集します。JSONまたはマルチパートフォーム入力に対応
POST/v1/edits互換パス。/v1/images/edits の使用を推奨

リクエストフィールド

フィールド必須説明
modelstring必須画像モデルID
promptstring生成時は必須画像プロンプト
ninteger任意画像の枚数、デフォルトは1
sizestring任意1024x1024 のような画像サイズ。乗算記号 × は使用しないでください
qualitystring任意standardhd または auto などの品質
response_formatstring任意url または b64_json などのレスポンス形式、モデルにより異なります
styleany任意OpenAI画像拡張フィールド
background, moderationany任意新しい画像モデルの拡張フィールド
output_format, output_compressionany任意出力形式と圧縮オプション
partial_images, streamany任意ストリーミングに対応した画像モデルで使用
image, imagesfile/string/array編集時は必須編集対象の画像。マルチパートでは imageimage[] または image[n] を受け付けます
maskfile/string任意編集マスク
input_fidelityany任意入力忠実度、モデルにより異なります
watermarkboolean任意透かしのオン/オフ、チャネルのサポート状況により異なります

画像を生成する

curl https://api.tensoraxis.ai/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TENSORAXIS_API_KEY" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "A minimalist poster of a futuristic city",
    "size": "1024x1024"
  }'

画像を編集する

ローカルファイルをアップロードする場合はマルチパートフォームデータを使用します:

curl https://api.tensoraxis.ai/v1/images/edits \
  -H "Authorization: Bearer $TENSORAXIS_API_KEY" \
  -F model="gpt-image-1" \
  -F prompt="Change the background to a night city" \
  -F image="@input.png"

選択したモデルが対応している場合、JSON形式の画像URLも使用できます:

{
  "model": "gpt-image-1",
  "prompt": "Change the background to a night city",
  "image": "https://example.com/input.png"
}

レスポンス形式

{
  "created": 1710000000,
  "data": [
    {
      "url": "https://example.com/result.png",
      "b64_json": "",
      "revised_prompt": "..."
    }
  ]
}

動画生成は画像APIではありません。Seedance / Doubao の動画モデルについては、動画生成 の非同期タスクボディを使用してください。