Kling Image 4.0 · 이미지 API
Kling Image 4.0으로 단일 이미지, 일관된 이미지 시리즈, 상품 상세 페이지와 웹페이지용 긴 이미지를 생성합니다.
Kling Image 4.0
Kling Image 4.0으로 단일 이미지, 일관된 이미지 시리즈, 상품 상세 페이지와 웹페이지용 긴 이미지를 생성합니다.
엔드포인트
POST https://apimaster.ai/v1/kling/kling-image-4.0/image-generation·single,seriesPOST https://apimaster.ai/v1/kling/kling-image-4.0/long-image-generation·ecommerce,webpageGET https://apimaster.ai/v1/kling/kling-image-4.0/tasks/{task_id}
요청 매개변수
| 필드 | 값 |
|---|---|
contents |
JSON · type → prompt, refer_image, element, style_refer_image, subject_refer_image. |
contents[].text |
비어 있지 않은 프롬프트 하나를 넣고 @id로 개별 참조 소재를 지정합니다. |
contents[].id |
요청 안에서 각 참조를 식별하는 고유 ID입니다. |
contents[].url |
공개 이미지 URL 또는 Base64입니다. JPG, JPEG, PNG를 지원하며 장당 30 MB 이하, 양쪽 변 300 px 이상, 비율 2:5–5:2입니다. |
contents[].element_id |
자신의 계정에 있는 이미지 요소의 식별자 또는 지원 프리셋입니다. 참조 한 개로 계산합니다. |
settings.result_type |
single, series. 기본값 single. |
settings.n |
single → 1–9. 기본값 1. |
settings.series_amount |
series → 2–10 / auto (2–10). 기본값 4. |
settings.resolution |
single / series → 2k, 4k, 8k. 기본값 2k. ecommerce / webpage → 1k, 2k. 기본값 1k. |
settings.aspect_ratio |
single / series → auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9. 기본값 auto. |
settings.skill |
long-image-generation → ecommerce, webpage. |
settings.length |
ecommerce → short, medium, long. 기본값 medium. |
options.watermark_info.enabled |
boolean. 기본값 false. true → outputs[].watermark_url. |
options.callback_url |
선택적 웹훅 URL입니다. APIMaster 계정에서 미리 등록하고 검증해야 합니다. |
options.external_task_id |
최대 128바이트의 선택적 연동 ID로 작업과 함께 반환됩니다. |
일반 이미지와 시리즈는 참조 이미지와 요소를 합쳐 최대 10개입니다. 상품 상세에는 refer_image 1–3개가 필요합니다. 웹페이지는 스타일과 피사체 참조를 각각 하나까지 받습니다.
일반 프롬프트는 영어만 50,000자 또는 비영어만 21,000자입니다. 긴 이미지는 각각 166,000자, 71,000자입니다. 혼합 입력은 각 한도에 대한 비율 합계가 1 이하여야 합니다.
단일 모드는 독립 이미지를 생성합니다. 시리즈는 관련 이미지가 순서대로 오며 group_id를 공유합니다. 긴 이미지는 한 번에 완성 이미지 한 장을 반환합니다. length는 상품 상세에만 적용되며 약 2–5, 6–10, 11–18개 구역을 선택합니다.
예제
single
curl -sS "https://apimaster.ai/v1/kling/kling-image-4.0/image-generation" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: kling-image-example-001" \
-d '{"contents":[{"type":"prompt","text":"A blue ceramic cup in soft daylight"}],"settings":{"resolution":"2k","aspect_ratio":"1:1"}}'
series
{
"contents": [
{
"type": "prompt",
"text": "Create two coordinated studio photographs of the blue ceramic cup in @cup. Show a front view and a detail close-up."
},
{
"type": "refer_image",
"id": "cup",
"url": "https://example.com/cup.png"
}
],
"settings": {
"result_type": "series",
"series_amount": 2,
"resolution": "4k",
"aspect_ratio": "3:4"
},
"options": {
"watermark_info": {
"enabled": true
},
"external_task_id": "campaign-cup-001"
}
}
ecommerce
{
"contents": [
{
"type": "prompt",
"text": "Design a product detail page for @cup. Include a hero image, material details, and care instructions."
},
{
"type": "refer_image",
"id": "cup",
"url": "https://example.com/cup.png"
}
],
"settings": {
"skill": "ecommerce",
"length": "short",
"resolution": "1k"
}
}
webpage
{
"contents": [
{
"type": "prompt",
"text": "Design a long product landing page for a ceramic cup collection."
}
],
"settings": {
"skill": "webpage",
"resolution": "2k"
}
}
작업 결과
task_id를 저장하고 같은 계정으로 조회합니다. 성공 시 outputs에 각 이미지 URL과 선택적인 watermark_url, group_id가 있습니다. 실패 시 error를 확인합니다.
curl -sS "https://apimaster.ai/v1/kling/kling-image-4.0/tasks/TASK_ID" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"task_id": "task_example",
"object": "image",
"model": "kling-image-4.0",
"status": "completed",
"outputs": [{"type": "image", "url": "https://example.com/generated.png"}]
}
동일 요청을 재시도할 때 동일한 Idempotency-Key를 사용합니다. 시간이 초과되면 기존 작업을 조회합니다.
요금
전달된 이미지 수에 출력 단가를, 참조 수에 입력 단가를 곱해 합산합니다. 현재 고객 요금은 마켓플레이스에 표시됩니다. Kling Image 4.0
