List models

GET /openai/v1/models● Supported

Official OpenAI docs ↗

Request parameters

offsetinteger可选
默认 0
query: Number of records to skip for pagination. When both offset and limit are omitted, the full list is returned
Verified to take effect.
limitinteger可选
query: Maximum number of records to return (max 1000). When both offset and limit are omitted, the full list is returned
Verified to take effect.
categorystring可选○ Currently ignored
query: Filter models by use case category
Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
取值 programmingroleplaymarketingmarketing/seotechnologysciencetranslationlegalfinancehealthtriviaacademia
supported_parametersstring可选○ Currently ignored
query: Filter models by supported parameter (comma-separated)
Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
output_modalitiesstring可选
query: Filter models by output modality. Accepts a comma-separated list of modalities (text, image, embeddings, audio, video, rerank, decisions, speech, transcription) or "all" to include all models. When omitted, all models are included; comma-separated modalities match any output.
Verified to take effect.
sortstring可选
query: Sort by newest creation date or lowest declared USD unit rate (not estimated request cost). Unpriced models sort last; ties retain catalog order.
Verified to take effect.
取值 newestprice_low
qstring可选
query: Free-text search by model name or slug.
Verified to take effect.
input_modalitiesstring可选○ Currently ignored
query: Filter models by input modality. Comma-separated list of: text, image, audio, file.
Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
contextinteger可选○ Currently ignored
query: Minimum context length (tokens). Models with smaller context are excluded.
Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
min_pricenumber可选○ Currently ignored
query: Minimum prompt price in $/M tokens.
Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
▸ 更多参数（20）
- max_pricenumber可选○ Currently ignored
  query: Maximum prompt price in $/M tokens.
  Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
- archstring可选○ Currently ignored
  query: Filter models by architecture/model family (e.g. GPT, Claude, Gemini, Llama).
  Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
- model_authorsstring可选○ Currently ignored
  query: Filter models by the organization that created the model. Comma-separated list of author slugs.
  Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
- providersstring可选○ Currently ignored
  query: Filter models by hosting provider. Comma-separated list of provider names.
  Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
- distillablestring可选○ Currently ignored
  query: Filter by distillation capability. "true" returns only distillable models, "false" excludes them.
  Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
  取值 truefalse
- zdrstring可选○ Currently ignored
  query: When set to "true", return only models with zero data retention endpoints.
  Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
  取值 true
- regionstring可选○ Currently ignored
  query: Filter to models with endpoints in the given data region ("eu" or "us").
  Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
  取值 euus
- min_output_pricenumber可选○ Currently ignored
  query: Minimum completion (output) price in $/M tokens.
  Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
- max_output_pricenumber可选○ Currently ignored
  query: Maximum completion (output) price in $/M tokens.
  Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
- min_age_daysinteger可选○ Currently ignored
  query: Minimum model age in days since its creation date.
  Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
- max_age_daysinteger可选○ Currently ignored
  query: Maximum model age in days since its creation date.
  Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
- min_intelligence_indexnumber可选○ Currently ignored
  query: Minimum Artificial Analysis intelligence index.
  Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
- max_intelligence_indexnumber可选○ Currently ignored
  query: Maximum Artificial Analysis intelligence index.
  Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
- min_coding_indexnumber可选○ Currently ignored
  query: Minimum Artificial Analysis coding index.
  Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
- max_coding_indexnumber可选○ Currently ignored
  query: Maximum Artificial Analysis coding index.
  Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
- min_agentic_indexnumber可选○ Currently ignored
  query: Minimum Artificial Analysis agentic index.
  Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
- max_agentic_indexnumber可选○ Currently ignored
  query: Maximum Artificial Analysis agentic index.
  Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
- min_tool_success_ratenumber可选○ Currently ignored
  query: Minimum tool-calling success rate, as a fraction in [0, 1] (e.g. 0.9 = 90% of requests finishing with a tool_calls finish reason).
  Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
- max_tool_success_ratenumber可选○ Currently ignored
  query: Maximum tool-calling success rate, as a fraction in [0, 1].
  Accepted but currently has no effect. Currently does not filter or sort the models by this criterion.
- apiarray可选
  query: Match any comma-separated API family: chat selects openai.chat.completions; responses selects openai.responses; embeddings selects openai.embeddings; images selects openai.images.*; audio selects openai.audio.*; videos selects openai.videos. Omitted or empty includes all OpenAI-offered models. Other filters combine using AND, before pagination. Invalid values return 400 with all legal values.
  Filters declared OpenAI APIs before pagination; comma-separated families match any selected API.

Returns

200 list

Errors follow the OpenAI format — see error codes

Response

HTTP 200

Returns a list of models or RSS feed

application/json

Name	Type	Description
data	array<object>	List of available models
data[].alias_target	object	Concrete model targeted by this tilde-latest alias, when applicable
data[].architecture	object	Model architecture information
data[].benchmarks	object	Third-party benchmark rankings for this model. Omitted when no benchmark data is available.
data[].canonical_slug	string	Canonical slug for the model
data[].context_length	integer \| null	Maximum context length in tokens
data[].created	integer	Unix timestamp of when the model was created
data[].default_parameters	object \| null	Default parameters for this model
data[].description	string	Description of the model
data[].expiration_date	string \| null	The date after which the model may be removed. ISO 8601 date string (YYYY-MM-DD) or null if no expiration.
data[].hugging_face_id	string \| null	Hugging Face model identifier, if applicable
data[].id	string	Unique identifier for the model
data[].knowledge_cutoff	string \| null	The date up to which the model was trained on data. ISO 8601 date string (YYYY-MM-DD) or null if unknown.
data[].links	object	Related API endpoints and resources for this model.
data[].name	string	Display name of the model
data[].per_request_limits	object \| null	Per-request token limits
data[].pricing	object	Pricing information for the model
data[].reasoning	object	Reasoning effort configuration. Omitted for non-reasoning models and dynamic router models.
data[].supported_parameters	array<string>	List of supported parameters for this model
data[].supported_voices	array \| null	List of supported voice identifiers for TTS models. Null for non-TTS models.
data[].top_provider	object	Information about the top provider for this model
links	object	Pagination links
links.next	string \| null	URL for the next page of results, or null if this is the last page
total_count	integer	Total number of models matching the query