kling-3.0 API

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

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

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

프롬프트: Stop-motion claymation style: a small orange clay fox sneaks through a miniature felt forest, pauses, sniffs a glowing mushroom and jumps back in surprise. Handmade textures, visible fingerprints on the clay, soft tabletop lighting, charming and playful, no text.

이 샘플을 생성한 요청

{
  "model": "kling-3.0",
  "prompt": "Stop-motion claymation style: a small orange clay fox sneaks through a miniature felt forest, pauses, sniffs a glowing mushroom and jumps back in surprise. Handmade textures, visible fingerprints on the clay, soft tabletop lighting, charming and playful, 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-3.0",
    "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-3.0
prompt	조건부	텍스트-비디오에 필요합니다. 이미지 대 비디오를 위해 이미지와 결합
image	조건부	첫 번째 프레임 이미지 URL 또는 Base64
image_tail	아니요	선택적 최종 프레임 이미지
video_url	조건부	Kling 3.0 모션제어 참고영상
image_list	아니요	Omni/O1 및 다중 모드 워크플로우를 위한 이미지 목록
negative_prompt	아니요	부정적인 프롬프트
mode	아니요	std / pro / 4k (모델에 따라 다름)
duration	아니요	3~15초(문자열)
multi_shot	아니요	멀티샷 스토리보드 활성화
sound	아니요	지원되는 경우 동기화된 사운드 생성
camera_control	아니요	지원되는 경우 카메라 제어

입출력 제한

Kling Legacy는 model_name 사용을 요청합니다. mode, duration, image / image_tail, sound, camera_control의 사용 가능 여부는 모델에 따라 다릅니다. 최소 청구 가능 시간(초) 및 해결 방법은 가격 책정 페이지의 모델별 행을 따릅니다.

문서화된 워크플로우 예시

레거시 모델은 작업 흐름에 따라 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-3.0", "prompt": "转移动作并保持人物身份",
    "image": "https://example.com/character.png",
    "video_url": "https://example.com/motion.mp4",
    "duration": "5", "mode": "std"
  }'

오류 및 실패한 작업

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

지원 범위

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

가격 및 청구

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

참고

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