API 참조

동영상 작업 공간 기능 조회

GET/v1/video-models

모드별 실행 가능 프리셋과 프레임 제약을 반환합니다. 완전한 프리셋만 사용하고 모드 간 매개변수를 섞지 마세요.

인증과 권한

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

Authorization: Bearer $GLOOP_API_KEY

인증 방식: BearerAuth

응답과 오류

HTTP 200

동영상 작업 공간 기능 조회 성공

application/json

유형: object
필수 필드: dataworkspace_enabledupload_enabledfile_storage_enabled

dataarray필수
현재 페이지/카탈로그의 데이터 배열입니다.
data 하위 필드(1)
- []object선택 사항
  [] 하위 필드(6)
  - idstring필수
    해당 상세 경로에 사용하는 이 객체의 공개 식별자입니다.
  - namestring필수
    사람이 읽을 수 있는 이름입니다.
  - capability_versionstring필수
    이 공개 모델의 기능 버전입니다.
  - modesarray필수
    이 모델에서 실행 가능한 모드와 각 모드의 완전한 매개변수 조합입니다.
    
    modes 하위 필드(1)
    []object선택 사항
    [] 하위 필드(9)
    modestring필수
    실행 모드입니다.
    
    presetsarray필수
    실행 가능한 완전한 매개변수 조합입니다. 조합 사이의 데카르트 곱을 만들지 마세요.
    
    presets 하위 필드(1)
    []object선택 사항
    [] 하위 필드(4)
    durationinteger선택 사항null 허용
    모델 프리셋의 초 단위 길이입니다.
    
    resolutionstring선택 사항
    모델 프리셋의 해상도 값입니다.
    
    aspect_ratiostring선택 사항
    모델 프리셋의 화면비 값입니다.
    
    generate_audioboolean선택 사항null 허용
    이 모델 프리셋의 오디오 생성 여부입니다.
    
    audio_policystring필수
    현재 모드의 오디오 필드 정책입니다.
    
    aspect_policystring필수
    현재 모드의 화면비 필드 정책입니다.
    
    duration_policystring필수
    현재 모드의 길이 필드 정책입니다.
    
    prompt_max_charsinteger필수
    현재 모드에서 프롬프트에 허용되는 최대 Unicode 문자 수입니다.
    
    start_frameobject선택 사항
    현재 모드의 첫 프레임 제약입니다.
    
    start_frame 하위 필드(5)
    requiredboolean필수
    이 모드에서 해당 프레임이 필수인지 여부입니다.
    
    max_bytesinteger필수
    이 프레임에 허용되는 바이트 단위 최대 파일 크기입니다.
    
    max_pixelsinteger필수
    이 프레임에 허용되는 최대 총 픽셀 수입니다.
    
    max_edgeinteger필수
    이 프레임의 각 변에 허용되는 최대 픽셀 수입니다.
    
    content_typesarray필수
    이 프레임에 허용되는 이미지 MIME 유형입니다.
    
    content_types 하위 필드(1)
    []string선택 사항
    allOf 분기 1
    유형: object
    이 분기의 필수 항목: required, max_bytes, max_pixels, max_edge, content_types
    requiredboolean필수
    이 모드에서 해당 프레임이 필수인지 여부입니다.
    
    max_bytesinteger필수
    이 프레임에 허용되는 바이트 단위 최대 파일 크기입니다.
    
    max_pixelsinteger필수
    이 프레임에 허용되는 최대 총 픽셀 수입니다.
    
    max_edgeinteger필수
    이 프레임의 각 변에 허용되는 최대 픽셀 수입니다.
    
    content_typesarray필수
    이 프레임에 허용되는 이미지 MIME 유형입니다.
    
    content_types 하위 필드(1)
    []string선택 사항
    end_frameobject선택 사항
    현재 모드의 마지막 프레임 제약입니다.
    
    end_frame 하위 필드(5)
    requiredboolean필수
    이 모드에서 해당 프레임이 필수인지 여부입니다.
    
    max_bytesinteger필수
    이 프레임에 허용되는 바이트 단위 최대 파일 크기입니다.
    
    max_pixelsinteger필수
    이 프레임에 허용되는 최대 총 픽셀 수입니다.
    
    max_edgeinteger필수
    이 프레임의 각 변에 허용되는 최대 픽셀 수입니다.
    
    content_typesarray필수
    이 프레임에 허용되는 이미지 MIME 유형입니다.
    
    content_types 하위 필드(1)
    []string선택 사항
    allOf 분기 1
    유형: object
    이 분기의 필수 항목: required, max_bytes, max_pixels, max_edge, content_types
    requiredboolean필수
    이 모드에서 해당 프레임이 필수인지 여부입니다.
    
    max_bytesinteger필수
    이 프레임에 허용되는 바이트 단위 최대 파일 크기입니다.
    
    max_pixelsinteger필수
    이 프레임에 허용되는 최대 총 픽셀 수입니다.
    
    max_edgeinteger필수
    이 프레임의 각 변에 허용되는 최대 픽셀 수입니다.
    
    content_typesarray필수
    이 프레임에 허용되는 이미지 MIME 유형입니다.
    
    content_types 하위 필드(1)
    []string선택 사항
    cancel_policystring선택 사항
    취소 기능 정책입니다. 취소를 요청해도 완료나 환불은 보장되지 않습니다.
  - cancel_policystring필수
    취소 기능 정책입니다. 취소를 요청해도 완료나 환불은 보장되지 않습니다.
  - pricing_kindsarray필수
    이 모델이 허용하는 가격 산정 방식입니다.
    
    pricing_kinds 하위 필드(1)
    []string선택 사항
workspace_enabledboolean필수
현재 작업 공간의 새 작업 활성화 여부이며 과거 객체가 삭제되었다는 뜻은 아닙니다.
upload_enabledboolean필수
서비스의 참조 이미지 업로드 활성화 여부입니다.
file_storage_enabledboolean필수
서비스의 관리형 파일 저장 활성화 여부입니다.

HTTP 400

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

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 401

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

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 403

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

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 404

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

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 409

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

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 429

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

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 500

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

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 503

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

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항