> ## 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.

# Génération d’images Kling V4 Image

> Générez des images à partir de texte ou de 10 images de référence maximum, ainsi que des séries de 2–4 images liées. Le mode standard produit 1–9 images PNG en 2K / 4K / 8K par requête.

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

Envoyez une requête asynchrone à `POST /v1/images/generations` avec `model: "kling-v4-image"`. Récupérez `data[0].task_id`, puis consultez le résultat avec `GET /v1/tasks/{task_id}`.

## Authentification

**Authorization** `string` *required*

Utilisez `Authorization: Bearer <token>`, où `<token>` est votre clé API APIMart.

## Paramètres de requête

**model** `string` *required*

Doit être `kling-v4-image`.

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

Indique s'il faut modérer le contenu avant d'envoyer la tâche d'image.

* `true` : vérifier les prompts et les images d'entrée avec `omni-moderation-latest`
* `false` ou omis : ne pas envoyer de requête de modération, sans coût ni latence de modération supplémentaires (par défaut)

**prompt** `string` *required*

Obligatoire pour la génération depuis du texte, des images et pour les séries. Décrivez les éléments souhaités et ceux à éviter. La limite est de 50 000 caractères pour un texte uniquement en anglais et de 21 000 pour un texte uniquement en chinois ou dans des langues similaires ; les textes multilingues sont calculés proportionnellement.

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

