Kling 3.0 API

사용자 앱에 BetterToken 동영상 API를 연동하세요.
BETTERTOKEN_API_KEY는 환경 변수에서만 읽으세요. 코드에 넣거나 로그에 기록하거나 분석 서비스에 보내지 마세요.
기본 URL: https://bettertoken.ai/v1
모델: kling-3.0.
프롬프트: A rainy city street at night, slow forward camera move
아래 요청 JSON을 그대로 사용하고 선택한 모델의 지원 필드와 한도를 따르세요.
같은 요청으로 POST /videos/quote를 호출하면 잔액 예약 없이 예상 비용을 확인할 수 있습니다. 인증이 필요하며 공개 가격 엔드포인트가 아닙니다.
POST /videos 전에 새 Idempotency-Key와 정확한 요청 본문을 프로세스 밖에 영구 저장하세요. 재시작 후 저장 상태를 불러오거나 접수된 작업의 저장된 ID로 이어서 처리하세요. 응답이 불확실하면 같은 키와 본문을 재사용하세요. 타임아웃만으로 새 유료 작업을 만들지 마세요.
/videos에서 202로 접수되면(호환 경로는 200) id를 저장하고 5초마다 GET /videos/{id}를 조회하세요. queued, in_progress, completed, failed, canceled를 처리하세요. 전송 결과가 불확실한 작업은 stage=reconciliation인 in_progress 상태로 유지됩니다. 대체 작업을 만들지 마세요. 429에서는 Retry-After를 따르세요. 5초 간격으로 최대 360회 조회하며 네트워크 지연과 제한 대기로 전체 시간이 늘어날 수 있습니다. 조회를 멈출 때도 ID를 보관하세요. 조회 중단은 작업 취소나 재생성이 아닙니다.
completed 후 소유자의 허용된 API 키로 GET /videos/{id}/content를 요청하세요. 만료된 파일은 410 video_artifact_expired를 반환합니다. 콘텐츠는 비공개입니다. 다운로드 실패나 만료는 생성 실패와 별도로 처리하세요.
최종 청구는 결제 내역에서 확인하세요. 생성 실패나 취소가 확인되면 재무 처리를 통해 원래 자금 출처로 예약금이 해제되거나 반환됩니다. 작업 상태만으로 환불 완료를 판단할 수 없습니다. 전송 결과 불명과 생성 후 전달 문제도 별도로 처리하세요.
relay 오류는 error에 있습니다. 402 video_insufficient_balance, 409 video_idempotency_conflict/video_acceptance_pending, 422는 잘못된 매개변수, 503은 접수 불확실 또는 이용 불가입니다. 응답이 불확실하면 원래 키와 본문을 유지하세요. 웹 구독이나 페이지 내 생성 UI를 추가하지 마세요.

{
  "model": "kling-3.0",
  "operation": "text_to_video",
  "prompt": "A rainy city street at night, slow forward camera move",
  "duration": {
    "mode": "fixed",
    "seconds": 5
  },
  "output": {
    "format": "mp4",
    "aspect_ratio": "16:9"
  },
  "provider_options": {
    "kling": {
      "mode": "std"
    }
  },
  "audio": {
    "mode": "off"
  }
}