만들 내용
Kling 텍스트-비디오 작업을 제출하고, 반환된 작업 ID를 저장한 뒤, 해당 Kling 작업 엔드포인트를 폴링하고, 푸시 알림을 위해 언제callback_url을 추가할지 결정하게 됩니다.
사전 요구 사항
COMETAPI_KEY에 저장된 CometAPI API 키requests가 설치된 Python 3.10+ 또는 Node.js 18+- 폴링을 위한 서버 측 워커 또는 웹훅용 HTTPS 콜백 엔드포인트
API 키, 기본 URL, 인증
다음으로 Kling 텍스트-비디오 작업을 생성합니다:코드 예제
아래 탭에서 cURL, Python, Node.js용으로 복사 가능한 예제를 사용할 수 있습니다.흐름 설명
Kling 비디오 생성은 비동기 방식입니다. create 엔드포인트는data.task_id를 반환합니다. data.task_status가 succeed 또는 failed에 도달할 때까지 GET /kling/v1/videos/text2video/<task_id>를 폴링하세요. 작업이 성공하면, 지속적으로 액세스해야 하는 경우 data.task_result의 완료된 asset URL을 자체 스토리지에 복사하세요.
직접 제어하는 HTTPS 엔드포인트로 작업 상태 업데이트를 푸시받고 싶다면 callback_url을 추가하세요. 상태 정합성 확인과 누락된 callback 전달에 대비해 폴링도 계속 사용할 수 있도록 유지하세요.
일반 매개변수
문제 해결 / FAQ
응답 형태가 OpenAI 비디오 라우트와 다릅니다
응답 형태가 OpenAI 비디오 라우트와 다릅니다
Kling은
data.task_id, data.task_status, data.task_result 같은 provider별 JSON 필드를 사용합니다. OpenAI 호환 /v1/videos 라우트처럼 파싱하지 마세요.작업이 succeed 상태에 도달하지 않습니다
작업이 succeed 상태에 도달하지 않습니다
제한된 폴링을 사용하고 작업이 실패하면
data.task_status_msg를 확인하세요. 나중에 진단할 수 있도록 task ID를 저장하세요.callback_url과 폴링 중 무엇을 사용해야 하나요
callback_url과 폴링 중 무엇을 사용해야 하나요
기본 방식으로는 폴링을 사용하세요. 푸시 전달이 필요하면
callback_url을 추가한 뒤, 최종 상태는 폴링으로 정합성을 확인하세요.다음 단계
- Kling text-to-video API reference를 읽어보세요.
- Get a Kling task로 폴링하세요.
- Use Kling callback URLs로 callback을 설정하세요.
- Models에서 Kling 비디오 모델을 찾아보세요.
- Use polling and webhooks for video generation을 검토하세요.
- Estimate request cost before calling a model로 작업 비용을 추정하세요.