APIMaster.ai

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, series
  • POST https://apimaster.ai/v1/kling/kling-image-4.0/long-image-generation · ecommerce, webpage
  • GET 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