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
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.
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"
}
}
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
Verwenden Sie
Authorization: Bearer <token>. <token> ist Ihr APIMart-API-Schlüssel.Anfrageparameter
Legt fest, ob der Inhalt vor dem Absenden des Bildauftrags moderiert wird.
true: Prompts und Eingabebilder mitomni-moderation-latestprüfenfalseoder nicht angegeben: keine Moderationsanfrage und damit keine zusätzlichen Moderationskosten oder Verzögerung (Standard)
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.
Bis zu 10 Referenzbilder als öffentlich zugängliche direkte Bild-URLs. Lokale Dateien können Sie über die Bild-Upload-API 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.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.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.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.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.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 anPOST /v1/images/generations. Ersetzen Sie die Beispiel-URLs durch erreichbare direkte Bildlinks.
Bild-zu-Bild
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
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
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 Siemax_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.
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 |
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 Siedata.status über die Aufgabenabfrage-API: pending / processing bedeutet laufend, completed erfolgreich und failed fehlgeschlagen. Fehlerdetails stehen in 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 ist ein Array. Lesen Sie alle Ausgaben aus und laden Sie sie zeitnah herunter.
{
"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.| 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=3werden 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 Sieerror.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. |