Jusqu’à 10 images de référence, sous forme d’URL directes accessibles publiquement. Pour un fichier local, utilisez l’[API d’envoi d’images](https://docs.apimart.ai/fr/api-reference/uploads/images.md), puis transmettez l’`url` renvoyée.

Formats JPG / JPEG / PNG / GIF. Chaque image doit faire au plus 30 MB, au moins 300 px en largeur et en hauteur, avec un rapport entre 2:5 et 5:2.

Les références sont vérifiées à l’envoi. Une URL renvoyant HTTP 403 / 404 / 410, un côté inférieur à 300 px, un rapport hors de 2:5–5:2 ou une image de plus de 30 MB provoque immédiatement HTTP 400, sans création de tâche ni frais de génération. Les autres échecs de récupération, comme un délai d’attente du serveur d’origine, sont d’abord acceptés ; la tâche échoue ensuite et les frais de génération prélevés à l’avance sont intégralement remboursés.

Utilisez `@Image1`, `@Image2`, etc. dans le prompt pour désigner les images dans l’ordre du tableau. Elles servent aussi de référence sans ces marqueurs.

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

Nombre d’images en mode standard : entier de 1 à 9, par défaut 1. En mode série, `n` peut être omis ou égal à `1` ; le nombre de sorties est défini par `sequential_image_generation_options.max_images`. `n > 1` en mode série renvoie HTTP 400.

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

Accepte `2K` (par défaut), `4K` et `8K`, sans distinction de casse. La sortie est en PNG. Au format `1:1`, 2K correspond à `2048×2048`, 4K à `4096×4096` et 8K à `8192×8192`. Pour les autres rapports, consultez les dimensions réelles des images renvoyées.

Le mode 8K prend aussi en charge la génération depuis du texte, depuis des images et en série : 1–9 sorties en mode standard, 2–4 en série et jusqu’à 10 images de référence. Les formats, dimensions et la limite de 30 MB par image de référence restent identiques.

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

Rapport largeur/hauteur de sortie. Accepte `auto` (par défaut) et ces 8 rapports explicites :

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

`auto` choisit le rapport selon le prompt ou les images de référence. Les dimensions en pixels, comme `2048x2048`, ne sont pas acceptées.

**aspect\_ratio** `string`

Alias de `size`, avec les mêmes valeurs. Si les deux sont fournis, `aspect_ratio` est prioritaire.

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

`disabled` ou l’absence du champ active la génération standard. `auto` génère une série d’images liées et rend `sequential_image_generation_options.max_images` obligatoire. Ici, `auto` ne choisit pas automatiquement le nombre d’images.

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

Définit le nombre d’images en mode série.

**Propriétés**

**max\_images** `integer`

Obligatoire en mode série : entier de 2 à 4 indiquant le nombre d’images demandé. L’absence de valeur, la chaîne `"auto"` ou une valeur hors plage renvoie HTTP 400.

> [!WARNING]
>
> `width`, `height`, `mask_url`, `size` en pixels et `watermark: true` ne sont pas acceptés et renvoient HTTP 400.

## Exemples de requêtes

Envoyez ces requêtes à `POST /v1/images/generations`. Remplacez les URL d’exemple par des liens directs accessibles.

### Génération à partir d’une image

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

### Générer trois images 4K

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

### Générer une image 8K

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

### Générer une série de quatre images 8K liées

Définissez `max_images` entre 2 et 4. En série, `n` peut être omis ou égal à `1`, mais pas supérieur à `1`. Une série peut prendre plusieurs minutes : conservez le `task_id` et interrogez son état plutôt que de renvoyer la requête.

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

## Exemples de sorties 8K et de durées

Les mesures suivantes proviennent de l’environnement de test. Dimensions, tailles de fichiers et durées sont indicatives ; les résultats réels peuvent varier.

| Requête 8K | Dimensions de sortie | Taille du fichier par image | Durée totale |
| - | - | - | - |
| 1 image standard (16:9) | `10880×6144` | 117 MB | Environ 2,5 minutes |
| 4 / 9 images standard (1:1) | `8192×8192` | 100–130 MB | Environ 3 minutes |
| Série de 4 images (3:4) | `7040×9344` | 77–104 MB | Environ 6 minutes |

Consultez le statut toutes les 5–10 secondes jusqu’à `completed` ou `failed`. `estimated_time` est fixé à 60 secondes et ne doit pas servir d’estimation réelle ni de compte à rebours. Conservez le `task_id` et évitez de soumettre à nouveau la requête pendant l’attente.

Les résultats 8K sont des PNG originaux ; un seul fichier peut dépasser 100 MB. Pour les listes et aperçus, utilisez des miniatures que vous générez ou un chargement à la demande. Proposez le téléchargement de l’original et indiquez la taille importante du fichier.

## Consulter la tâche

Lisez `data.status` via l’[API de suivi des tâches](https://docs.apimart.ai/fr/api-reference/tasks/status.md) : `pending` / `processing` indique un traitement en cours, `completed` un succès et `failed` un échec détaillé dans `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>'
```

Voici la structure d’un résultat réussi. Les URL sont dans `data.result.images[].url[]` ; `url` est un tableau. Parcourez toutes les sorties et téléchargez-les rapidement.

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

## Facturation

La facturation dépend du nombre réel d’images générées et de la résolution choisie. Les références sont facturées séparément par image. Consultez la [page des tarifs](https://apimart.ai/pricing).

| Élément facturé | Clé tarifaire |
| - | - |
| Chaque image de sortie 2K | `kling-v4-image@2K` |
| Chaque image de sortie 4K | `kling-v4-image@4K` |
| Chaque image de sortie 8K | `kling-v4-image@8K` |
| Chaque image de référence en entrée | `kling-v4-image@input` |

* En génération standard, `n=3` correspond à 3 sorties facturées ; pour les séries, le nombre réellement renvoyé est utilisé.
* Chaque référence est comptée une fois par requête, sans multiplication par le nombre de sorties. Générer 3 images à partir de 2 références correspond à 2 entrées et 3 sorties facturées.
* Les tâches de génération échouées ne sont pas facturées ; les frais de génération prélevés à l’avance sont intégralement remboursés.

## Erreurs courantes de paramètres

Ces erreurs renvoient HTTP 400 de façon synchrone à l’envoi, sans création de tâche ni frais de génération. Lisez `error.message` pour les erreurs d’envoi et `data.error.message` pour les échecs après création de la tâche.

| Extrait de l’erreur | Solution |
| - | - |
| `` `prompt` is required for kling-v4-image `` | Fournissez un prompt non vide. |
| `` `n` must be an integer between 1 and 9 `` | Utilisez un entier de 1 à 9 pour `n`. |
| `` `n` cannot be combined with sequential_image_generation=auto `` | En série, omettez `n` ou définissez-le à `1` ; utilisez `max_images` pour le nombre de sorties. |
| `` `sequential_image_generation_options.max_images` is required for kling-v4-image series mode `` | Fournissez `max_images` pour les séries. |
| `` `sequential_image_generation_options.max_images` must be an integer between 2 and 4 `` | Utilisez un entier de 2 à 4, pas `"auto"`. |
| `` `resolution` must be 2K, 4K or 8K for kling-v4-image `` | Utilisez `2K`, `4K` ou `8K`, sans distinction de casse. |
| `` `size` must be auto or one of 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 `` | Utilisez `auto` ou un rapport accepté, pas des dimensions en pixels. |
| `kling-v4-image supports at most 10 reference images` | Fournissez au maximum 10 images de référence. |
| `reference image is not accessible for kling-v4-image` | L’URL de référence renvoie 403 / 404 / 410. Vérifiez qu’elle est publique et valide, ou envoyez à nouveau l’image. |
| `unsupported reference image dimensions for kling-v4-image` | La largeur et la hauteur doivent être d’au moins 300 px, avec un rapport entre 2:5 et 5:2. Les erreurs de rapport utilisent le même préfixe. |
| `reference image too large for kling-v4-image` | Chaque référence doit faire au plus 30 MB. Compressez-la avant un nouvel envoi. |
| `` `n` must be an integer between 1 and 9 for kling-v4-image (got: "3") `` | Utilisez un entier JSON comme `"n": 3`, pas la chaîne `"3"`. Les autres champs doivent aussi respecter le type déclaré : chaîne, tableau ou booléen. |


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