모델 관리 API

GET

api

models

모델 관리 API

curl --request GET \
  --url https://aihubmix.com/api/v1/models \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {}
  ],
  "model_id": "<string>",
  "model_name": "<string>",
  "developer_id": 123,
  "desc": "<string>",
  "vendor": "<string>",
  "types": "<string>",
  "features": "<string>",
  "input_modalities": "<string>",
  "output_modalities": "<string>",
  "endpoints": "<string>",
  "max_output": 123,
  "context_length": 123,
  "release_date": "<string>",
  "last_updated": "<string>",
  "open_weights": true,
  "schema_checked": true,
  "pricing": {},
  "pricing.input": 123,
  "pricing.output": 123,
  "pricing.cache_read": 123,
  "pricing.cache_write": 123,
  "pricing.tiers": [
    {}
  ],
  "reasoning": true,
  "tool_call": true,
  "reasoning_options": [
    {}
  ],
  "interleaved": {},
  "variant_of": "<string>",
  "variant_kind": "<string>",
  "retire_stage": "<string>",
  "deprecated_at": "<string>",
  "retired_at": "<string>",
  "successor_model": "<string>",
  "promotion": {},
  "promotion.name": "<string>",
  "promotion.off_percent": 123,
  "promotion.time_type": "<string>"
}

신버전 인터페이스

모델 정보 플랫폼 조회

인터페이스 주소: GET https://aihubmix.com/api/v1/models 기능 설명: 사용 가능한 모든 모델의 상세 정보를 조회합니다.

모델 객체 필드 설명

기본 정보

array

모델 정보 목록 배열

string

모델 고유 식별자로, 인터페이스 호출 시 사용하는 model 매개변수 값입니다

string

모델 표시 이름

integer

플랫폼 내 모델 개발사 번호이며, 요청 매개변수 developer_id와 함께 사용하여 필터링할 수 있습니다

string

모델 기능 설명(영문)

string

모델 제조사 식별자(예: openai, anthropic, zhipu). developer_id와는 별개의 번호 체계이며, 선택 필드로 생략 시 미수록을 의미합니다

string

모델 유형이며 쉼표로 구분됩니다. 지원 값: llm(대규모 언어 모델), image_generation(이미지 생성 모델), video(비디오 생성 모델), tts(음성 합성 모델), stt(음성-텍스트 변환 모델), embedding(임베딩 모델), rerank(순위 재정렬 모델), ocr(문자 인식 모델), search(검색 모델), 3d(3D 생성 모델)

string

지원하는 기능 특성이며 쉼표로 구분됩니다. 지원 값: thinking(사고 추론 지원), tools(도구 호출 지원), function_calling(함수 호출 지원), web(검색 지원), deepsearch(심층 검색 지원), long_context(롱 컨텍스트 모델), structured_outputs(구조화된 출력)

string

지원하는 입력 모달리티이며 쉼표로 구분됩니다. 지원 값: text(텍스트), image(이미지), audio(오디오), video(비디오), pdf

string

지원하는 출력 모달리티이며 쉼표로 구분됩니다. 지원 값: text(텍스트), image(이미지), audio(오디오), video(비디오). 선택 필드로 생략 시 미표기를 의미합니다

string

모델이 사용 가능한 인터페이스 프로토콜이며 쉼표로 구분됩니다. 지원 값: chat_completions(Chat Completions 인터페이스), responses(Responses 인터페이스), claude_api(Claude Messages 인터페이스), gemini_api(Gemini 인터페이스). 빈 값은 아직 표기되지 않았음을 의미합니다

integer

최대 출력 토큰 수

integer

컨텍스트 윈도우 크기(최대 입력 토큰 수)

string

모델 출시 날짜이며 형식은 YYYY-MM-DD 또는 YYYY-MM입니다. 선택 필드로 생략 시 미수록을 의미합니다

string

모델의 가장 최근 업데이트 날짜이며, 제자리 업그레이드 기록이 없으면 release_date와 동일합니다. 선택 필드입니다

