​
接口说明

GET /v1/models 用于获取当前 API Key 可访问的模型列表。你可以用它确认模型 ID 是否可用，也可以在接入工具、模型选择器或后台配置页中动态展示模型。
模型列表可能会随账号权限、模型上下架和服务配置变化。业务侧应以接口实时返回为准，不建议在客户端长期写死模型清单。

​
请求地址

GET https://api.nonelinear.com/v1/models

​
鉴权

在请求头中传入 API Key： 
Authorization: Bearer <NONELINEAR_API_KEY>

​
查询参数

当前接口不需要传查询参数，会返回当前 API Key 可访问的全部模型。
如果业务侧需要按文本、图像、视频、Embedding 等类型展示模型，建议先拉取完整列表，再结合平台模型列表或业务自己的模型分类表进行筛选。不要依赖客户端长期写死模型清单。

​
cURL 示例

​
获取全部模型

curl --request GET \
  --url "https://api.nonelinear.com/v1/models" \
  --header "Authorization: Bearer $NONELINEAR_API_KEY"

​
Python 示例

​
使用 requests

import os
import requests

api_key = os.getenv("NONELINEAR_API_KEY")

response = requests.get(
    "https://api.nonelinear.com/v1/models",
    headers={"Authorization": f"Bearer {api_key}"},
    timeout=30,
)
response.raise_for_status()

models = response.json()["data"]
for model in models:
    print(model["id"])

​
使用 OpenAI Python SDK

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("NONELINEAR_API_KEY"),
    base_url="https://api.nonelinear.com/v1",
)

models = client.models.list()
for model in models.data:
    print(model.id)

​
响应示例

{
  "object": "list",
  "data": [
    {
      "id": "deepseek-v4-flash",
      "object": "model",
      "created": 0,
      "owned_by": "nonelinear"
    },
    {
      "id": "gemini-2.5-flash-image",
      "object": "model",
      "created": 0,
      "owned_by": "nonelinear"
    }
  ]
}

​
响应字段

字段类型说明
objectstring固定为 list，表示返回的是列表对象。
dataarray模型对象数组。
data[].idstring模型 ID。调用对话、图像、视频等接口时填入 model 字段。
data[].objectstring对象类型，通常为 model。
data[].createdinteger模型创建时间或占位时间戳，以接口返回为准。
data[].owned_bystring模型归属方或提供方，以接口返回为准。

​
常见用途

  1. 接入前确认模型 ID 是否存在，例如 deepseek-v4-flash、gpt-5.4-mini、gemini-2.5-flash-image。
  2. 在工具配置页里动态拉取模型列表，避免模型上下架后仍展示旧模型。
  3. 配合业务侧模型分类表生成模型选择器，减少客户把文本模型误填到图像、视频或 Embedding 接口的概率。

​
错误排查

状态码常见原因处理建议
401API Key 缺失或无效。确认 Authorization: Bearer <API Key> 是否正确。
403当前账号无权限访问。检查账号权限或联系管理员开通。
404接口路径错误。确认请求地址为 /v1/models。
429请求过于频繁。降低请求频率并重试。
503 / 504服务暂时不可用或超时。稍后重试，必要时记录请求时间并反馈给技术支持。