모델 목록

현재 사용자가 접근할 수 있는 모든 AI 모델 목록을 가져옵니다. 모델 ID, 이름, 공급자, 상세 정보가 포함됩니다.

모델 목록과 토큰 그룹에 대해

목록에 반환되는 모델은 API KEY가 속한 토큰 그룹에 따라 달라집니다. 콘솔 → API Tokens에서 토큰을 생성하거나 편집할 때 토큰 그룹을 선택할 수 있습니다.

엔드포인트

GET https://aiberm.com/v1/models

요청 예제

1curl -X GET "https://aiberm.com/v1/models" \
2-H "Authorization: Bearer sk-your-api-token-here" \
3-H "Content-Type: application/json"

응답 형식

성공 응답 (200 OK)

1{
2"success": true,
3"data": [
4  {
5    "id": "gpt-4",
6    "object": "model",
7    "created": 1626777600,
8    "owned_by": "openai",
9    "supported_endpoint_types": [
10      "chat",
11      "completion"
12    ]
13  },
14  {
15    "id": "gpt-3.5-turbo",
16    "object": "model",
17    "created": 1626777600,
18    "owned_by": "openai",
19    "supported_endpoint_types": [
20      "chat",
21      "completion"
22    ]
23  },
24  {
25    "id": "claude-3-sonnet-20240229",
26    "object": "model",
27    "created": 1626777600,
28    "owned_by": "anthropic",
29    "supported_endpoint_types": [
30      "chat"
31    ]
32  }
33]
34}

응답 필드

최상위 필드:

success - Boolean, 요청 성공 여부
data - 모델 객체 배열 (성공 시에만 반환)
message - 오류 메시지 (실패 시에만 반환)

모델 객체 필드:

id - 모델의 고유 식별자
object - 객체 유형, “model”로 고정
created - 모델 생성 타임스탬프
owned_by - 모델 공급자 (예: openai, anthropic)
supported_endpoint_types - 지원하는 API 엔드포인트 유형 배열

지원 엔드포인트 유형

chat - 채팅 완성
completion - 텍스트 완성
embedding - 텍스트 임베딩
image - 이미지 생성
audio - 오디오 처리
rerank - 재순위(Rerank)

중요 사항

인증 필요

유효한 API 토큰을 제공해야 합니다. 토큰에 따라 사용자가 접근할 수 있는 모델이 결정됩니다.

권한 제어

반환되는 모델 목록은 사용자 그룹과 토큰 그룹을 기준으로 필터링되어, 사용자가 접근 권한을 가진 모델만 표시됩니다.

일반적인 오류

401 Unauthorized - API 토큰이 유효하지 않거나 만료됨
403 Forbidden - 사용자에게 접근 권한이 없음
500 Internal Server Error - 내부 서버 오류