boolean

모델 가중치를 공개 다운로드하여 직접 배포할 수 있는지 여부입니다. false는 공식적으로 가중치를 공개하지 않음을 명시한 것이며, 선택 필드로 생략 시 미수록을 의미합니다

boolean

플랫폼이 해당 모델의 요청 매개변수 구조 검증을 완료했는지 여부

가격 정보

object

가격 정보 객체이며, 모든 가격 단위는 100만(1M) 토큰당 미국 달러입니다

number

입력 토큰 가격(USD / 1M 토큰)

number

출력 토큰 가격(USD / 1M 토큰)

number

캐시 읽기 가격(USD / 1M 토큰, 선택 필드)

number

캐시 쓰기 가격(USD / 1M 토큰, 선택 필드)

array

구간별 가격 배열이며 선택 필드입니다. 각 요소는 tier 객체(type은 context로 고정, size는 컨텍스트 토큰 수 임계값)와 해당 구간의 input, output, cache_read, cache_write 가격을 포함합니다. 요청의 컨텍스트 길이가 size를 초과하면 해당 구간의 가격으로 과금되며, 최상위의 input, output 등 필드는 기본 구간 가격입니다

추론 및 도구 능력

boolean

사고 추론 능력 보유 여부이며, features를 정규화하여 얻은 불리언 값입니다. 선택 필드로 생략 시 미표기를 의미하며, 생략이 미지원을 의미하지는 않습니다

boolean

도구 호출 지원 여부이며, features를 정규화하여 얻은 불리언 값입니다. 선택 필드로 생략 시 미표기를 의미하며, 생략이 미지원을 의미하지는 않습니다

array

사고 단계 설정 배열이며 선택 필드입니다. 각 항목은 type을 포함하며 지원 값: toggle(사고 켜기/끄기 가능), effort(단계별 제어, values에 선택 가능한 단계 목록, default는 기본 단계), budget_tokens(토큰 예산으로 제어)

object

각 인터페이스 프로토콜에서 사고 내용이 반환되는 방식이며, 선택 필드로 생략 시 미수록을 의미합니다. 키는 프로토콜 이름(anthropic.messages, openai.chat_completions, openai.responses, google.gemini)이고, 값은 true(해당 프로토콜에서 사고 내용 반환 가능) 또는 {"field": "reasoning_content"}(사고 내용이 해당 필드를 통해 반환됨)입니다. 실제 호출하는 프로토콜에 해당하는 키를 참조하십시오

변형과 수명 주기

string

모체 모델 ID이며 선택 필드입니다. 존재하는 경우 현재 model_id와 모체 모델이 동일한 모델이며, 플랫폼 내 등급 또는 프리셋만 다름을 의미합니다

string

변형 유형이며 variant_of와 쌍으로 나타납니다. 지원 값: pricing-tier(가격 등급), channel-tier(접속 등급), mode-preset(모드 프리셋), deprecated-alias(폐기된 별칭)

string

모델 수명 주기 단계이며 항상 반환됩니다. 지원 값: active(정상 서비스 제공 중), deprecated(서비스 종료가 공지되었으나 여전히 호출 가능). 서비스가 중단된 모델은 본 인터페이스의 응답에 나타나지 않습니다

string

서비스 종료 공지 시각(ISO 8601 형식). deprecated 단계에서만 반환됩니다

string

서비스 중단 예정 시각(ISO 8601 형식). 선택 필드이며 deprecated 단계에서만 반환될 수 있습니다

string

마이그레이션이 권장되는 대체 모델 ID. 선택 필드이며 deprecated 단계에서만 반환될 수 있습니다

기간 한정 할인

object

기간 한정 할인 정보이며 선택 필드로, 할인이 없으면 생략됩니다

string

할인 이벤트 이름

integer

할인 비율이며, 예를 들어 10은 10% 할인을 의미합니다

string

