Dokumentasi Referensi API Referensi SDK Penggunaan Agentik Skill AI

Gambar

Hasilkan gambar

Menghasilkan gambar dari prompt teks. Secara default mengembalikan JSON sinkron kompatibel OpenAI (berfungsi dengan client.images.generate()); kirim stream: true untuk mendapatkan aliran event SSE. Image-to-image didukung melalui inputImages / input_references.

POST/api/v1/images/generations

Otorisasi

Authorizationwajib

string · header

API key sebagai bearer token di header Authorization.

Body

modelwajib

string

Model pembuatan gambar yang digunakan, dengan prefiks penyedia, mis. "openai/gpt-image-2".

minLength: 1

Example: "openai/gpt-image-2"

promptwajib

string

Deskripsi teks dari gambar yang diinginkan.

minLength: 1

Example: "a red cat on a sofa"

n

integer

Jumlah gambar yang dihasilkan, 1–10.

1–10

Example: 1

size

string

Ukuran gambar — piksel eksplisit ("2048x2048") atau tingkat ("2K", "4K"). Diteruskan apa adanya ke penyedia; ukuran yang didukung bervariasi per model.

Example: "1024x1024"

stream

boolean

Memilih bentuk respons: dihilangkan atau false = JSON sinkron kompatibel OpenAI (default), true = aliran event SSE.

input_references

string[]

Gambar sumber untuk image-to-image (URL data: atau https:), maksimal 8. Alias dari inputImages (nama field konvensi industri); keduanya melewati moderasi konten terlebih dahulu. Mengembalikan 400 — bukan warning — jika rute model tidak mendukung i2i.

≤ 8 images

aspect_ratio

enum<string>

Rasio aspek gambar yang dihasilkan. Didukung secara native pada beberapa rute model — periksa supported_parameters dalam respons GET /api/v1/images/models untuk tiap model; rute yang tidak mendukung mengabaikan field ini dan mencatatnya di warnings[] respons (permintaan tetap berhasil).

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>

Tingkat resolusi; piksel konkret ditentukan per penyedia. Didukung secara native pada beberapa rute model — periksa supported_parameters dalam respons GET /api/v1/images/models untuk tiap model; rute yang tidak mendukung mengabaikan field ini dan mencatatnya di warnings[] respons (permintaan tetap berhasil).

5121K2K4K

Example: "2K"

quality

enum<string>

Kualitas render. Didukung secara native pada beberapa rute model — periksa supported_parameters dalam respons GET /api/v1/images/models untuk tiap model; rute yang tidak mendukung mengabaikan field ini dan mencatatnya di warnings[] respons (permintaan tetap berhasil).

autolowmediumhigh

background

enum<string>

Perlakuan latar; transparent memerlukan output_format yang mendukung alpha (png/webp). Didukung secara native pada beberapa rute model — periksa supported_parameters dalam respons GET /api/v1/images/models untuk tiap model; rute yang tidak mendukung mengabaikan field ini dan mencatatnya di warnings[] respons (permintaan tetap berhasil).

autotransparentopaque

output_format

enum<string>

Encoding dari byte gambar yang dikembalikan. Didukung secara native pada beberapa rute model — periksa supported_parameters dalam respons GET /api/v1/images/models untuk tiap model; rute yang tidak mendukung mengabaikan field ini dan mencatatnya di warnings[] respons (permintaan tetap berhasil).

pngjpegwebpsvg

Example: "png"

output_compression

integer

Tingkat kompresi (0–100) untuk keluaran webp/jpeg; diabaikan untuk png. Didukung secara native pada beberapa rute model — periksa supported_parameters dalam respons GET /api/v1/images/models untuk tiap model; rute yang tidak mendukung mengabaikan field ini dan mencatatnya di warnings[] respons (permintaan tetap berhasil).

0–100

Example: 100

seed

integer

Seed sampling deterministik; seed + parameter identik seharusnya mereproduksi hasil, meski tidak semua penyedia menjaminnya. Didukung secara native pada beberapa rute model — periksa supported_parameters dalam respons GET /api/v1/images/models untuk tiap model; rute yang tidak mendukung mengabaikan field ini dan mencatatnya di warnings[] respons (permintaan tetap berhasil).

Panduan mendalam →

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"
  }'

Contoh respons

Berhasil. Secara default (atau stream: false) mengembalikan JSON sinkron di bawah; dengan stream: true, mengembalikan aliran event SSE (lihat panduan mendalam). Parameter yang diabaikan rute muncul di warnings[] tingkat atas (hanya informatif).

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."
    }
  ]
}