kling-3.0-turbo API

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

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

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

프롬프트: A skateboarder launches a kickflip over a concrete stair set in a skate park at golden hour. Low-angle slow-motion tracking shot, the board spins under his feet, dust and sunlight flare, he lands and rolls past the camera. Realistic physics, cinematic sports film, no text.

이 샘플을 생성한 요청

{
  "model": "kling-3.0-turbo",
  "prompt": "A skateboarder launches a kickflip over a concrete stair set in a skate park at golden hour. Low-angle slow-motion tracking shot, the board spins under his feet, dust and sunlight flare, he lands and rolls past the camera. Realistic physics, cinematic sports film, 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": "kling-3.0-turbo",
    "prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot",
    "settings": {"duration": 5, "resolution": "720p"}
  }'

폴링 및 다운로드

작업 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 3.0 Turbo는 URL 경로에서 모델을 선택합니다. model_name을 본체에 넣지 마십시오. 텍스트-비디오 및 첫 번째 프레임 이미지-비디오는 서로 다른 공식 경로를 사용합니다.

필드	필수	노트
prompt	예	텍스트-비디오 프롬프트; 공식적인 길이 제한을 사용하십시오
contents[]	조건부	이미지-비디오의 경우 prompt 및 first_frame을 포함합니다.
settings.resolution	아니요	720p / 1080p
settings.aspect_ratio	아니요	16:9 / 9:16 / 1:1
settings.duration	아니요	3~15초
options.watermark_info	아니요	워터마크 구성

입출력 제한

텍스트-비디오 및 첫 번째 프레임 이미지-비디오는 각각 prompt 및 contents[]을 사용합니다. 출력은 3~15초 동안 720p 또는 1080p입니다. 멀티샷 프롬프트는 최대 6개의 샷을 지원합니다.

문서화된 워크플로우 예시

터보는 업그레이드된 contents/settings/options 엔벨로프를 사용합니다. 모델 ID는 Modelflare의 model 필드에 유지되며 /v1/videos를 통해 호출이 들어옵니다.

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-turbo",
    "contents": [{"type": "prompt", "text": "列车缓慢驶过雨夜城市"}],
    "settings": {"resolution": "1080p", "aspect_ratio": "16:9", "duration": 5},
    "options": {"watermark_info": {"enabled": false}}
  }'

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-turbo",
    "contents": [{"type": "prompt", "text": "角色转身看向窗外"}, {"type": "first_frame", "url": "https://example.com/first.png"}],
    "settings": {"resolution": "1080p", "duration": 5}
  }'

오류 및 실패한 작업

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

지원 범위

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

가격 및 청구

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

참고

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