할인 시간 규칙 유형입니다. 지원 값: absolute(절대 시간 구간, absolute 객체의 start, end 참조), daily(매일 고정 시간대, daily.ranges 참조), weekly(매주 고정 시간대, weekly 배열의 weekdays와 ranges 참조, weekdays는 ISO 8601 인코딩을 따르며 월요일이 1, 일요일이 7)

요청 예제

import requests

# 接口地址
url = "https://aihubmix.com/api/v1/models"

response = requests.get(url)
print(response.json())

params = {
    "type": "llm",                   
	"modalities": "text",
	"model": "gpt-5",
	"features": "thinking",
    "sort_by": "context_length",
    "sort_order": "desc"    
}
response = requests.get(url, params=params)
print(response.json())

fetch('https://aihubmix.com/api/v1/models')
  .then(response => response.json())
  .then(data => console.log(data));

const params = new URLSearchParams({
  type: 'llm',
  modalities: 'text',
  model: 'gpt-5',
  features: 'thinking',
  sort_by: 'context_length',
  sort_order: 'desc' 
});

fetch(`https://aihubmix.com/api/v1/models?${params}`)
  .then(response => response.json())
  .then(data => console.log(data));

curl -X GET "https://aihubmix.com/api/v1/models"

curl -X GET "https://aihubmix.com/api/v1/models?type=llm&modalities=text&model=gpt-5&features=thinking&sort_by=context_length&sort_order=desc"

요청 매개변수 설명(필터링에 사용 가능)

string

모델 유형. 지원 값: llm(대규모 언어 모델), image_generation(이미지 생성 모델), video(비디오 생성 모델), tts(음성 합성 모델), stt(음성-텍스트 변환 모델), embedding(임베딩 모델), rerank(순위 재정렬 모델), ocr(문자 인식 모델), search(검색 모델), 3d(3D 생성 모델)

string

입력 모달리티. 지원 값: text(텍스트), image(이미지), audio(오디오), video(비디오), pdf, 다중 모달리티 조회 지원(쉼표로 구분)

string

모델 이름 퍼지 검색(부분 일치 지원)

string

모델 기능 특성. 지원 값: thinking(사고 추론 지원), tools(도구 호출 지원), function_calling(함수 호출 지원), web(검색 지원), deepsearch(심층 검색 지원), long_context(롱 컨텍스트 모델), structured_outputs(구조화된 출력), 다중 기능 조회 지원(쉼표로 구분)

string

인터페이스 프로토콜 필터링. 지원 값: chat_completions, responses, claude_api, gemini_api, 다중 값 조회 지원(쉼표로 구분)

integer

모델 개발사 번호로 필터링하며, 번호는 응답 필드 developer_id를 참조하십시오

string

모델 태그로 필터링합니다. 예: coding(코딩 계열 모델)

boolean

true를 전달하면 플랫폼이 요청 매개변수 구조 검증을 완료한 모델만 반환합니다(응답 필드 schema_checked가 true인 모델)

string

정렬 필드. 지원 값:
• model_ratio: 가성비순 정렬
• context_length: 컨텍스트 길이순 정렬
• coding: 코딩 모델 우선 정렬
• order: 기본 순서 정렬

string

정렬 방향. 지원 값:
• asc(오름차순)
• desc(내림차순)

성공 응답 예제

