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
}'
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())
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());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example_kling_v4_image"
}
]
}
{
"error": {
"code": 400,
"message": "`prompt` is required for kling-v4-image",
"type": "invalid_request_error"
}
}
Kling V4 Image
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.
POST
/
v1
/
images
/
generations
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
}'
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())
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());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example_kling_v4_image"
}
]
}
{
"error": {
"code": 400,
"message": "`prompt` is required for kling-v4-image",
"type": "invalid_request_error"
}
}
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
}'
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())
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());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example_kling_v4_image"
}
]
}
{
"error": {
"code": 400,
"message": "`prompt` is required for kling-v4-image",
"type": "invalid_request_error"
}
}
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
Paramètres de requête
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 avecomni-moderation-latestfalseou omis : ne pas envoyer de requête de modération, sans coût ni latence de modération supplémentaires (par défaut)
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.
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, 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.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.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.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.Alias de
size, avec les mêmes valeurs. Si les deux sont fournis, aspect_ratio est prioritaire.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.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
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
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
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éfinissezmax_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.
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 |
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
Lisezdata.status via l’API de suivi des tâches : pending / processing indique un traitement en cours, completed un succès et failed un échec détaillé dans data.error.message.
curl --request GET \
--url 'https://api.apimart.ai/v1/tasks/task_example_kling_v4_image' \
--header 'Authorization: Bearer <token>'
data.result.images[].url[] ; url est un tableau. Parcourez toutes les sorties et téléchargez-les rapidement.
{
"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.| É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=3correspond à 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. Lisezerror.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. |