kling/kling-image-o1의 API 레퍼런스입니다.
빠른 시작
Comfy 워크스페이스에서 키를 생성하고COMFY_API_KEY로 내보내세요. Python 및 TypeScript 스니펫은 Comfy SDK(pip install comfy-sdk, npm install @comfyorg/sdk)를 사용하며, cURL 스니펫은 동일한 호출을 원시 HTTP로 수행합니다.
모델 ID: kling/kling-image-o1
엔드포인트: POST https://api.comfy.org/v2/models/kling/kling-image-o1
- Wait for the result
- Queue and collect later
스키마
입력
string
기본값:"\"auto\""
생성된 이미지의 가로세로 비율(너비:높이)입니다. auto는 입력 콘텐츠에 따라 지능적으로 이미지를 생성합니다.가능한 값:
16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9, autostring (uri)
이 작업 결과에 대한 콜백 알림 주소입니다. 설정하면 작업 상태가 변경될 때 서버가 능동적으로 알림을 보냅니다.형식:
uriobject[]
element ID 구성을 기반으로 한 참조 요소 목록입니다. 참조 요소와 참조 이미지의 합계는 10개를 초과할 수 없습니다.
integer
필수
요소 ID형식:
int64string
사용자 지정 작업 ID입니다. 단일 사용자 계정 내에서 고유해야 합니다.
object[]
참조 이미지 목록입니다. 이미지 Base64 인코딩 또는 이미지 URL(접근 가능해야 함) 입력을 지원합니다. 지원 형식은 .jpg/.jpeg/.png입니다. 파일 크기는 10MB를 초과할 수 없습니다. 너비와 높이 크기는 300px 이상이어야 하며, 가로세로 비율은 1:2.5 ~ 2.5:1 사이여야 합니다. 참조 요소와 참조 이미지의 합계는 10개를 초과할 수 없습니다.
string
필수
이미지 Base64 인코딩 또는 이미지 URL(접근 가능해야 함)
string
모델 이름입니다. Comfy Router를 사용할 때는 이를 생략하거나 null을 전송하세요. 모델은 요청 경로에 의해 선택됩니다. 이름을 제공하는 경우 해당 경로와 일치해야 합니다.
integer
기본값:"1"
생성할 이미지 수입니다. 값 범위 [1,9].범위:
1 ~ 9string
필수
텍스트 프롬프트 단어로, 긍정 및 네거티브 설명을 포함할 수 있습니다. 2,500자를 초과할 수 없습니다. Omni 모델은 요소와 이미지가 포함된 Prompt를 통해 다양한 기능을 구현할 수 있습니다. 이미지는 <<<image_1>>> 형식으로 지정하세요.
string
기본값:"\"1k\""
이미지 생성 해상도입니다. 1k는 1K 표준, 2k는 2K 고해상도, 4k는 4K 고해상도입니다.가능한 값:
1k, 2k, 4kstring
기본값:"\"single\""
단일 이미지를 생성할지 일련의 이미지를 생성할지 제어합니다.가능한 값:
single, seriesinteger
기본값:"4"
시리즈의 이미지 수입니다. 값 범위 [2,9].범위:
2 ~ 9GET /v2/models/kling/kling-image-o1/openapi.json에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다.
출력
integer
오류 코드
object
integer
작업 생성 시간, 밀리초 단위의 Unix 타임스탬프
string
작업의 차감 단위
string
작업 ID
object
string
고객 정의 작업 ID
object
object[]
integer
이미지 번호 (0-9)
string (uri)
생성된 이미지의 URL형식:
uristring
결과가 단일 이미지인지 일련의 이미지인지 여부가능한 값:
single, seriesobject[]
시리즈 이미지 결과 목록
integer
시리즈 이미지 순번
string (uri)
생성된 이미지의 URL형식:
uristring
작업 상태가능한 값:
submitted, processing, succeed, failedstring
작업 상태 정보로, 작업 실패 시 실패 원인(플랫폼의 콘텐츠 위험 제어 트리거 등)을 표시합니다.
integer
작업 업데이트 시간, 밀리초 단위의 Unix 타임스탬프
string
오류 메시지
string
요청 ID
예제
입력
출력
배포 전 확인
SDK는Idempotency-Key를 생성하고 자동 재시도에서 재사용합니다. 수동 재시도 시에는 원래 키를 재사용하세요. Router는 연결을 최대 10분간 유지할 수 있습니다.
요청이 실패하면 Router는 이유를 설명하는 X-Comfy-Error-Type 응답 헤더를 보냅니다. 422는 Router가 프로바이더를 호출하기 전에 입력을 거부했음을 의미합니다. 생성된 에셋은 결과 URL이 만료될 수 있으므로 즉시 다운로드하세요.
헤더
인증, 멱등성, 요청 ID, 오류 분류, 재시도 간격, 지출 한도.
Router API 사용
모델 검색, 유효성 검사 오류, 재시도, 과금.
제한 사항
Router가 현재 지원하지 않는 기능과 대체 방법.