> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Kling V4 Image Bilderzeugung

> Bilder aus Text oder bis zu 10 Referenzbildern sowie Serien aus 2–4 zusammengehörigen Bildern erzeugen. Der Standardmodus liefert 1–9 Bilder pro Anfrage als PNG in 2K / 4K / 8K.

```bash cURL theme={null}
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "kling-v4-image",
  "prompt": "An orange cat sitting on a windowsill in warm afternoon sunlight, realistic photography",
  "size": "1:1",
  "resolution": "2K",
  "n": 1,
  "nsfw_check": true
}'
```

```python Python theme={null}
import requests

payload = {
  "model": "kling-v4-image",
  "prompt": "An orange cat sitting on a windowsill in warm afternoon sunlight, realistic photography",
  "size": "1:1",
  "resolution": "2K",
  "n": 1,
  "nsfw_check": True
}
response = requests.post(
    "https://api.apimart.ai/v1/images/generations",
    headers={"Authorization": "Bearer <token>"},
    json=payload,
    timeout=60,
)
response.raise_for_status()
print(response.json())
```

```javascript JavaScript theme={null}
const payload = {
  "model": "kling-v4-image",
  "prompt": "An orange cat sitting on a windowsill in warm afternoon sunlight, realistic photography",
  "size": "1:1",
  "resolution": "2K",
  "n": 1,
  "nsfw_check": true
};
const response = await fetch("https://api.apimart.ai/v1/images/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify(payload)
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
```

```json 200 theme={null}
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_example_kling_v4_image"
    }
  ]
}
```

```json 400 theme={null}
{
  "error": {
    "code": 400,
    "message": "`prompt` is required for kling-v4-image",
    "type": "invalid_request_error"
  }
}
```

Senden Sie mit `model: "kling-v4-image"` eine asynchrone Anfrage an `POST /v1/images/generations`. Lesen Sie `data[0].task_id` aus und fragen Sie das Ergebnis über `GET /v1/tasks/{task_id}` ab.

## Authentifizierung

**Authorization** `string` *required*

Verwenden Sie `Authorization: Bearer <token>`. `<token>` ist Ihr APIMart-API-Schlüssel.

## Anfrageparameter

**model** `string` *required*

Muss `kling-v4-image` sein.

**nsfw\_check** `boolean` (default: false)

Legt fest, ob der Inhalt vor dem Absenden des Bildauftrags moderiert wird.

* `true`: Prompts und Eingabebilder mit `omni-moderation-latest` prüfen
* `false` oder nicht angegeben: keine Moderationsanfrage und damit keine zusätzlichen Moderationskosten oder Verzögerung (Standard)

**prompt** `string` *required*

Für Text-zu-Bild, Bild-zu-Bild und Serien erforderlich. Beschreiben Sie gewünschte und unerwünschte Inhalte im Prompt. Die Grenze beträgt 50.000 Zeichen für rein englischen Text und 21.000 für rein chinesischen Text und ähnliche Sprachen; bei gemischten Sprachen wird sie anteilig berechnet.

**image\_urls** `string[]`

