플랫폼 API
모델 관리 API
이 API 문서는 모델 관리 인터페이스에 대한 상세 설명을 제공하며, 신버전과 구버전 인터페이스의 기능, 요청 예제, 매개변수 설명 및 응답 형식을 포함합니다.
GET
모델 관리 API
신버전 인터페이스
모델 정보 플랫폼 조회
인터페이스 주소:GET https://aihubmix.com/api/v1/models
기능 설명: 사용 가능한 모든 모델의 상세 정보를 조회합니다.
모델 객체 필드 설명
기본 정보
모델 유형이며 쉼표로 구분됩니다. 지원 값:
llm(대규모 언어 모델), image_generation(이미지 생성 모델), video(비디오 생성 모델), tts(음성 합성 모델), stt(음성-텍스트 변환 모델), embedding(임베딩 모델), rerank(순위 재정렬 모델), ocr(문자 인식 모델), search(검색 모델), 3d(3D 생성 모델)지원하는 기능 특성이며 쉼표로 구분됩니다. 지원 값:
thinking(사고 추론 지원), tools(도구 호출 지원), function_calling(함수 호출 지원), web(검색 지원), deepsearch(심층 검색 지원), long_context(롱 컨텍스트 모델), structured_outputs(구조화된 출력)지원하는 출력 모달리티이며 쉼표로 구분됩니다. 지원 값:
text(텍스트), image(이미지), audio(오디오), video(비디오). 선택 필드로 생략 시 미표기를 의미합니다모델이 사용 가능한 인터페이스 프로토콜이며 쉼표로 구분됩니다. 지원 값:
chat_completions(Chat Completions 인터페이스), responses(Responses 인터페이스), claude_api(Claude Messages 인터페이스), gemini_api(Gemini 인터페이스). 빈 값은 아직 표기되지 않았음을 의미합니다모델 가중치를 공개 다운로드하여 직접 배포할 수 있는지 여부입니다.
false는 공식적으로 가중치를 공개하지 않음을 명시한 것이며, 선택 필드로 생략 시 미수록을 의미합니다가격 정보
구간별 가격 배열이며 선택 필드입니다. 각 요소는
tier 객체(type은 context로 고정, size는 컨텍스트 토큰 수 임계값)와 해당 구간의 input, output, cache_read, cache_write 가격을 포함합니다. 요청의 컨텍스트 길이가 size를 초과하면 해당 구간의 가격으로 과금되며, 최상위의 input, output 등 필드는 기본 구간 가격입니다추론 및 도구 능력
사고 단계 설정 배열이며 선택 필드입니다. 각 항목은
type을 포함하며 지원 값: toggle(사고 켜기/끄기 가능), effort(단계별 제어, values에 선택 가능한 단계 목록, default는 기본 단계), budget_tokens(토큰 예산으로 제어)각 인터페이스 프로토콜에서 사고 내용이 반환되는 방식이며, 선택 필드로 생략 시 미수록을 의미합니다. 키는 프로토콜 이름(
anthropic.messages, openai.chat_completions, openai.responses, google.gemini)이고, 값은 true(해당 프로토콜에서 사고 내용 반환 가능) 또는 {"field": "reasoning_content"}(사고 내용이 해당 필드를 통해 반환됨)입니다. 실제 호출하는 프로토콜에 해당하는 키를 참조하십시오변형과 수명 주기
변형 유형이며
variant_of와 쌍으로 나타납니다. 지원 값: pricing-tier(가격 등급), channel-tier(접속 등급), mode-preset(모드 프리셋), deprecated-alias(폐기된 별칭)모델 수명 주기 단계이며 항상 반환됩니다. 지원 값:
active(정상 서비스 제공 중), deprecated(서비스 종료가 공지되었으나 여전히 호출 가능). 서비스가 중단된 모델은 본 인터페이스의 응답에 나타나지 않습니다기간 한정 할인
할인 시간 규칙 유형입니다. 지원 값:
absolute(절대 시간 구간, absolute 객체의 start, end 참조), daily(매일 고정 시간대, daily.ranges 참조), weekly(매주 고정 시간대, weekly 배열의 weekdays와 ranges 참조, weekdays는 ISO 8601 인코딩을 따르며 월요일이 1, 일요일이 7)요청 예제
요청 매개변수 설명(필터링에 사용 가능)
모델 유형. 지원 값:
llm(대규모 언어 모델), image_generation(이미지 생성 모델), video(비디오 생성 모델), tts(음성 합성 모델), stt(음성-텍스트 변환 모델), embedding(임베딩 모델), rerank(순위 재정렬 모델), ocr(문자 인식 모델), search(검색 모델), 3d(3D 생성 모델)모델 기능 특성. 지원 값:
thinking(사고 추론 지원), tools(도구 호출 지원), function_calling(함수 호출 지원), web(검색 지원), deepsearch(심층 검색 지원), long_context(롱 컨텍스트 모델), structured_outputs(구조화된 출력), 다중 기능 조회 지원(쉼표로 구분)정렬 필드. 지원 값:
•
•
•
•
•
model_ratio: 가성비순 정렬•
context_length: 컨텍스트 길이순 정렬•
coding: 코딩 모델 우선 정렬•
order: 기본 순서 정렬성공 응답 예제
사용 시나리오 예제
설명: 코딩 모델 스마트 정렬을 사용하면 시스템이 coding 태그를 포함한 모델을 우선 표시하고, 다른 모델은 기본 순서대로 배열합니다.
성능 최적화
캐시 메커니즘
- 캐시 전략: HTTP 캐시, 캐시 유지 시간 300초(5분)
- 캐시 제어:
Cache-Control: private, max-age=300, stale-while-revalidate=300 - 콘텐츠 검증: ETag 콘텐츠 해시 검증 지원
캐시 사용 예제
콘텐츠가 업데이트되지 않은 경우 서버는 304 Not Modified 상태 코드를 반환합니다.
오류 처리
중요 참고 사항
- 데이터 완전성: 이 인터페이스는 조건에 맞는 모든 모델을 반환하며 페이지네이션 처리를 하지 않습니다
- 유형 호환성: 신구 유형 식별자의 자동 매핑을 지원합니다
t2t↔llmt2i↔image_generationt2v↔videoreranking↔rerank
- 필터링 로직: 여러 필터 조건 간에는 논리곱(AND) 관계가 적용됩니다
- 정렬 규칙: 정렬 방식을 지정하지 않으면 기본적으로 시스템 사전 설정 순서로 배열됩니다
- 수명 주기:
retire_stage가deprecated인 모델은 여전히 정상적으로 호출할 수 있으며,successor_model,retired_at필드를 참고하여 미리 마이그레이션을 계획하는 것을 권장합니다. 서비스가 중단된 모델은 응답 목록에 나타나지 않습니다 - 선택 필드: 선택으로 표시된 필드가 생략된 경우 해당 정보가 표기되지 않았거나 수록되지 않았음을 의미하며, 생략이 모델에 해당 능력이 없음을 의미하지는 않습니다
구버전 인터페이스
⚠️ 참고: 아래는 구버전 인터페이스입니다. 더 나은 성능과 기능을 위해 신버전 인터페이스 사용을 권장합니다.
모델 목록 획득
엔드포인트(Endpoint):GET /v1/models
- 사용자가 로그인한 경우 사용자 그룹의 사용 가능한 목록을 가져오고, 사용자가 로그인하지 않은 경우 default 그룹의 사용 가능한 목록을 가져옵니다.
- header에 Authorization 필드가 있으면 key에 해당하는 token 하위에 구성된 모델 목록을 조회합니다.
응답 결과
응답 데이터 구조
상태 코드 200모델 정보 획득
엔드포인트(Endpoint):GET /v1/models/:model
요청 매개변수
응답 예제:
응답 결과
응답 데이터 구조
상태 코드 200마지막 업데이트: 2026-09-18