Claude Opus 5.5을(를) SeedRouter에서 사용할 수 있습니다

Image

Kling Image 4.0

View Markdown

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 모드에서는 이미지 210장을 생성하며 기본값은 4입니다. 이미지가 510장인 경우 프롬프트는 최대 20,000자까지 지원하며 모든 참조를 이름으로 언급해야 합니다. 각 참조는 읽을 수 있어야 하며 크기는 20 MB 이하여야 합니다. single 모드에서는 이 필드를 무시하며, 정수 2~10 또는 문자열 auto를 입력할 수 있습니다.
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 스키마를 참조하세요.