연동 개요

GloopAPI는 통합 API를 통해 모델, 생성 작업, 도구와 결과 파일을 제공합니다. 먼저 애플리케이션 전용 키를 만들고 해당 키에 허용된 카탈로그를 확인하세요. 웹사이트에 표시된 모델이나 도구가 현재 키에 호출 권한이 있다는 뜻은 아닙니다.

첫 요청

계정의 개발자 설정에서 키를 만들고 서버 환경 변수에 넣으세요. GLOOP_API_BASE는 /v1을 제외한 배포 환경의 API 원점이며 웹 예제는 현재 설정된 API 주소를 사용합니다.

export GLOOP_API_BASE="https://api.gloopapi.com"
curl "$GLOOP_API_BASE/v1/models" \
  -H "Authorization: Bearer $GLOOP_API_KEY"

반환된 카탈로그에서 텍스트 지원 모델을 골라 GLOOP_MODEL로 저장한 뒤 최소한의 텍스트 요청을 보내세요.

curl "$GLOOP_API_BASE/v1/chat/completions" \
  -H "Authorization: Bearer $GLOOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"$GLOOP_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}"

예제는 API 사용 방법을 설명합니다. 사용 가능한 모델과 가격은 현재 카탈로그와 견적을 기준으로 확인하세요. 문서를 읽거나 복사해도 요청이 전송되지는 않습니다.

워크플로 선택

텍스트 생성은 응답을 직접 소비하는 데 적합합니다. 영구 보관 이미지와 동영상은 먼저 기능 카탈로그를 읽고 입력을 준비한 뒤 견적을 받고 생성을 확인하며, 복구를 위해 요청 키를 보관하세요. 동기 이미지와 음성은 결과를 직접 반환하며 영구 보관 작업 복구 엔드포인트가 적용되지 않습니다.

인증, 모델 선택과 SDK 연동부터 시작하세요. 스트리밍 읽기는 스트리밍 응답, 작업 복구는 비동기 작업과 멱등성을 참고하세요.

API 진입점

• 모델 카탈로그: 현재 키의 공개 ID를 조회합니다.
• 텍스트 생성: 메시지를 보내고 동기 또는 스트리밍 응답을 처리합니다.
• 영구 보관 이미지 기능: 자산을 준비하기 전에 입력 모드와 크기를 확인합니다.
• 음성 합성: 바이너리 오디오를 저장합니다. 복제에는 별도 작업 엔드포인트를 사용합니다.
• 영구 보관 동영상 기능: 완전한 프리셋을 받은 뒤 견적을 받고 확인합니다.
• 도구 카탈로그: 허용된 도구 버전과 사용량 기반 가격 규칙을 확인합니다.
• 파일 카탈로그: 저장 상태를 확인하고 다운로드 URL을 조회합니다.
• 응답 생성