Image
Kling Image 4.0
Kling Image 4.0으로 2K 또는 4K 이미지를 생성하세요. 이름이 지정된 참조 사진을 사용해 단일 이미지 변형이나 서로 연결된 시리즈를 만들고, 완성된 이미지 URL을 확인하세요.
POST /v1/images/generations에 모델 ID kling-image-4-0을 포함한 JSON 요청을 전송하세요. 반환된 작업 ID를 저장하세요. 같은 엔드포인트에서 텍스트만 포함된 브리프와 참조 이미지 기반 브리프를 모두 사용할 수 있습니다.
빠른 예시
이 요청은 정사각형 2K 이미지 한 장을 생성합니다. API 키를 환경 변수 SEEDROUTER_API_KEY에 저장하세요.
curl https://api.seedrouter.ai/v1/images/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "kling-image-4-0",
"contents": [
{"type": "prompt", "text": "Photograph an amber glass teapot on blue slate, lit through its handle by the morning sun."}
],
"settings": {"resolution": "2k", "aspect_ratio": "1:1"}
}'엔드포인트 및 헤더
POST https://api.seedrouter.ai/v1/images/generations 엔드포인트로 Content-Type: application/json과 Authorization: Bearer YOUR_API_KEY를 포함한 JSON을 전송합니다. 키는 서버에 보관합니다.
매개변수
| 필드 | 유형 | 값 및 기본값 |
|---|---|---|
model | 문자열, 필수 | kling-image-4-0 |
contents | 배열, 필수 | 프롬프트 하나와 참조 이미지 0~10장입니다. |
contents[].type | 문자열, 필수 | prompt 또는 refer_image. |
contents[].text | 문자열 | 프롬프트에 필수입니다. 영어는 최대 50,000자, 영어 외 언어는 최대 21,000자입니다. 여러 언어를 섞어 쓸 경우 각 언어별 글자 수를 해당 한도로 나눈 비율의 합이 1을 넘지 않아야 합니다. |
contents[].url | 문자열 | 각 참조 이미지에 필수입니다. JPEG 또는 PNG 형식의 30MB 이하 이미지에 접근 가능한 HTTP(S) URL을 사용하세요. 가로와 세로가 각각 300픽셀 이상이어야 하며, 가로세로 비율은 2:5~5:2여야 합니다. |
contents[].id | 문자열 | 참조 이미지에 선택적으로 지정할 수 있는 고유 이름입니다. 프롬프트에서 이름을 @name 형식으로 언급하세요. |
settings.result_type | 문자열 | 독립된 이미지를 생성하려면 single(기본값), 서로 연관된 이미지를 생성하려면 series를 사용하세요. |
settings.n | 정수 | 독립 이미지 1~9장입니다. 기본값은 1입니다. single 모드에서만 사용합니다. |
settings.series_amount | 정수 또는 문자열 | series 모드에서는 이미지 2auto를 입력할 수 있습니다. |
settings.resolution | 문자열 | 2k(기본값) 또는 4k입니다. |
settings.aspect_ratio | 문자열 | auto(기본값), 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 또는 21:9입니다. |
options.watermark_info.enabled | 불리언 | 선택 사항입니다. false만 지원합니다. |
참조 사진을 활용한 시리즈
예시 URL을 제품 사진의 공개 URL로 바꾸세요. 이 예시는 서로 연결된 이미지 세 장을 요청합니다. 각 프레임에 대한 지시 사항을 하나의 프롬프트에 작성하세요.
{
"model": "kling-image-4-0",
"contents": [
{"type": "refer_image", "url": "https://example.com/lamp.jpg", "id": "lamp"},
{"type": "prompt", "text": "Three shots of @lamp in the same studio. Start with a wide view of the workbench, move to the brass shade, then finish on the warm reflection of the bulb in the desk."}
],
"settings": {"result_type": "series", "series_amount": 3, "resolution": "4k", "aspect_ratio": "3:2"}
}모든 이미지 가져오기
POST 응답의 id를 TASK_ID에 복사하세요. 작업 상태가 completed 또는 failed가 될 때까지 같은 키로 이 엔드포인트를 호출하세요.
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"작업이 완료되면 output.data[].url의 URL을 모두 확인하세요. 작업 하나에서 여러 이미지가 반환될 수 있습니다. 상태 확인이 중단되면 원래 ID로 다시 조회하세요. 작업 진행 과정은 작업 참조 문서, 오류 코드는 오류 목록을 참조하세요.
요금
총 요금은 요청한 해상도로 생성된 이미지 수에 현재 이미지당 요금을 곱한 금액에 입력한 참조 이미지당 요금을 더한 금액입니다. 참조 이미지 두 장과 4K 이미지 네 장을 생성하면 4K 이미지 생성 요금 네 건과 참조 이미지 요금 두 건이 부과됩니다. 요청이 실패하면 요금이 부과되지 않습니다. 현재 요금을 참조하세요.
오류 및 팁
잘못된 입력은 요청 오류를 반환합니다. 프롬프트 누락, 중복된 참조 ID, 지원하지 않는 해상도 또는 series 설정이 있는지 확인하세요. 처음 호출했을 때 작업 ID가 반환됐다면, 새로 요청하기 전에 해당 ID의 상태를 조회하세요.
여러 참조 이미지를 사용하는 브리프에서는 대상마다 서로 다른 이름을 지정하고, 각 참조 이미지에서 어떤 시각적 특징을 가져올지 모델에 알려주세요. 카메라 지시 사항과 샷 순서는 프롬프트에 작성하세요. Kling Image 4.0 플레이그라운드와 OpenAPI 스키마를 참조하세요.