{
    "data": [
        {
            "model_id": "gpt-6-astra",
            "model_name": "GPT 6 Astra",
            "developer_id": 12,
            "desc": "GPT-6 Astra is OpenAI's newest and most intelligent model, with industry-leading performance in computer operations, web browsing, software engineering, scientific research, and professional work.",
            "pricing": {
                "cache_read": 1,
                "cache_write": 12.5,
                "input": 10,
                "output": 50,
                "tiers": [
                    {
                        "cache_read": 2,
                        "cache_write": 25,
                        "input": 20,
                        "output": 75,
                        "tier": {
                            "size": 272000,
                            "type": "context"
                        }
                    }
                ]
            },
            "types": "llm",
            "features": "tools,thinking,structured_outputs",
            "input_modalities": "text,image",
            "endpoints": "chat_completions,responses",
            "max_output": 128000,
            "context_length": 1050000,
            "release_date": "2026-09-05",
            "last_updated": "2026-09-05",
            "output_modalities": "text",
            "reasoning": true,
            "tool_call": true,
            "reasoning_options": [
                {
                    "type": "effort",
                    "values": ["low", "medium", "high", "xhigh", "max"],
                    "default": "medium"
                }
            ],
            "interleaved": {
                "openai.responses": true
            },
            "vendor": "openai",
            "open_weights": false,
            "schema_checked": false,
            "retire_stage": "active"
        },
        {
            "model_id": "glm-5.3",
            "model_name": "GLM 5.3",
            "developer_id": 5,
            "desc": "GLM-5.3 is Z.AI's coding and agentic reasoning model, built for complex software engineering, long-running agent tasks, vulnerability analysis, and other demanding workloads.",
            "pricing": {
                "cache_read": 0.2817,
                "input": 1.1268,
                "output": 3.9438
            },
            "types": "llm",
            "features": "thinking,tools,function_calling,structured_outputs",
            "input_modalities": "text",
            "endpoints": "",
            "max_output": 131072,
            "context_length": 1048576,
            "release_date": "2026-08-14",
            "last_updated": "2026-08-14",
            "output_modalities": "text",
            "reasoning": true,
            "tool_call": true,
            "reasoning_options": [
                {
                    "type": "toggle"
                },
                {
                    "type": "effort",
                    "values": ["low", "high", "max"],
                    "default": "max"
                }
            ],
            "interleaved": {
                "anthropic.messages": true,
                "openai.chat_completions": {
                    "field": "reasoning_content"
                }
            },
            "vendor": "zhipu",
            "open_weights": true,
            "schema_checked": false,
            "promotion": {
                "name": "GLM-5.3 limited-time special offer",
                "off_percent": 10,
                "time_type": "daily",
                "daily": {
                    "ranges": ["00:00-23:59"]
                }
            },
            "retire_stage": "active"
        }
    ],
    "message": "",
    "success": true
}

사용 시나리오 예제

GET https://aihubmix.com/api/v1/models?type=llm

GET https://aihubmix.com/api/v1/models?tag=coding&sort_by=context_length&sort_order=desc

GET https://aihubmix.com/api/v1/models?model=gpt-5

GET https://aihubmix.com/api/v1/models?type=llm&modalities=text,image&features=function_calling&sort_by=model_ratio&sort_order=asc

GET https://aihubmix.com/api/v1/models?sort_by=coding

GET https://aihubmix.com/api/v1/models?endpoints=claude_api

GET https://aihubmix.com/api/v1/models?schema_checked=true

설명: 코딩 모델 스마트 정렬을 사용하면 시스템이 coding 태그를 포함한 모델을 우선 표시하고, 다른 모델은 기본 순서대로 배열합니다.

성능 최적화

캐시 메커니즘

캐시 전략: HTTP 캐시, 캐시 유지 시간 300초(5분)
캐시 제어: Cache-Control: private, max-age=300, stale-while-revalidate=300
콘텐츠 검증: ETag 콘텐츠 해시 검증 지원

캐시 사용 예제

# ETag를 사용한 조건부 요청
curl -H "If-None-Match: \"abc123...\"" \
     https://aihubmix.com/api/v1/models

콘텐츠가 업데이트되지 않은 경우 서버는 304 Not Modified 상태 코드를 반환합니다.

오류 처리

{
  "success": false,
  "message": "请求参数格式错误"
}

{
  "success": false,
  "message": "服务器内部错误，请稍后重试"
}

중요 참고 사항

