Kling 3.0

Kling 3.0은 Kuaishou의 동영상 생성 모델입니다. 요청 한 번으로 프롬프트, 또는 첫 프레임과 선택형 마지막 프레임에서 3~15초 클립을 만들며, 품질 모드는 세 가지(std, pro, 4K)이고, 요청하면 네이티브 오디오도 생성합니다. 클립은 각자 프롬프트와 길이를 가진 최대 5개 샷의 시퀀스로 만들 수도 있습니다. 요청을 보내고, 반환된 작업 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",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist on the water, slow push-in, no text, no logos.",
    "mode": "pro",
    "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은 사용할 수 없으니 작업을 폴링하세요.

멀티샷 클립

multi_shots를 true로 설정하고 multi_prompt에 각 샷을 설명하세요. 샷 길이를 모두 더하면 3~15초여야 합니다. 그 합계가 클립 길이이며, duration은 사용되지 않습니다. prompt는 생략하거나 모든 샷에 공통된 내용을 쓰는 데 사용할 수 있습니다.

{
  "model": "kling-3-0",
  "mode": "pro",
  "multi_shots": true,
  "multi_prompt": [
    {"prompt": "A red paper boat on a calm pond at sunrise, wide shot", "duration": 3},
    {"prompt": "The boat drifts under a small wooden bridge, low angle", "duration": 3}
  ]
}

엘리먼트

엘리먼트는 모델이 클립 전체에서 일관되게 유지하는 피사체입니다. 인물, 제품, 캐릭터가 여기에 해당합니다. name, 짧은 description, 이미지 2~4장을 지정한 뒤, 프롬프트에서 이름으로 언급하세요(예: @hero).

{
  "model": "kling-3-0",
  "prompt": "@hero slowly turns toward the camera in soft window light",
  "kling_elements": [
    {
      "name": "hero",
      "description": "a young woman with short black hair and a yellow raincoat",
      "element_input_urls": ["https://example.com/hero-front.png", "https://example.com/hero-side.png"]
    }
  ]
}

미디어 입력

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

과금에 영향을 주는 요소

현재 요율은 모델 가격 섹션에서 확인하세요. Kling 3.0은 동영상 초 단위로 과금되며, 요율은 모드와 sound 사용 여부로 정해집니다:

billed seconds = duration                      (single shot)
billed seconds = Σ multi_prompt[].duration     (multi_shots: true)
cost = billed seconds × rate per second

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

출력 스키마

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

{"id": "task_...", "model": "kling-3-0", "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",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689710,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

테스트에서 3초 std 클립은 MP4(H.264), 1280 × 720으로, sound가 켜진 5초 pro 클립은 오디오 트랙과 함께 1920 × 1080으로 반환되었으며, 각각 약 2~3분이 걸렸습니다.

오류

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

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

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

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

팁

• 피사체, 장소, 카메라 움직임, 빛을 각각 한 문장으로 설명하세요. Kling은 "slow push-in", "low angle" 같은 카메라 용어를 따릅니다.
• std로 초안을 만든 뒤, 같은 요청으로 최종 샷을 pro 또는 4K로 렌더링하세요.
• 첫 프레임과 마지막 프레임으로 샷이 시작하고 끝나는 지점을 제어하세요.
• 한 프롬프트에 여러 컷을 설명하지 말고 multi_prompt로 장면을 샷 단위로 나누세요.
• 지어낸 표시가 들어가지 않도록 no text, no logos를 추가하세요.

관련 자료

• Kling 3.0 Playground와 가격
• OpenAPI 다운로드
• 복사 가능한 Markdown