Bis zu 10 Referenzbilder als öffentlich zugängliche direkte Bild-URLs. Lokale Dateien können Sie über die [Bild-Upload-API](https://docs.apimart.ai/de/api-reference/uploads/images.md) hochladen und anschließend die zurückgegebene `url` verwenden.

Unterstützt JPG / JPEG / PNG / GIF. Pro Bild höchstens 30 MB, Breite und Höhe jeweils mindestens 300 px und Seitenverhältnis zwischen 2:5 und 5:2.

Referenzbilder werden bei der Einreichung geprüft. Bei HTTP 403 / 404 / 410 der URL, einer Seite unter 300 px, einem Verhältnis außerhalb von 2:5–5:2 oder mehr als 30 MB wird sofort HTTP 400 zurückgegeben. Es wird keine Aufgabe erstellt und keine Generierungsgebühr berechnet. Andere Abruffehler, etwa ein Timeout des Ursprungsservers, werden zunächst angenommen; anschließend schlägt die Aufgabe fehl und vorab abgezogene Generierungsgebühren werden vollständig erstattet.

Mit `@Image1`, `@Image2` usw. verweisen Sie im Prompt auf die Reihenfolge im Array. Die Bilder werden auch ohne diese Markierungen als Referenz verwendet.

**n** `integer` (default: 1)

Anzahl der Ausgabebilder im Standardmodus: ganze Zahl von 1 bis 9, Standard 1. Im Serienmodus kann `n` entfallen oder `1` sein; die Ausgabeanzahl wird durch `sequential_image_generation_options.max_images` bestimmt. `n > 1` im Serienmodus führt zu HTTP 400.

**resolution** `string` (default: 2K)

Unterstützt `2K` (Standard), `4K` und `8K`, unabhängig von Groß- und Kleinschreibung. Ausgabe als PNG. Bei `1:1` entspricht 2K `2048×2048`, 4K `4096×4096` und 8K `8192×8192`. Bei anderen Verhältnissen gelten die tatsächlichen Maße der zurückgegebenen Bilder.

8K unterstützt Text-zu-Bild, Bild-zu-Bild und Serien: 1–9 Ausgaben im Standardmodus, 2–4 Bilder pro Serie und bis zu 10 Referenzbilder. Format- und Größenanforderungen sowie die Grenze von 30 MB pro Referenzbild bleiben unverändert.

**size** `string` (default: auto)

Seitenverhältnis der Ausgabe. Unterstützt `auto` (Standard) sowie diese 8 festen Verhältnisse:

`16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3`, `21:9`.

`auto` wählt das Verhältnis anhand des Prompts oder der Referenzbilder. Pixelmaße wie `2048x2048` werden nicht unterstützt.

**aspect\_ratio** `string`

Alias für `size` mit denselben Werten. Werden beide angegeben, hat `aspect_ratio` Vorrang.

**sequential\_image\_generation** `string` (default: disabled)

`disabled` oder Weglassen aktiviert die normale Generierung. Mit `auto` wird eine Serie zusammengehöriger Bilder erzeugt; dann ist `sequential_image_generation_options.max_images` erforderlich. `auto` bestimmt hier nicht automatisch die Bildanzahl.

**sequential\_image\_generation\_options** `object`

Legt die Bildanzahl im Serienmodus fest.

**Eigenschaften**

**max\_images** `integer`

Im Serienmodus erforderlich: ganze Zahl von 2 bis 4 für die gewünschte Ausgabeanzahl. Ein fehlender Wert, die Zeichenfolge `"auto"` oder ein Wert außerhalb des Bereichs führt zu HTTP 400.

> [!WARNING]
>
> `width`, `height`, `mask_url`, Pixelmaße in `size` und `watermark: true` werden nicht unterstützt und führen zu HTTP 400.

## Anfragebeispiele

Senden Sie diese Anfragen an `POST /v1/images/generations`. Ersetzen Sie die Beispiel-URLs durch erreichbare direkte Bildlinks.

### Bild-zu-Bild

```bash theme={null}
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "kling-v4-image",
  "prompt": "Use the dog in @Image1 as a reference for a 3D animated character poster, preserving its fur color and features",
  "image_urls": [
    "https://example.com/dog.png"
  ],
  "size": "3:4",
  "resolution": "2K"
}'
```

### Drei 4K-Bilder erzeugen

```bash theme={null}
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "kling-v4-image",
  "prompt": "A quiet mountain lake at sunrise, detailed landscape photography",
  "size": "16:9",
  "resolution": "4K",
  "n": 3
}'
```

### Ein 8K-Bild erzeugen

```bash theme={null}
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "kling-v4-image",
  "prompt": "A sweeping aerial view of a misty mountain valley at sunrise",
  "resolution": "8K",
  "size": "16:9",
  "n": 1
}'
```

### Eine Serie aus vier zusammengehörigen 8K-Bildern erzeugen

Setzen Sie `max_images` auf 2–4. `n` kann im Serienmodus entfallen oder `1` sein, darf aber nicht größer als `1` sein. Serien können mehrere Minuten dauern. Speichern Sie die `task_id` und fragen Sie den Status ab, statt die Anfrage erneut einzureichen.

```bash theme={null}
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "kling-v4-image",
  "prompt": "The same tree in spring, summer, autumn, and winter, consistent picture-book style",
  "sequential_image_generation": "auto",
  "sequential_image_generation_options": {
    "max_images": 4
  },
  "size": "3:4",
  "resolution": "8K"
}'
```

## 8K-Ausgaben und gemessene Bearbeitungszeiten

Die folgenden Beispiele wurden in der Testumgebung gemessen. Abmessungen, Dateigrößen und Bearbeitungszeiten dienen als Anhaltspunkte; tatsächliche Ergebnisse können abweichen.

| 8K-Anfrage | Ausgabemaße | Dateigröße je Bild | Zeit bis zum Abschluss |
| - | - | - | - |
| 1 Bild im Standardmodus (16:9) | `10880×6144` | 117 MB | Etwa 2,5 Minuten |
| 4 / 9 Bilder im Standardmodus (1:1) | `8192×8192` | 100–130 MB | Etwa 3 Minuten |
| Serie mit 4 Bildern (3:4) | `7040×9344` | 77–104 MB | Etwa 6 Minuten |

Fragen Sie den Status alle 5–10 Sekunden ab, bis er `completed` oder `failed` lautet. `estimated_time` ist auf 60 Sekunden festgelegt und eignet sich nicht als tatsächliche Zeitschätzung oder Countdown. Bewahren Sie die `task_id` auf und senden Sie während der Wartezeit keine doppelten Anfragen.

8K-Ergebnisse sind PNG-Originale; eine einzelne Datei kann größer als 100 MB sein. Verwenden Sie für Listen und Vorschauen selbst erzeugte Vorschaubilder oder laden Sie Bilder erst bei Bedarf. Bieten Sie einen Download des Originals an und weisen Sie auf die große Datei hin.

## Aufgabe abfragen

Lesen Sie `data.status` über die [Aufgabenabfrage-API](https://docs.apimart.ai/de/api-reference/tasks/status.md): `pending` / `processing` bedeutet laufend, `completed` erfolgreich und `failed` fehlgeschlagen. Fehlerdetails stehen in `data.error.message`.

```bash theme={null}
curl --request GET \
  --url 'https://api.apimart.ai/v1/tasks/task_example_kling_v4_image' \
  --header 'Authorization: Bearer <token>'
```

Das folgende Beispiel zeigt die Struktur eines erfolgreichen Ergebnisses. Bild-URLs stehen in `data.result.images[].url[]`; `url` ist ein Array. Lesen Sie alle Ausgaben aus und laden Sie sie zeitnah herunter.

```json theme={null}
{
  "code": 200,
  "data": {
    "id": "task_example_kling_v4_image",
    "status": "completed",
    "result": {
      "images": [
        {
          "url": [
            "https://example.com/generated-image.png"
          ]
        }
      ]
    }
  }
}
```

## Abrechnung

Abgerechnet werden die tatsächlich erzeugten Bilder nach der gewählten Auflösungsstufe. Referenzbilder werden separat pro Bild berechnet. Aktuelle Preise finden Sie auf der [Preisseite](https://apimart.ai/pricing).

| Abrechnungsposten | Preisschlüssel |
| - | - |
| Je 2K-Ausgabebild | `kling-v4-image@2K` |
| Je 4K-Ausgabebild | `kling-v4-image@4K` |
| Je 8K-Ausgabebild | `kling-v4-image@8K` |
| Je Eingabe-Referenzbild | `kling-v4-image@input` |

* Bei normaler Generierung mit `n=3` werden 3 Ausgabebilder berechnet; bei Serien zählt die tatsächlich zurückgegebene Anzahl.
* Jedes Referenzbild wird pro Anfrage einmal berechnet, unabhängig von der Ausgabeanzahl. 3 Bilder aus 2 Referenzen entsprechen 2 Eingabe- und 3 Ausgabebildern.
* Fehlgeschlagene Generierungsaufgaben werden nicht berechnet; vorab abgezogene Generierungsgebühren werden vollständig erstattet.

## Häufige Parameterfehler

Diese Parameterfehler liefern bei der Einreichung synchron HTTP 400. Es wird keine Aufgabe erstellt und keine Generierungsgebühr berechnet. Lesen Sie `error.message` bei Einreichungsfehlern und `data.error.message` bei Fehlern nach der Aufgabenerstellung.

| Fehlerauszug | Abhilfe |
| - | - |
| `` `prompt` is required for kling-v4-image `` | Geben Sie einen nicht leeren Prompt an. |
| `` `n` must be an integer between 1 and 9 `` | Verwenden Sie für `n` eine ganze Zahl von 1 bis 9. |
| `` `n` cannot be combined with sequential_image_generation=auto `` | Lassen Sie `n` im Serienmodus weg oder setzen Sie es auf `1`; die Ausgabeanzahl steuert `max_images`. |
| `` `sequential_image_generation_options.max_images` is required for kling-v4-image series mode `` | Geben Sie für Serien `max_images` an. |
| `` `sequential_image_generation_options.max_images` must be an integer between 2 and 4 `` | Verwenden Sie eine ganze Zahl von 2 bis 4, nicht `"auto"`. |
| `` `resolution` must be 2K, 4K or 8K for kling-v4-image `` | Verwenden Sie `2K`, `4K` oder `8K`; die Groß- und Kleinschreibung spielt keine Rolle. |
| `` `size` must be auto or one of 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 `` | Nutzen Sie `auto` oder ein unterstütztes Verhältnis, keine Pixelmaße. |
| `kling-v4-image supports at most 10 reference images` | Geben Sie höchstens 10 Referenzbilder an. |
| `reference image is not accessible for kling-v4-image` | Die Referenz-URL liefert 403 / 404 / 410. Prüfen Sie den öffentlichen Zugriff und die Gültigkeit oder laden Sie das Bild erneut hoch. |
| `unsupported reference image dimensions for kling-v4-image` | Breite und Höhe müssen jeweils mindestens 300 px betragen, das Verhältnis muss zwischen 2:5 und 5:2 liegen. Verhältnisfehler verwenden dasselbe Fehlerpräfix. |
| `reference image too large for kling-v4-image` | Jedes Referenzbild darf höchstens 30 MB groß sein. Komprimieren Sie es vor der erneuten Einreichung. |
| `` `n` must be an integer between 1 and 9 for kling-v4-image (got: "3") `` | Nutzen Sie eine JSON-Ganzzahl wie `"n": 3`, nicht die Zeichenfolge `"3"`. Auch andere Felder müssen den angegebenen Typ für Zeichenfolge, Array oder booleschen Wert verwenden. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.