인증

공개 API는 애플리케이션 자체의 GloopAPI 키를 사용합니다. 키는 서버나 안전한 로컬 환경 변수에 보관하고 웹 페이지, 저장소, 공유 링크 또는 로그에 넣지 마세요.

요청 식별 정보

Authorization: Bearer $GLOOP_API_KEY로 요청을 인증하세요. 키가 URL에 노출되지 않도록 요청 헤더로 전달하세요. 모델 목록은 항상 OpenAI 형식으로 반환됩니다.

키, 계정, 모델/도구 권한이 함께 접근 권한을 결정합니다. 같은 계정의 다른 키는 원래 작업의 식별 정보가 아닙니다. 과거 작업, 도구 실행과 파일에는 일반적으로 동일한 계정과 키가 필요합니다. 모델 권한이 도구 권한을 자동 부여하지는 않습니다. 도구 실행에는 계정 그룹의 권한과 키에 부여된 도구 권한의 교집합이 적용됩니다.

일반 조회와 영구 보관 조회

일반 텍스트, 동기 이미지, 음성, 모델 카탈로그와 오디오 복제는 일반 인증을 사용합니다. 할당량이 소진되면 오디오 복제 상태나 결과 조회도 거부될 수 있으므로 결과 조회가 보장되지는 않습니다.

영구 보관 이미지, 동영상, 도구 실행과 파일 경로는 각각의 영구 보관 인증을 사용하여 할당량이 소진되어도 유효한 키로 기록을 조회할 수 있습니다. 만료, 폐기, IP 제한과 계정 차단은 여전히 거부 사유입니다. 새 생성에는 예산, 권한, 설정과 기능 검사가 추가로 필요합니다. 기록을 읽을 수 있다고 작업을 생성할 수 있는 것은 아닙니다.

이미지 기록은 현재 모델 권한을 계속 확인합니다. 동영상 기록과 요청 복구 검사는 경로마다 다르므로 모든 기록 조회에 전체 생성 정책이 적용된다고 설명해서는 안 됩니다. 각 엔드포인트의 인증 설명을 참고하세요.

파일과 서명 URL

원래 키로 API 파일 메타데이터와 다운로드 URL을 조회하세요. 단기 서명 다운로드 URL 자체가 읽기 권한을 부여합니다. 공개적으로 공유하거나 API 키를 객체 스토리지에 전달하지 마세요. 이미지 자산 콘텐츠는 Bearer 또는 서버 서명을 지원합니다. 서명 매개변수가 있으면 서명만 검증하며 실패 시 Bearer로 대체하지 않습니다.

401이면 키와 만료 여부를 확인하고 403이면 계정, IP와 권한을 확인하세요. 원인을 해결한 후 진행하세요. 제출 결과가 불명확하면 복구 절차로 대조하세요. 키를 바꿔 중복 결과를 생성하지 마세요.