ドキュメント APIリファレンス SDKリファレンスエージェント利用 AIスキル

画像

画像を生成

テキストプロンプトから画像を生成します。デフォルトで OpenAI 互換の同期 JSON を返します(client.images.generate() でそのまま使用可能)。stream: true を渡すと SSE イベントストリームを返します。inputImages / input_references による image-to-image にも対応。

POST/api/v1/images/generations

認証

Authorization必須

string · header

Authorization ヘッダーに Bearer トークンとして API キーを渡します。

Body

model必須

string

使用する画像生成モデル。プロバイダー修飾形式、例:"openai/gpt-image-2"。

minLength: 1

Example: "openai/gpt-image-2"

prompt必須

string

生成したい画像のテキスト記述。

minLength: 1

Example: "a red cat on a sofa"

n

integer

生成する画像の枚数、1–10。

1–10

Example: 1

size

string

画像サイズ——明示的なピクセル("2048x2048")またはティア("2K"、"4K")。プロバイダーにそのまま転送されます。対応サイズはモデルによって異なります。

Example: "1024x1024"

stream

boolean

レスポンス形式を選択:省略または false = OpenAI 互換の同期 JSON(デフォルト)、true = SSE イベントストリーム。

input_references

string[]

画像から画像(i2i)のソース画像(data: または https: URL)、最大 8 枚。inputImages のエイリアス(業界慣用のフィールド名との互換)。どちらも先にコンテンツモデレーションを通過します。モデルのルートが i2i 非対応の場合は warnings ではなく 400 を返します。

≤ 8 images

aspect_ratio

enum<string>

生成画像のアスペクト比。一部のモデルルートでネイティブに対応——各モデルの実際の対応パラメータは GET /api/v1/images/models レスポンスの supported_parameters で確認してください。非対応のルートではこのフィールドは無視され、レスポンスの warnings[] に記録されます(リクエスト自体は成功します)。

1:11:21:41:82:12:33:23:44:14:34:55:48:19:1616:99:19.519.5:99:2020:99:2121:9auto

Example: "16:9"

resolution

enum<string>

解像度ティア。実際のピクセル数はプロバイダーごとに換算されます。一部のモデルルートでネイティブに対応——各モデルの実際の対応パラメータは GET /api/v1/images/models レスポンスの supported_parameters で確認してください。非対応のルートではこのフィールドは無視され、レスポンスの warnings[] に記録されます(リクエスト自体は成功します)。

5121K2K4K

Example: "2K"

quality

enum<string>

レンダリング品質。一部のモデルルートでネイティブに対応——各モデルの実際の対応パラメータは GET /api/v1/images/models レスポンスの supported_parameters で確認してください。非対応のルートではこのフィールドは無視され、レスポンスの warnings[] に記録されます(リクエスト自体は成功します)。

autolowmediumhigh

background

enum<string>

背景処理。transparent はアルファ対応の output_format(png/webp)が必要です。一部のモデルルートでネイティブに対応——各モデルの実際の対応パラメータは GET /api/v1/images/models レスポンスの supported_parameters で確認してください。非対応のルートではこのフィールドは無視され、レスポンスの warnings[] に記録されます(リクエスト自体は成功します)。

autotransparentopaque

output_format

enum<string>

返される画像バイトのエンコーディング。一部のモデルルートでネイティブに対応——各モデルの実際の対応パラメータは GET /api/v1/images/models レスポンスの supported_parameters で確認してください。非対応のルートではこのフィールドは無視され、レスポンスの warnings[] に記録されます(リクエスト自体は成功します)。

pngjpegwebpsvg

Example: "png"

output_compression

integer

webp/jpeg 出力の圧縮レベル(0–100)。png では無視されます。一部のモデルルートでネイティブに対応——各モデルの実際の対応パラメータは GET /api/v1/images/models レスポンスの supported_parameters で確認してください。非対応のルートではこのフィールドは無視され、レスポンスの warnings[] に記録されます(リクエスト自体は成功します)。

0–100

Example: 100

seed

integer

決定論的サンプリングシード。同じシード+パラメータで同じ結果になるはずですが、すべてのプロバイダーが保証するわけではありません。一部のモデルルートでネイティブに対応——各モデルの実際の対応パラメータは GET /api/v1/images/models レスポンスの supported_parameters で確認してください。非対応のルートではこのフィールドは無視され、レスポンスの warnings[] に記録されます(リクエスト自体は成功します)。

詳細ガイド →

POST /api/v1/images/generations

1
2
3
4
5
6
7
8
curl https://bazaarlink.ai/api/v1/images/generations \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "a red cat on a sofa",
    "size": "1024x1024"
  }'

レスポンス例

成功。デフォルト(または stream: false)では以下の同期 JSON、stream: true の場合は SSE イベントストリームを返します(イベントプロトコルは詳細ガイド参照)。ルートで無視されたパラメータはトップレベルの warnings[] に表示されます(情報提供のみ)。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "created": 1753500000,
  "data": [
    {
      "url": "https://bazaarlink.ai/api/v1/images/proxy/eyJhbGciOi..."
    }
  ],
  "warnings": [
    {
      "param": "aspect_ratio",
      "action": "dropped",
      "reason": "'aspect_ratio' is not yet mapped for this model's upstream and was ignored; the image was still generated using the model's default."
    }
  ]
}