Kling 3.0 Turbo

Kling 3.0 Turbo는 Kuaishou Kling 3.0 제품군의 동영상 모델입니다. 요청 한 번으로 프롬프트, 또는 프롬프트와 첫 프레임에서 720p 또는 1080p의 3~15초 사운드 포함 클립을 만듭니다. 요청을 보내고, 반환된 작업 ID를 보관한 뒤, 완성된 동영상을 작업에서 읽어 오세요. 이미지는 URL로 전달합니다.

모델 ID

현재 가격은 모델 페이지에서 확인하세요.

간단한 예제

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3-0-turbo",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

엔드포인트

POST https://api.seedrouter.ai/v1/videos/generations

응답은 완성된 동영상이 아니라 작업({"id": "task_...", "status": "processing"})입니다. 결과는 GET /v1/tasks/{task_id}를 폴링해서 받으세요. API 키는 서버 측 코드에 보관하세요.

파라미터

모든 클립에 사운드가 함께 들어가며, 사운드 설정은 없습니다. 스키마는 엄격합니다. 알 수 없는 필드는 무시되지 않고 거부됩니다. callback_url은 사용할 수 없으니 작업을 폴링하세요.

이미지로 동영상 생성

first_frame_image에 첫 프레임을 넣고, prompt에 다음에 무슨 일이 일어나는지 설명하세요. 클립은 그 프레임으로 시작하며 프레임의 화면 형태를 따르므로 aspect_ratio는 사용되지 않습니다.

{
  "model": "kling-3-0-turbo",
  "prompt": "The subject slowly turns toward the camera, soft natural light, gentle breeze.",
  "first_frame_image": "https://example.com/frame.png",
  "resolution": "1080p",
  "duration": 5
}

미디어 입력

첫 프레임은 공개 HTTP(S) URL입니다. Base64 data URI는 받지 않습니다. 파일을 자체 스토리지에 업로드하고 그 URL을 전달하세요. 10 MB 이하의 JPG 또는 PNG 이미지를 사용하세요.

과금에 영향을 주는 요소

현재 요율은 모델 가격 섹션에서 확인하세요. Kling 3.0 Turbo는 동영상 초 단위로 과금되며, 요율은 해상도로 정해집니다:

cost = duration × rate per second for the resolution

길이는 요청이 접수될 때 확정되므로, 예약된 금액이 곧 과금되는 금액입니다. 최종 과금액은 계정의 사용 내역에서 확인하세요. 실패한 작업은 과금되지 않습니다.

출력 스키마

제출하면 작업이 반환됩니다:

{"id": "task_...", "model": "kling-3-0-turbo", "status": "processing", "created_at": 1789689600}

작업 조회

GET https://api.seedrouter.ai/v1/tasks/{task_id}

status가 completed 또는 failed가 될 때까지 10~20초마다 폴링하세요. 폴링 중 네트워크 타임아웃이 났다고 생성이 실패한 것은 아닙니다. 작업 ID를 보관하고 다시 확인하세요. 진행 상황을 보려고 작업을 새로 만들지 마세요.

완료된 작업

{
  "id": "task_...",
  "model": "kling-3-0-turbo",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689710,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

테스트에서 3초 720p 클립은 MP4(H.264), 1280 × 720으로, 5초 1080p 클립은 1920 × 1080으로 반환되었고, 모두 스테레오 오디오 트랙이 포함되었으며, 제출 후 54초에서 약 5분 20초 사이에 도착했습니다.

오류

작업이 생성되기 전에 거부된 요청은 HTTP 오류와 error 객체를 반환하며 과금되지 않습니다. 접수된 뒤 실패한 작업은 조회 시 HTTP 200과 함께 status: "failed" 및 error 객체를 반환합니다.

코드, HTTP 상태, 재시도 지침은 공통 오류 카탈로그를 참고하세요.

{
  "id": "task_...",
  "model": "kling-3-0-turbo",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

제출 자체가 타임아웃된 경우에는 다시 보내기 전에 작업 목록을 확인하세요. 첫 번째 요청이 이미 접수되었을 수 있습니다.

팁

• 피사체, 장소, 카메라 움직임, 빛을 각각 한 문장으로 설명하세요. "slow push-in", "low angle" 같은 카메라 용어를 따릅니다.
• 720p로 초안을 만든 뒤, 같은 요청으로 최종 샷을 1080p로 렌더링하세요.
• 첫 프레임을 쓸 때는 움직이는 것만 설명하세요. 장면은 프레임이 이미 정합니다.
• 지어낸 표시가 들어가지 않도록 no text, no logos를 추가하세요.

관련 자료

• Kling 3.0 Turbo Playground와 가격
• Kling 3.0 API 레퍼런스
• OpenAPI 다운로드
• 복사 가능한 Markdown