Kling v4 Flash 동영상 생성 | ToAPIs Documentation

POST

/v1/videos/generations

세 입력 모드는 모두 kling-4.0-flash 를 사용합니다. 전달한 미디어에 따라 생성 경로를 선택합니다. 비동기 API 이므로 제출 후 플랫폼 작업 ID 로 결과를 조회합니다.

플랫폼 API 키를 사용합니다. 중국 본토에서는 https://toapis.com 을 https://toapis.cn 으로 바꿀 수 있습니다. 사용 가능 여부는 배포된 채널 설정과 계정 권한에 따라 달라집니다.

입력 모드

모드	요청 내용
텍스트 동영상	프롬프트와 출력 사양만 전달하고 미디어는 생략합니다.
참조 미디어	`image_urls` / `video_urls` 또는 reference 역할의 미디어를 사용합니다. 이미지와 동영상을 함께 사용할 수 있습니다.
첫 프레임	`image_with_roles` 에 `first_frame` 이미지 1 장만 명시합니다. 참조 이미지나 동영상을 함께 전달할 수 없고, 중간/마지막 프레임은 지원하지 않습니다.

요청 매개변수

Authorizationstring헤더필수

Bearer YOUR_API_KEY 로 인증합니다.

modelstring본문필수

항상 kling-4.0-flash. 모드에 따라 모델 ID 를 바꾸지 않습니다.

promptstring본문필수

필수, 공백만 입력할 수 없으며 최대 8000 Unicode 문자. 주제, 동작, 카메라 및 미디어 관계를 설명합니다.

durationinteger본문기본값: 5

3-20 초의 정수. 기본값은 5.

resolutionstring본문기본값: 720p

720p 만 지원합니다. 기본값은 720p.

aspect_ratiostring본문

auto, 16:9, 9:16, 1:1, 21:9. 생략하면 업스트림 기본값을 유지합니다. 자동 비율은 auto 를 명시할 수 있습니다.

image_urlsstring[]본문

참조 이미지 URL 배열, 최대 10 장. 위치로 첫 프레임을 추론하지 않습니다. reference 이미지 역할과 합산하므로 같은 미디어를 중복 전달하지 않습니다.

video_urlsstring[]본문

참조 동영상 URL 배열. video_with_roles 와 합쳐 최대 5 개.

image_with_rolesobject[]본문

각 객체는 url 과 role 을 가집니다. reference / reference_image 는 참조 이미지, first_frame 은 첫 프레임입니다. keyframe 과 last_frame 은 지원하지 않습니다.

video_with_rolesobject[]본문

각 객체는 url 과 role 을 가집니다. reference / reference_video 를 지원합니다.

metadataobject본문

불리언 keep_original_sound 로 참조 동영상 원음을 보존합니다. 예: {"keep_original_sound": true}. 참조 동영상에만 사용합니다. 첫 프레임 모드에서는 false 여도 이 키를 전달할 수 없습니다.

client_business_idstring본문

선택적 고객 업무 ID. 작업과 함께 저장되며 같은 조회 API 에서 사용할 수 있습니다.

미디어 규칙과 검증

공개 접근 가능한 HTTP(S) URL 을 사용하고 사용자 이름이나 암호를 넣지 않습니다. 로컬 파일은 이미지 업로드 또는 동영상 업로드로 URL 을 얻습니다. 로컬 경로나 base64 를 보내지 않습니다.
참조 모드는 이미지 10 장과 동영상 5 개까지 지원합니다. 일반 배열과 명시적 reference 역할은 합산하므로 같은 미디어를 중복 제출하지 않습니다.
첫 프레임 모드는 first_frame 이미지 1 장만 받으며 keyframe 과 last_frame 역할은 거부됩니다. 첫 프레임은 역할로 정하고 일반 이미지 위치로 추론하지 않습니다.
첫 프레임과 참조 미디어는 함께 사용할 수 없습니다. 기존 Kling mode, audio, video_list 또는 Omni 참조 구조를 사용하지 않습니다. audio_with_roles, metadata.elements, metadata.voices 는 지원하지 않습니다.
잘못된 사양, 역할, URL, 개수 또는 모드 조합은 거부됩니다. 오류를 수정한 뒤 다시 제출합니다. 파일 크기, 코덱, 입력 동영상 길이 상한은 이 페이지에서 보장하지 않으며 업로드 서비스와 업스트림 요구 사항도 충족해야 합니다.

요청 예제

텍스트 동영상

{
  "model": "kling-4.0-flash",
  "prompt": "석양 아래 해안에 부딪히는 파도, 천천히 전진하는 카메라",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}

참조 미디어

{
  "model": "kling-4.0-flash",
  "prompt": "참조 이미지 인물 외형을 유지하고 참조 동영상 카메라 움직임을 사용",
  "duration": 10,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "image_urls": [
    "https://example.com/character.png"
  ],
  "video_urls": [
    "https://example.com/motion.mp4"
  ],
  "metadata": {
    "keep_original_sound": true
  }
}

첫 프레임

{
  "model": "kling-4.0-flash",
  "prompt": "첫 프레임을 시작으로 인물이 천천히 창밖으로 몸을 돌림",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "image_with_roles": [
    {
      "url": "https://example.com/first.png",
      "role": "first_frame"
    }
  ]
}

작업 제출

요청 예시

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "kling-4.0-flash",
  "prompt": "석양 아래 해안에 부딪히는 파도, 천천히 전진하는 카메라",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}'

응답 예시

{
  "id": "task_example",
  "object": "generation.task",
  "model": "kling-4.0-flash",
  "status": "queued",
  "created_at": 1792713600
}

작업 조회와 과금

응답의 id 는 플랫폼 작업 ID 입니다. 공급자 task_id 대신 아래 API 로 조회합니다. 상태는 queued, in_progress, completed, failed. 동영상 작업 상태와 작업 Webhook을 참조하세요.

curl --request GET \
  --url https://toapis.com/v1/videos/generations/YOUR_TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY'

기본값은 5 초 / 720p 이며 명시적으로 사양을 지정할 수 있습니다. 고정 가격이나 기존 Sound 과금과의 동일성을 보장하지 않습니다. 실제 과금은 계정 견적 및 작업 usage / billing 을 따릅니다.