Dokumentation API-Referenz SDK-Referenz Agentic-Nutzung KI-Skills

Bilder

Bild generieren

Generiert ein Bild aus einem Text-Prompt. Liefert standardmäßig OpenAI-kompatibles synchrones JSON (funktioniert mit client.images.generate()); mit stream: true stattdessen einen SSE-Event-Stream. Image-to-Image wird über inputImages / input_references unterstützt.

POST/api/v1/images/generations

Autorisierung

Authorizationerforderlich

string · header

API-Schlüssel als Bearer-Token im Authorization-Header.

Body

modelerforderlich

string

Das zu verwendende Bildgenerierungsmodell, mit Provider-Präfix, z. B. "openai/gpt-image-2".

minLength: 1

Example: "openai/gpt-image-2"

prompterforderlich

string

Textbeschreibung des gewünschten Bildes.

minLength: 1

Example: "a red cat on a sofa"

n

integer

Anzahl der zu generierenden Bilder, 1–10.

1–10

Example: 1

size

string

Bildgröße — explizite Pixel ("2048x2048") oder eine Stufe ("2K", "4K"). Wird unverändert an den Provider weitergegeben; unterstützte Größen variieren je nach Modell.

Example: "1024x1024"

stream

boolean

Wählt die Antwortform: weggelassen oder false = OpenAI-kompatibles synchrones JSON (Standard), true = SSE-Event-Stream.

input_references

string[]

Quellbilder für Image-to-Image (data:- oder https:-URLs), bis zu 8. Alias von inputImages (branchenüblicher Feldname); beide durchlaufen zuerst die Inhaltsmoderation. Liefert 400 — keine Warnung —, wenn die Modellroute kein i2i unterstützt.

≤ 8 images

aspect_ratio

enum<string>

Seitenverhältnis des generierten Bildes. Auf manchen Modellrouten nativ unterstützt — prüfen Sie supported_parameters in der Antwort von GET /api/v1/images/models pro Modell; nicht unterstützende Routen ignorieren das Feld und vermerken es im warnings[] der Antwort (die Anfrage ist trotzdem erfolgreich).

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>

Auflösungsstufe; konkrete Pixel werden pro Provider abgeleitet. Auf manchen Modellrouten nativ unterstützt — prüfen Sie supported_parameters in der Antwort von GET /api/v1/images/models pro Modell; nicht unterstützende Routen ignorieren das Feld und vermerken es im warnings[] der Antwort (die Anfrage ist trotzdem erfolgreich).

5121K2K4K

Example: "2K"

quality

enum<string>

Rendering-Qualität. Auf manchen Modellrouten nativ unterstützt — prüfen Sie supported_parameters in der Antwort von GET /api/v1/images/models pro Modell; nicht unterstützende Routen ignorieren das Feld und vermerken es im warnings[] der Antwort (die Anfrage ist trotzdem erfolgreich).

autolowmediumhigh

background

enum<string>

Hintergrundbehandlung; transparent erfordert ein alphafähiges output_format (png/webp). Auf manchen Modellrouten nativ unterstützt — prüfen Sie supported_parameters in der Antwort von GET /api/v1/images/models pro Modell; nicht unterstützende Routen ignorieren das Feld und vermerken es im warnings[] der Antwort (die Anfrage ist trotzdem erfolgreich).

autotransparentopaque

output_format

enum<string>

Kodierung der zurückgegebenen Bildbytes. Auf manchen Modellrouten nativ unterstützt — prüfen Sie supported_parameters in der Antwort von GET /api/v1/images/models pro Modell; nicht unterstützende Routen ignorieren das Feld und vermerken es im warnings[] der Antwort (die Anfrage ist trotzdem erfolgreich).

pngjpegwebpsvg

Example: "png"

output_compression

integer

Kompressionsstufe (0–100) für webp/jpeg-Ausgabe; bei png ignoriert. Auf manchen Modellrouten nativ unterstützt — prüfen Sie supported_parameters in der Antwort von GET /api/v1/images/models pro Modell; nicht unterstützende Routen ignorieren das Feld und vermerken es im warnings[] der Antwort (die Anfrage ist trotzdem erfolgreich).

0–100

Example: 100

seed

integer

Deterministischer Sampling-Seed; identischer Seed + Parameter sollten das Ergebnis reproduzieren, was aber nicht alle Provider garantieren. Auf manchen Modellrouten nativ unterstützt — prüfen Sie supported_parameters in der Antwort von GET /api/v1/images/models pro Modell; nicht unterstützende Routen ignorieren das Feld und vermerken es im warnings[] der Antwort (die Anfrage ist trotzdem erfolgreich).

Detailguide →

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

Antwortbeispiele

Erfolg. Standardmäßig (oder mit stream: false) wird das untenstehende synchrone JSON zurückgegeben; mit stream: true ein SSE-Event-Stream (Event-Protokoll siehe Detailguide). Von der Route ignorierte Parameter erscheinen im Top-Level-warnings[] (nur informativ).

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