데이터 완전성: 이 인터페이스는 조건에 맞는 모든 모델을 반환하며 페이지네이션 처리를 하지 않습니다
유형 호환성: 신구 유형 식별자의 자동 매핑을 지원합니다
- t2t ↔ llm
- t2i ↔ image_generation
- t2v ↔ video
- reranking ↔ rerank
필터링 로직: 여러 필터 조건 간에는 논리곱(AND) 관계가 적용됩니다
정렬 규칙: 정렬 방식을 지정하지 않으면 기본적으로 시스템 사전 설정 순서로 배열됩니다
수명 주기: retire_stage가 deprecated인 모델은 여전히 정상적으로 호출할 수 있으며, successor_model, retired_at 필드를 참고하여 미리 마이그레이션을 계획하는 것을 권장합니다. 서비스가 중단된 모델은 응답 목록에 나타나지 않습니다
선택 필드: 선택으로 표시된 필드가 생략된 경우 해당 정보가 표기되지 않았거나 수록되지 않았음을 의미하며, 생략이 모델에 해당 능력이 없음을 의미하지는 않습니다

구버전 인터페이스

⚠️ 참고: 아래는 구버전 인터페이스입니다. 더 나은 성능과 기능을 위해 신버전 인터페이스 사용을 권장합니다.

모델 목록 획득

엔드포인트(Endpoint): GET /v1/models

사용자가 로그인한 경우 사용자 그룹의 사용 가능한 목록을 가져오고, 사용자가 로그인하지 않은 경우 default 그룹의 사용 가능한 목록을 가져옵니다.
header에 Authorization 필드가 있으면 key에 해당하는 token 하위에 구성된 모델 목록을 조회합니다.

응답 예제:

{
  "data": [
    {
      "id": "gpt-4o-mini",
      "object": "model",
      "created": 1626777600,
      "owned_by": "OpenAI",
      "permission": [
        {
          "id": "modelperm-LwHkVFn8AcMItP432fKKDIKJ",
          "object": "model_permission",
          "created": 1626777600,
          "allow_create_engine": true,
          "allow_sampling": true,
          "allow_logprobs": true,
          "allow_search_indices": false,
          "allow_view": true,
          "allow_fine_tuning": false,
          "organization": "*",
          "group": null,
          "is_blocking": false
        }
      ],
      "root": "gpt-4o-mini",
      "parent": null
    }
  ]
}

응답 결과

상태 코드	상태 코드 의미	설명	데이터 모델
200	OK	none	Inline

응답 데이터 구조

상태 코드 200

이름	타입	필수	제약	중국어명	설명
» data	[object]	true	none		none
»» id	string	true	none	모델 ID	none
»» object	string	true	none	model	none
»» created	integer	true	none	생성 시간	none
»» owned_by	string	true	none	개발자	none
»» permission	[object]¦null	true	none		none
»»» id	string	true	none		none
»»» object	string	true	none		none
»»» created	integer	true	none		none
»»» allow_create_engine	boolean	true	none		none
»»» allow_sampling	boolean	true	none		none
»»» allow_logprobs	boolean	true	none		none
»»» allow_search_indices	boolean	true	none		none
»»» allow_view	boolean	true	none		none
»»» allow_fine_tuning	boolean	true	none		none
»»» organization	string	true	none		none
»»» group	null	true	none		none
»»» is_blocking	boolean	true	none		none
»» root	string	true	none	모델명	none
»» parent	null	true	none	부모 노드	none

모델 정보 획득

엔드포인트(Endpoint): GET /v1/models/:model

요청 매개변수

이름	위치	타입	필수	설명
model	path	string	예	모델 ID

응답 예제:

200 Response

{
  "id": "string",
  "object": "string",
  "created": 0,
  "owned_by": "string",
  "permission": [
    {
      "id": "string",
      "object": "string",
      "created": 0,
      "allow_create_engine": true,
      "allow_sampling": true,
      "allow_logprobs": true,
      "allow_search_indices": true,
      "allow_view": true,
      "allow_fine_tuning": true,
      "organization": "string",
      "group": null,
      "is_blocking": true
    }
  ],
  "root": "string",
  "parent": null
}

응답 결과

상태 코드	상태 코드 의미	설명	데이터 모델
200	OK	none	Inline

응답 데이터 구조

상태 코드 200

