문서

API 참조

영구 보관 동영상 견적 받기

POST/v1/video-quotes

retention=persistent이며 견적은 카탈로그 지원 모드와 관리형 프레임을 사용합니다. 스위치가 꺼지면 경로는 즉시 404를 반환합니다. 견적이 만료되거나 가격이 바뀌면 다시 확인하세요.

인증과 권한

현재 GloopAPI 키를 사용하세요. 사용 가능한 모델, 기능과 권한은 해당 카탈로그와 엔드포인트 문서에 따라 달라집니다.

Authorization: Bearer $GLOOP_API_KEY

인증 방식: BearerAuth

요청

요청 본문 · application/json

유형
object
필수 필드
modelprompt
추가 속성
false

요청 본문 필수

  • modestring선택 사항

    persistent에서 필수입니다.

    열거형
    ["text_to_video","image_to_video"]
  • retentionstring선택 사항

    persistent는 영구 보관 작업 공간을 사용하며 생략하면 일반 작업을 생성합니다.

  • quote_idstring선택 사항

    새 persistent 요청은 먼저 video-quotes가 반환한 유효한 견적을 확인해야 합니다.

  • start_frameobject선택 사항

    persistent 이미지-동영상 생성에 필수인 동일 키 소유의 관리형 파일입니다. 텍스트-동영상 생성에는 금지됩니다.

    start_frame 하위 필드(1)
    • file_idstring필수

      동일 계정/키의 관리형 파일 공개 ID입니다.

    allOf 분기 1

    유형: object

    이 분기의 필수 항목: file_id

    • file_idstring필수

      동일 계정/키의 관리형 파일 공개 ID입니다.

  • end_frameobject선택 사항

    persistent의 선택적 마지막 프레임이며 해당 기능이 지원해야 합니다.

    end_frame 하위 필드(1)
    • file_idstring필수

      동일 계정/키의 관리형 파일 공개 ID입니다.

    allOf 분기 1

    유형: object

    이 분기의 필수 항목: file_id

    • file_idstring필수

      동일 계정/키의 관리형 파일 공개 ID입니다.

  • webhook_endpoint_idstring선택 사항

    일반 작업은 콘솔에 설정된 수신자를 참조할 수 있으며 persistent에서는 금지됩니다.

  • modelstring필수

    현재 키의 카탈로그에 있는 공개 모델 ID이며 과거 서비스 모델이 계속 사용 가능하다고 보장하지 않습니다.

  • promptstring필수

    생성 프롬프트입니다.

    최소 길이
    1
    최대 길이
    2500
  • durationinteger선택 사항

    모델별 초 단위 길이입니다. video-models mode.presets의 완전한 조합을 사용하고 데카르트 곱을 만들지 마세요. Wan Turbo는 이 필드를 지원하지 않으며 공통 기본값은 없습니다.

  • image_urlstring선택 사항

    일반 작업 전용인 모델별 공개 HTTPS 첫 프레임이며 persistent에서는 금지됩니다.

  • end_image_urlstring선택 사항

    일반 작업 전용인 모델별 공개 HTTPS 마지막 프레임이며 persistent에서는 금지됩니다.

  • resolutionstring선택 사항

    모델 프리셋의 해상도 값입니다.

  • aspect_ratiostring선택 사항

    모델 프리셋의 화면비 값입니다.

  • generate_audioboolean선택 사항null 허용

    모델에 따라 다르므로 모드의 오디오 정책과 프리셋을 사용하세요. 모든 모델이 오디오를 생성한다고 가정하지 마세요.

응답과 오류

HTTP 200

영구 보관 동영상 견적 조회 성공

application/json

유형
object
필수 필드
idexpires_atrequest_hashpricing_kindcurrencyreserved_quotareserved_amountestimated_final_amountsettlement_note
  • idstring필수

    해당 상세 경로에 사용하는 이 객체의 공개 식별자입니다.

  • expires_atinteger필수

    Unix 초 단위 만료 시각이며 0은 고정 만료 시각이 없음을 뜻합니다.

  • request_hashstring필수

    견적과 생성을 연결하는 정규화된 요청 다이제스트이며 멱등 요청 키가 아닙니다.

  • pricing_kindstring필수

    이 견적에 실제로 적용한 가격 산정 방식입니다.

  • currencystring필수

    견적/요금 통화입니다.

  • reserved_quotainteger필수

    플랫폼 할당량 단위의 예약량이며 USD 금액이 아닙니다.

  • reserved_amountstring필수

    견적 통화 단위의 최대 예약액 문자열입니다.

  • estimated_final_amountstring필수null 허용

    예상 최종 금액 문자열이며 null은 생성 전에 확정할 수 없음을 뜻합니다.

  • settlement_notestring필수

    실제 사용량 측정과 정산 설명입니다.

HTTP 400

요청 필드 또는 매개변수가 유효하지 않습니다.

application/json

유형
object
필수 필드
error

HTTP 401

키가 없거나 유효하지 않거나 만료 또는 폐기되었습니다.

application/json

유형
object
필수 필드
error

HTTP 403

IP, 계정, 모델 또는 도구 권한이 부족합니다.

application/json

유형
object
필수 필드
error

HTTP 404

객체/기능을 사용할 수 없거나 기능 스위치가 비활성화되었습니다.

application/json

유형
object
필수 필드
error

HTTP 409

멱등성/견적 충돌, 준비되지 않은 객체 또는 여전히 참조 중인 상태입니다.

application/json

유형
object
필수 필드
error

HTTP 429

요청/대기열 속도 제한입니다.

application/json

유형
object
필수 필드
error

HTTP 500

내부 인증 또는 데이터 저장 오류입니다.

application/json

유형
object
필수 필드
error

HTTP 503

서비스, 가격 또는 스토리지를 사용할 수 없습니다.

application/json

유형
object
필수 필드
error

엔드포인트 참고 사항

이 매개변수는 완전한 프리셋의 설명용 값입니다. 현재 키의 video-models 카탈로그에서 선택한 model/mode의 전체 preset(duration, resolution, aspect_ratio, generate_audio)을 복사하세요. 모델만 바꾸거나 프리셋을 섞지 마세요.

개발할 준비가 되셨나요? 열기: 콘솔 API 키를 생성하거나 살펴보기: 기능.