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 이미지 생성
텍스트 또는 최대 10장의 참조 이미지로 이미지를 생성하고, 서로 관련된 이미지 2–4장을 시리즈로 생성합니다. 일반 모드는 요청당 1–9장의 2K / 4K / 8K PNG를 출력합니다.
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"를 지정하여 POST /v1/images/generations로 비동기 작업을 제출합니다. data[0].task_id를 얻은 후 GET /v1/tasks/{task_id}로 결과를 조회합니다.
인증
요청 매개변수
이미지 작업을 제출하기 전에 콘텐츠 검토를 실행할지 여부를 지정합니다.
true:omni-moderation-latest로 프롬프트와 입력 이미지를 검토false또는 생략: 검토 요청을 보내지 않으며 검토 비용이나 지연이 추가되지 않음(기본값)
텍스트 기반 생성, 이미지 기반 생성, 시리즈 생성 모두 필수입니다. 원하는 내용과 피하고 싶은 내용을 함께 작성할 수 있습니다. 영어만 사용하면 최대 50,000자, 중국어 등만 사용하면 최대 21,000자이며 혼합 언어는 비율에 따라 계산됩니다.
공개적으로 접근 가능한 이미지 직접 URL을 최대 10개 지정합니다. 로컬 파일은 이미지 업로드 API로 업로드한 후 반환된
url을 사용하세요.JPG / JPEG / PNG / GIF를 지원합니다. 이미지당 최대 30 MB, 너비와 높이 모두 최소 300 px, 가로세로 비율은 2:5–5:2여야 합니다.제출 시 참조 이미지를 검사합니다. URL이 HTTP 403 / 404 / 410을 반환하거나, 어느 한 변이 300 px 미만이거나, 비율이 2:5–5:2를 벗어나거나, 이미지가 30 MB를 초과하면 즉시 HTTP 400을 반환합니다. 작업은 생성되지 않고 생성 요금도 부과되지 않습니다. 원본 서버 시간 초과 등 다른 가져오기 오류는 먼저 접수된 후 작업이 실패하며 선차감한 생성 요금이 전액 환불됩니다.프롬프트에서 @Image1, @Image2 등으로 배열 순서에 따라 이미지를 참조할 수 있습니다. 이 표기가 없어도 입력 이미지를 참조합니다.일반 모드의 출력 수로, 1–9 사이의 정수이며 기본값은 1입니다. 시리즈 모드에서는
n을 생략하거나 1로 설정할 수 있으며 출력 수는 sequential_image_generation_options.max_images로 지정합니다. 시리즈에서 n > 1이면 HTTP 400을 반환합니다.2K(기본값), 4K, 8K를 지원하며 대소문자를 구분하지 않습니다. 출력 형식은 PNG입니다. 1:1 비율에서 2K는 2048×2048, 4K는 4096×4096, 8K는 8192×8192입니다. 다른 비율은 반환된 이미지의 실제 크기를 확인하세요.8K에서도 텍스트 기반 생성, 이미지 기반 생성, 시리즈 생성을 지원합니다. 일반 모드는 1–9장, 시리즈는 2–4장, 참조 이미지는 최대 10장입니다. 참조 이미지의 형식, 크기 조건, 장당 30 MB 제한은 동일합니다.출력 가로세로 비율입니다.
auto(기본값)와 다음 8가지 비율을 지원합니다.16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9.auto는 프롬프트나 참조 이미지에 따라 비율을 결정합니다. 2048x2048 같은 픽셀 크기는 지원하지 않습니다.disabled 또는 생략 시 일반 생성입니다. auto로 설정하면 관련 이미지를 시리즈로 생성하며 sequential_image_generation_options.max_images가 필수입니다. 여기서 auto는 이미지 수를 자동 결정한다는 뜻이 아닙니다.width, height, mask_url, 픽셀 형식의 size, watermark: true는 지원하지 않으며 전달하면 HTTP 400을 반환합니다.요청 예제
아래 요청은POST /v1/images/generations로 보냅니다. 예제 이미지 URL을 실제 접근 가능한 직접 링크로 바꾸세요.
이미지 기반 생성
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"
}'
4K 이미지 3장 생성
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
}'
8K 이미지 1장 생성
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
}'
관련된 8K 이미지 4장 시리즈 생성
시리즈에서는max_images를 2–4로 지정합니다. n은 생략하거나 1로 설정할 수 있지만 1보다 클 수 없습니다. 몇 분이 걸릴 수 있으므로 task_id를 보관하고 상태를 조회하여 중복 제출을 피하세요.
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 출력 및 소요 시간 예시
다음은 테스트 환경에서 측정한 샘플입니다. 이미지 크기, 파일 크기, 소요 시간은 참고용이며 실제 결과는 달라질 수 있습니다.| 8K 요청 | 출력 크기 | 장당 파일 크기 | 완료까지 걸린 시간 |
|---|---|---|---|
| 일반 생성 1장(16:9) | 10880×6144 | 117 MB | 약 2.5분 |
| 일반 생성 4 / 9장(1:1) | 8192×8192 | 100–130 MB | 약 3분 |
| 시리즈 4장(3:4) | 7040×9344 | 77–104 MB | 약 6분 |
completed 또는 failed가 될 때까지 5–10초 간격으로 조회하세요. estimated_time은 60초로 고정되어 있으므로 실제 완료 예상 시간이나 카운트다운으로 사용하면 안 됩니다. task_id를 보관하고 대기 중에 중복 제출하지 마세요.
8K 결과는 PNG 원본이며 파일 하나가 100 MB를 넘을 수 있습니다. 목록과 미리보기에는 직접 만든 썸네일을 사용하거나 필요할 때 이미지를 불러오세요. 원본 다운로드 기능과 큰 파일 크기 안내를 제공하세요.
작업 조회
작업 조회 API의data.status를 확인하세요. pending / processing은 처리 중, completed는 성공이며 failed이면 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은 배열입니다. 모든 출력을 순회하여 가져온 후 바로 다운로드해 보관하세요.
{
"code": 200,
"data": {
"id": "task_example_kling_v4_image",
"status": "completed",
"result": {
"images": [
{
"url": [
"https://example.com/generated-image.png"
]
}
]
}
}
}
요금
실제 출력 이미지 수와 선택한 해상도 등급에 따라 요금이 부과되며, 참조 이미지는 장당 별도로 계산됩니다. 단가는 가격 페이지를 확인하세요.| 요금 항목 | 가격 키 |
|---|---|
| 2K 출력 이미지 1장 | kling-v4-image@2K |
| 4K 출력 이미지 1장 | kling-v4-image@4K |
| 8K 출력 이미지 1장 | kling-v4-image@8K |
| 입력 참조 이미지 1장 | kling-v4-image@input |
- 일반 생성에서
n=3이면 출력 3장으로, 시리즈는 실제 반환된 장수로 계산합니다. - 참조 이미지는 요청당 각 1회만 계산하며 출력 장수를 곱하지 않습니다. 참조 2장으로 3장을 생성하면 입력 2장과 출력 3장 요금입니다.
- 생성에 실패한 작업에는 생성 요금이 부과되지 않으며 선차감한 생성 요금은 전액 환불됩니다.
주요 매개변수 오류
아래 매개변수 오류는 제출 시 동기적으로 HTTP 400을 반환하며 작업이 생성되지 않고 생성 요금도 부과되지 않습니다. 제출 오류는error.message, 작업 생성 후 실패는 data.error.message를 확인하세요.
| 오류 내용 일부 | 해결 방법 |
|---|---|
`prompt` is required for kling-v4-image | 비어 있지 않은 프롬프트를 전달하세요. |
`n` must be an integer between 1 and 9 | n은 1–9 사이의 정수로 지정하세요. |
`n` cannot be combined with sequential_image_generation=auto | 시리즈의 n은 생략하거나 1로 설정하고 출력 수는 max_images로 지정하세요. |
`sequential_image_generation_options.max_images` is required for kling-v4-image series mode | 시리즈 생성 시 max_images를 전달하세요. |
`sequential_image_generation_options.max_images` must be an integer between 2 and 4 | "auto" 대신 2–4 사이의 정수를 지정하세요. |
`resolution` must be 2K, 4K or 8K for kling-v4-image | 2K, 4K, 8K를 사용하세요. 대소문자는 구분하지 않습니다. |
`size` must be auto or one of 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 | 픽셀 크기 대신 auto 또는 지원하는 비율을 지정하세요. |
kling-v4-image supports at most 10 reference images | 참조 이미지는 최대 10장입니다. |
reference image is not accessible for kling-v4-image | 참조 URL이 403 / 404 / 410을 반환했습니다. 공개 접근 가능 여부와 유효성을 확인하거나 이미지를 다시 업로드하세요. |
unsupported reference image dimensions for kling-v4-image | 너비와 높이가 모두 최소 300 px이고 비율이 2:5–5:2인지 확인하세요. 비율 초과에도 같은 오류 접두사가 사용됩니다. |
reference image too large for kling-v4-image | 참조 이미지는 장당 최대 30 MB입니다. 압축한 후 다시 제출하세요. |
`n` must be an integer between 1 and 9 for kling-v4-image (got: "3") | 문자열 "3" 대신 "n": 3 같은 JSON 정수를 사용하세요. 다른 필드도 명시된 문자열, 배열 또는 불리언 타입을 사용해야 합니다. |