이름	타입	필수	제약	중국어명	설명
id	string	true	none	모델 ID	none
object	string	true	none	model	none
created	integer	true	none	생성 시간	none
owned_by	string	true	none	개발자	none
permission	[object]	true	none		none
» id	string	false	none		none
» object	string	false	none		none
» created	integer	false	none		none
» allow_create_engine	boolean	false	none		none
» allow_sampling	boolean	false	none		none
» allow_logprobs	boolean	false	none		none
» allow_search_indices	boolean	false	none		none
» allow_view	boolean	false	none		none
» allow_fine_tuning	boolean	false	none		none
» organization	string	false	none		none
» group	null	false	none		none
» is_blocking	boolean	false	none		none
root	string	true	none	모델명	none
parent	null	true	none	부모 노드	none

마지막 업데이트: 2026-09-18

모델 관리 API

curl --request GET \
  --url https://aihubmix.com/api/v1/models \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {}
  ],
  "model_id": "<string>",
  "model_name": "<string>",
  "developer_id": 123,
  "desc": "<string>",
  "vendor": "<string>",
  "types": "<string>",
  "features": "<string>",
  "input_modalities": "<string>",
  "output_modalities": "<string>",
  "endpoints": "<string>",
  "max_output": 123,
  "context_length": 123,
  "release_date": "<string>",
  "last_updated": "<string>",
  "open_weights": true,
  "schema_checked": true,
  "pricing": {},
  "pricing.input": 123,
  "pricing.output": 123,
  "pricing.cache_read": 123,
  "pricing.cache_write": 123,
  "pricing.tiers": [
    {}
  ],
  "reasoning": true,
  "tool_call": true,
  "reasoning_options": [
    {}
  ],
  "interleaved": {},
  "variant_of": "<string>",
  "variant_kind": "<string>",
  "retire_stage": "<string>",
  "deprecated_at": "<string>",
  "retired_at": "<string>",
  "successor_model": "<string>",
  "promotion": {},
  "promotion.name": "<string>",
  "promotion.off_percent": 123,
  "promotion.time_type": "<string>"
}

모델 엔드포인트

플랫폼 API

모델 관리 API

신버전 인터페이스

모델 정보 플랫폼 조회

모델 객체 필드 설명

기본 정보

가격 정보

추론 및 도구 능력

변형과 수명 주기

기간 한정 할인

요청 예제

요청 매개변수 설명(필터링에 사용 가능)

성공 응답 예제

사용 시나리오 예제

성능 최적화

캐시 메커니즘

캐시 사용 예제

오류 처리

중요 참고 사항

구버전 인터페이스

모델 목록 획득

응답 결과

응답 데이터 구조

모델 정보 획득

요청 매개변수

응답 결과

응답 데이터 구조

​신버전 인터페이스

​모델 정보 플랫폼 조회

​모델 객체 필드 설명

​기본 정보

​가격 정보

​추론 및 도구 능력

​변형과 수명 주기

​기간 한정 할인

​요청 예제

​요청 매개변수 설명(필터링에 사용 가능)

​성공 응답 예제

​사용 시나리오 예제

​성능 최적화

​캐시 메커니즘

​캐시 사용 예제

​오류 처리

​중요 참고 사항

​구버전 인터페이스

​모델 목록 획득

​응답 결과

​응답 데이터 구조

​모델 정보 획득

​요청 매개변수

​응답 결과

​응답 데이터 구조

신버전 인터페이스

모델 정보 플랫폼 조회

모델 객체 필드 설명

기본 정보

가격 정보

추론 및 도구 능력

변형과 수명 주기

기간 한정 할인

요청 예제

요청 매개변수 설명(필터링에 사용 가능)

성공 응답 예제

사용 시나리오 예제

성능 최적화

캐시 메커니즘

캐시 사용 예제

오류 처리

중요 참고 사항

구버전 인터페이스

모델 목록 획득

응답 결과

응답 데이터 구조

모델 정보 획득

요청 매개변수

응답 결과

응답 데이터 구조