Skip to main content

만들 내용

Kling 텍스트-비디오 작업을 제출하고, 반환된 작업 ID를 저장한 뒤, 해당 Kling 작업 엔드포인트를 폴링하고, 푸시 알림을 위해 언제 callback_url을 추가할지 결정하게 됩니다.

사전 요구 사항

  • COMETAPI_KEY에 저장된 CometAPI API 키
  • requests가 설치된 Python 3.10+ 또는 Node.js 18+
  • 폴링을 위한 서버 측 워커 또는 웹훅용 HTTPS 콜백 엔드포인트

API 키, 기본 URL, 인증

다음으로 Kling 텍스트-비디오 작업을 생성합니다:
다음으로 작업을 폴링합니다:
Bearer 토큰으로 인증합니다:

코드 예제

아래 탭에서 cURL, Python, Node.js용으로 복사 가능한 예제를 사용할 수 있습니다.

흐름 설명

Kling 비디오 생성은 비동기 방식입니다. create 엔드포인트는 data.task_id를 반환합니다. data.task_statussucceed 또는 failed에 도달할 때까지 GET /kling/v1/videos/text2video/<task_id>를 폴링하세요. 작업이 성공하면, 지속적으로 액세스해야 하는 경우 data.task_result의 완료된 asset URL을 자체 스토리지에 복사하세요. 직접 제어하는 HTTPS 엔드포인트로 작업 상태 업데이트를 푸시받고 싶다면 callback_url을 추가하세요. 상태 정합성 확인과 누락된 callback 전달에 대비해 폴링도 계속 사용할 수 있도록 유지하세요.

일반 매개변수

문제 해결 / FAQ

Kling은 data.task_id, data.task_status, data.task_result 같은 provider별 JSON 필드를 사용합니다. OpenAI 호환 /v1/videos 라우트처럼 파싱하지 마세요.
제한된 폴링을 사용하고 작업이 실패하면 data.task_status_msg를 확인하세요. 나중에 진단할 수 있도록 task ID를 저장하세요.
기본 방식으로는 폴링을 사용하세요. 푸시 전달이 필요하면 callback_url을 추가한 뒤, 최종 상태는 폴링으로 정합성을 확인하세요.

다음 단계