Seahorse Cloud 의 REST API 레퍼런스 입니다. 모든 엔드포인트는 인터랙티브 playground 가 제공되며, 우측 패널에서 직접 호출 테스트할 수 있습니다.
API 카테고리
추론 (Inference)
Chat Completions · Embeddings · Models — LLM·임베딩 호출
스토리지 (Storage)
S3 호환 Object Storage — 파일 업로드·다운로드·삭제
테이블 V2 (권장)
벡터 데이터베이스 Table API — 신규 프로젝트는 V2 사용 권장
테이블 V1 (Legacy)
이전 버전 테이블 API — 호환성 유지용. 점진적 V2 전환 권장
모든 API 는 Bearer Token 또는 API Key 인증을 요구합니다.
# Bearer Token (Keycloak JWT)
curl -H "Authorization: Bearer $TOKEN" https://api.seahorse.dnotitia.ai/v2/data/scan ...
# API Key
curl -H "X-API-Key: $API_KEY" https://api.seahorse.dnotitia.ai/v2/data/scan ...
API Key 발급: Console → API Keys
V1 vs V2 선택
| 측면 | V1 | V2 |
|---|
| 상태 | Legacy | Recommended |
| 신규 프로젝트 | ✗ | ✓ |
| 기존 통합 | 호환 유지 | 마이그레이션 권장 |
| 차이점 | 기본 CRUD | 성능 개선·일관된 응답·확장 필드 |
V1 은 향후 deprecation 예정 입니다. 신규 통합은 V2 를 사용하시고, 기존 V1 사용은 점진적으로 V2 로 전환을 권장합니다.
Rate Limit · 비용
API 호출은 Billing 에 따라 과금됩니다 (Storage GB·Inference 토큰·DB RU/WU). 요금 안내 에서 자세한 단가 확인.