kling-o1 API

정확한 모델 ID kling-o1를 사용하세요. 모델 필드는 이 페이지와 정확히 일치해야 합니다.

샘플 출력kling-o1POST /v1/videos5.0s

매개변수: duration=5resolution=1080pratio=16:9

프롬프트: One continuous take, no cuts. A long subway escalator at night, tiled tunnel, nobody else on it. A figure in an oversized violet coat rides down with one hand on the rail; where the hand passes, the handrail stops being rubber and becomes a running river of liquid mercury that keeps flowing down both sides and pools at the bottom of the shaft, throwing the tunnel lights back as broken silver. The camera descends ahead of the figure, facing back up the escalator, and tilts down as the mercury reaches the floor. One hard cold key from the tunnel strip lights, a warm amber glow rising from the pool. Real weight and inertia, metal surface tension, no text.

이 샘플을 생성한 요청

{
  "model": "kling-o1",
  "prompt": "One continuous take, no cuts. A long subway escalator at night, tiled tunnel, nobody else on it. A figure in an oversized violet coat rides down with one hand on the rail; where the hand passes, the handrail stops being rubber and becomes a running river of liquid mercury that keeps flowing down both sides and pools at the bottom of the shaft, throwing the tunnel lights back as broken silver. The camera descends ahead of the figure, facing back up the escalator, and tilts down as the mercury reaches the floor. One hard cold key from the tunnel strip lights, a warm amber glow rising from the pool. Real weight and inertia, metal surface tension, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

인증 및 엔드포인트

https://modelflare.dev/v1과 함께 Modelflare API 키를 사용합니다. 게이트웨이 진입점은 POST /v1/videos입니다.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

작업 생성

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "kling-o1",
    "prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot",
    "duration": "5", "mode": "std"
  }'

폴링 및 다운로드

작업 ID를 저장합니다. GET /v1/videos/{task_id}을 폴링하고 GET /v1/videos/{task_id}/content로 다운로드합니다. 결과 URL은 만료될 수 있으므로 즉시 파일을 전송하세요.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

요청 메모

Kling은 제품군별 model_name, prompt, mode, duration, image_list 또는 contents / settings 필드를 사용합니다. 기본 JSON은 보존되고 전달됩니다.

요청 매개변수

Kling Omni/O1은 model_name, prompt 및 미디어 목록을 사용합니다. image_list, video_list, element_list, multi_shot, sound를 조합할 때는 각 모델의 공식 제약 조건을 따르세요.

필드	필수	노트
model_name	예	kling-o1
prompt	조건부	멀티샷 비활성화 시 필요
mode	아니요	std / pro
aspect_ratio	조건부	16:9 / 9:16 / 1:1
duration	아니요	3~15초(문자열)
image_list	아니요	첫 번째/끝 프레임, 장면 또는 스타일 참조; Omni/O1은 모델 제한 내에서 여러 항목을 허용합니다.
video_list	아니요	영상 편집 또는 스타일 참고
element_list	아니요	Kling 요소 ID; 이 통합은 요소 관리를 제공하지 않습니다
multi_shot	아니요	멀티샷 스토리보드 활성화
sound	아니요	동기화된 사운드 생성 여부

입출력 제한

O1은 720p/1080p, 3~10초 및 이미지/비디오/요소 참조를 지원합니다. video_list이 존재할 때 sound을 꺼지게 설정하십시오. 4K 및 멀티샷은 지원되지 않습니다.

문서화된 워크플로우 예시

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "kling-o1",
    "prompt": "让图 1 中的人物在雨中向镜头挥手",
    "image_list": [{"image_url": "https://example.com/character.png"}],
    "duration": "5", "mode": "pro", "aspect_ratio": "16:9", "sound": "off"
  }'

참조 동영상, 요소 및 멀티샷 조합은 이 페이지의 제한 사항을 따라야 합니다. 참조 비디오가 있으면 sound을 끄십시오.

오류 및 실패한 작업

잘못된 모델 매개변수는 요청 ID와 함께 4xx를 반환합니다. 비동기 작업은 생성이 성공한 후 실패 상태로 들어갈 수도 있습니다. 최종 작업 사유로 폴 응답의 error_code 및 error_message을 사용합니다. 다른 JSON 형태로 동일한 요청을 재시도하지 마세요.

지원 범위

이 페이지에서는 Modelflare 모델 생성 및 편집 호출을 다룹니다. 검색 또는 지도 강화, 음성 관리 및 요소 라이브러리 관리는 이 공개 모델 호출 표면 외부의 리소스 API이며 필수 요청 필드가 아닙니다.

가격 및 청구

이 모델은 초당 비디오 과금을 사용합니다. 현재 고객 가격, 참조 정가 및 전체 사양은 모델 가격 페이지를 참조하세요.

참고

이 페이지는 Modelflare의 공개 인터페이스를 문서화합니다. 여기에 표시된 필드와 한도는 현재 계약입니다.