OpenAI

列出模型

列出当前可调用的模型。

GET /openai/v1/models● 支持

OpenAI 官方文档 ↗

请求参数

  • offsetinteger可选
    默认 0

    query: Number of records to skip for pagination. When both offset and limit are omitted, the full list is returned

    已验证生效。

  • limitinteger可选

    query: Maximum number of records to return (max 1000). When both offset and limit are omitted, the full list is returned

    已验证生效。

  • categorystring可选○ 当前不生效

    query: Filter models by use case category

    接受但当前不生效。当前不会按此条件过滤或排序模型。

    取值 programmingroleplaymarketingmarketing/seotechnologysciencetranslationlegalfinancehealthtriviaacademia
  • supported_parametersstring可选○ 当前不生效

    query: Filter models by supported parameter (comma-separated)

    接受但当前不生效。当前不会按此条件过滤或排序模型。

  • 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.

    已验证生效。

  • 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.

    已验证生效。

    取值 newestprice_low
  • qstring可选

    query: Free-text search by model name or slug.

    已验证生效。

  • input_modalitiesstring可选○ 当前不生效

    query: Filter models by input modality. Comma-separated list of: text, image, audio, file.

    接受但当前不生效。当前不会按此条件过滤或排序模型。

  • contextinteger可选○ 当前不生效

    query: Minimum context length (tokens). Models with smaller context are excluded.

    接受但当前不生效。当前不会按此条件过滤或排序模型。

  • min_pricenumber可选○ 当前不生效

    query: Minimum prompt price in $/M tokens.

    接受但当前不生效。当前不会按此条件过滤或排序模型。

  • ▸ 更多参数(20)
    • max_pricenumber可选○ 当前不生效

      query: Maximum prompt price in $/M tokens.

      接受但当前不生效。当前不会按此条件过滤或排序模型。

    • archstring可选○ 当前不生效

      query: Filter models by architecture/model family (e.g. GPT, Claude, Gemini, Llama).

      接受但当前不生效。当前不会按此条件过滤或排序模型。

    • model_authorsstring可选○ 当前不生效

      query: Filter models by the organization that created the model. Comma-separated list of author slugs.

      接受但当前不生效。当前不会按此条件过滤或排序模型。

    • providersstring可选○ 当前不生效

      query: Filter models by hosting provider. Comma-separated list of provider names.

      接受但当前不生效。当前不会按此条件过滤或排序模型。

    • distillablestring可选○ 当前不生效

      query: Filter by distillation capability. "true" returns only distillable models, "false" excludes them.

      接受但当前不生效。当前不会按此条件过滤或排序模型。

      取值 truefalse
    • zdrstring可选○ 当前不生效

      query: When set to "true", return only models with zero data retention endpoints.

      接受但当前不生效。当前不会按此条件过滤或排序模型。

      取值 true
    • regionstring可选○ 当前不生效

      query: Filter to models with endpoints in the given data region ("eu" or "us").

      接受但当前不生效。当前不会按此条件过滤或排序模型。

      取值 euus
    • min_output_pricenumber可选○ 当前不生效

      query: Minimum completion (output) price in $/M tokens.

      接受但当前不生效。当前不会按此条件过滤或排序模型。

    • max_output_pricenumber可选○ 当前不生效

      query: Maximum completion (output) price in $/M tokens.

      接受但当前不生效。当前不会按此条件过滤或排序模型。

    • min_age_daysinteger可选○ 当前不生效

      query: Minimum model age in days since its creation date.

      接受但当前不生效。当前不会按此条件过滤或排序模型。

    • max_age_daysinteger可选○ 当前不生效

      query: Maximum model age in days since its creation date.

      接受但当前不生效。当前不会按此条件过滤或排序模型。

    • min_intelligence_indexnumber可选○ 当前不生效

      query: Minimum Artificial Analysis intelligence index.

      接受但当前不生效。当前不会按此条件过滤或排序模型。

    • max_intelligence_indexnumber可选○ 当前不生效

      query: Maximum Artificial Analysis intelligence index.

      接受但当前不生效。当前不会按此条件过滤或排序模型。

    • min_coding_indexnumber可选○ 当前不生效

      query: Minimum Artificial Analysis coding index.

      接受但当前不生效。当前不会按此条件过滤或排序模型。

    • max_coding_indexnumber可选○ 当前不生效

      query: Maximum Artificial Analysis coding index.

      接受但当前不生效。当前不会按此条件过滤或排序模型。

    • min_agentic_indexnumber可选○ 当前不生效

      query: Minimum Artificial Analysis agentic index.

      接受但当前不生效。当前不会按此条件过滤或排序模型。

    • max_agentic_indexnumber可选○ 当前不生效

      query: Maximum Artificial Analysis agentic index.

      接受但当前不生效。当前不会按此条件过滤或排序模型。

    • min_tool_success_ratenumber可选○ 当前不生效

      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).

      接受但当前不生效。当前不会按此条件过滤或排序模型。

    • max_tool_success_ratenumber可选○ 当前不生效

      query: Maximum tool-calling success rate, as a fraction in [0, 1].

      接受但当前不生效。当前不会按此条件过滤或排序模型。

    • 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.

      按声明的 OpenAI 协议筛选,逗号分隔匹配任一协议族,在分页前生效。

返回

200 list

错误按 OpenAI 格式返回,参见 错误码

响应

HTTP 200

Returns a list of models or RSS feed

application/json

名称类型说明
dataarray<object>List of available models
data[].alias_targetobjectConcrete model targeted by this tilde-latest alias, when applicable
data[].architectureobjectModel architecture information
data[].benchmarksobjectThird-party benchmark rankings for this model. Omitted when no benchmark data is available.
data[].canonical_slugstringCanonical slug for the model
data[].context_lengthinteger | nullMaximum context length in tokens
data[].createdintegerUnix timestamp of when the model was created
data[].default_parametersobject | nullDefault parameters for this model
data[].descriptionstringDescription of the model
data[].expiration_datestring | nullThe date after which the model may be removed. ISO 8601 date string (YYYY-MM-DD) or null if no expiration.
data[].hugging_face_idstring | nullHugging Face model identifier, if applicable
data[].idstringUnique identifier for the model
data[].knowledge_cutoffstring | nullThe date up to which the model was trained on data. ISO 8601 date string (YYYY-MM-DD) or null if unknown.
data[].linksobjectRelated API endpoints and resources for this model.
data[].namestringDisplay name of the model
data[].per_request_limitsobject | nullPer-request token limits
data[].pricingobjectPricing information for the model
data[].reasoningobjectReasoning effort configuration. Omitted for non-reasoning models and dynamic router models.
data[].supported_parametersarray<string>List of supported parameters for this model
data[].supported_voicesarray | nullList of supported voice identifiers for TTS models. Null for non-TTS models.
data[].top_providerobjectInformation about the top provider for this model
linksobjectPagination links
links.nextstring | nullURL for the next page of results, or null if this is the last page
total_countintegerTotal number of models matching the query