kling-2.5-turbo API

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

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

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

프롬프트: One continuous take, no cuts. A night market grill under plastic awnings, skewers over coals. A cook in a lacquer-red jacket fans the fire once and the sparks refuse to die: they climb, gather and turn into a flock of small orange birds that wheels above the stalls and pours down the length of the street. The camera starts tight on the coals, pulls back and rises with the flock over the awnings. One hard warm key from the grill itself, cold blue street beyond. Real weight and inertia, smoke and heat shimmer, no text.

이 샘플을 생성한 요청

{
  "model": "kling-2.5-turbo",
  "prompt": "One continuous take, no cuts. A night market grill under plastic awnings, skewers over coals. A cook in a lacquer-red jacket fans the fire once and the sparks refuse to die: they climb, gather and turn into a flock of small orange birds that wheels above the stalls and pours down the length of the street. The camera starts tight on the coals, pulls back and rises with the flock over the awnings. One hard warm key from the grill itself, cold blue street beyond. Real weight and inertia, smoke and heat shimmer, 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-2.5-turbo",
    "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 Legacy는 text2video / image2video 요청 구조와 함께 model_name을 사용합니다. 모드, 해상도, 오디오 레인에 대해서는 해당 모델의 공식 페이지와 가격 페이지를 확인하세요.

필드	필수	노트
model_name	예	kling-2.5-turbo
prompt	조건부	텍스트-비디오에 필요합니다. 이미지 대 비디오를 위해 이미지와 결합
image	조건부	첫 번째 프레임 이미지 URL 또는 Base64
image_tail	아니요	선택적 최종 프레임 이미지
video_url	조건부	Kling 3.0 모션제어 참고영상
image_list	아니요	Omni/O1 및 다중 모드 워크플로우를 위한 이미지 목록
negative_prompt	아니요	부정적인 프롬프트
mode	아니요	std / pro / 4k (모델에 따라 다름)
duration	아니요	5 / 10（字符串）
multi_shot	아니요	멀티샷 스토리보드 활성화
sound	아니요	지원되는 경우 동기화된 사운드 생성
camera_control	아니요	지원되는 경우 카메라 제어

입출력 제한

Kling 2.5 Turbo는 고정된 5/10초 지속 시간 및 720p/1080p의 Legacy API를 사용합니다. 텍스트-비디오 및 단일 첫 번째 프레임 이미지-비디오를 지원하지만 기본 오디오, 음성, 멀티샷, 모션 브러시 또는 카메라 제어는 지원하지 않습니다.

문서화된 워크플로우 예시

레거시 모델은 작업 흐름에 따라 model_name, 첫 번째/끝 프레임 또는 모션 제어 필드를 선택합니다. 고정 기간 및 오디오 제한은 이 페이지의 표를 따릅니다.

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "kling-2.5-turbo", "prompt": "一只狗在海边奔跑",
    "duration": "5", "mode": "pro", "aspect_ratio": "16:9", "sound": "off"
  }'

오류 및 실패한 작업

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

지원 범위

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

가격 및 청구

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

참고

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