ToAPIsToAPIs

List モデル

List models available to the current API key, compatible with the OpenAI モデル API

GET
/v1/models

中国本土のユーザー向け: 中国本土のユーザーは 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=all to 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_KEY

Query パラメータ

typestringクエリデフォルト: text

Filters models by type.

Supported values:

  • text or chat: return text/chat models only
  • image: return image models only
  • video: return video models only
  • audio: return audio models only
  • all: return all available models

If omitted, only text models are returned by default.

レスポンス

successboolean

Whether the request succeeded.

objectstring

List object type. Always list.

dataobject[]

The list of models.

data[n]
idstring

モデル ID. Use this value as the model parameter in other API requests.

objectstring

Object 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 type is 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.