List 모델
List models available to the current API key, compatible with the OpenAI 모델 API
중국 본토 사용자 안내: 중국 본토 사용자는 https://toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://toapis.com 을 https://toapis.cn 로 바꿔 주세요.
- Compatible with the OpenAI 모델 API format
- Returns models available to the current API key and user group
- Returns text models by default; use
type=allto include all model types - Supports filtering by text, image, video, or audio models
Use this endpoint to retrieve the models accessible by the current API key. Results are filtered dynamically based on token model restrictions, user group, enabled channels, and model pricing configuration.
Authorizations
Authorizationstring헤더필수All API requests require Bearer Token authentication.
Get your API key from the API Key management page.
Add it to the request header:
Authorization: Bearer YOUR_API_KEYQuery 파라미터
typestring쿼리기본값: textFilters models by type.
Supported values:
textorchat: return text/chat models onlyimage: return image models onlyvideo: return video models onlyaudio: return audio models onlyall: return all available models
If omitted, only text models are returned by default.
응답
successbooleanWhether the request succeeded.
objectstringList object type. Always list.
dataobject[]The list of models.
data[n]
idstring모델 ID. Use this value as the model parameter in other API requests.
objectstringObject type. Always model.
createdinteger모델 creation timestamp. Some custom models may return the platform default timestamp.
owned_bystring모델 owner, provider, or channel name.
supported_endpoint_typesstring[]엔드포인트 types supported by the model. Different models may support Chat Completions, 응답s, image, video, or other endpoints.
요청 예시
curl --request GET \
--url 'https://toapis.com/v1/models' \
--header 'Authorization: Bearer <token>'curl --request GET \
--url 'https://toapis.com/v1/models?type=all' \
--header 'Authorization: Bearer <token>'import requests
API_BASE = 'https://toapis.com'
API_KEY = 'sk-xxxxxxxxxxxxxxxxxxxxxx'
headers = {
'Authorization': f'Bearer {API_KEY}'
}
response = requests.get(f'{API_BASE}/v1/models', headers=headers)
data = response.json()
if data.get('success'):
for model in data.get('data', []):
print(model['id'])
else:
print(data)const API_BASE = 'https://toapis.com';
const API_KEY = 'sk-xxxxxxxxxxxxxxxxxxxxxx';
async function listModels(type = 'text') {
const url = new URL('/v1/models', API_BASE);
if (type) url.searchParams.set('type', type);
const response = await fetch(url, {
headers: {
Authorization: `Bearer ${API_KEY}`,
},
});
const data = await response.json();
console.log(data.data?.map((model) => model.id));
return data;
}
listModels('all');응답 예시
{
"success": true,
"object": "list",
"data": [
{
"id": "claude-sonnet-4-6",
"object": "model",
"created": 1626777600,
"owned_by": "anthropic",
"supported_endpoint_types": ["chat_completions", "responses"]
},
{
"id": "gpt-5",
"object": "model",
"created": 1626777600,
"owned_by": "openai",
"supported_endpoint_types": ["chat_completions"]
}
]
}Notes
- If the API key has model restrictions, only allowed models are returned.
- If
typeis omitted, async task models such as video and audio models are excluded from the default result. - To retrieve image, video, audio, and text models together, call
GET /v1/models?type=all.