模型列表

介绍

该接口用于获取平台支持的所有AI模型列表，包括平台内置模型和用户自定义模型。开发者可以通过此接口查看当前可用的模型及其基本信息，用于在对话接口中选择合适的模型。

接口定义

接口地址

GET https://api.link-ai.tech/v1/models

请求头

参数	取值	说明
Authorization	Bearer YOUR_API_KEY	参考 接口鉴权说明 创建 API Key 并填入

响应结果示例

{
    "object": "list",
    "data": [
        {
            "id": "claude-4-sonnet",
            "object": "model",
            "created": 1747971346,
            "owned_by": "platform",
            "provider": "Claude"
        },
        {
            "id": "claude-4-opus",
            "object": "model",
            "created": 1747971346,
            "owned_by": "platform",
            "provider": "Claude"
        },
        {
            "id": "o3",
            "object": "model",
            "created": 1748512219,
            "owned_by": "platform",
            "provider": "LinkAI"
        }
    ]
}

响应字段说明：

字段名	类型	说明
id	string	模型的唯一标识符，用于在对话接口中指定模型
object	string	固定值 "model"，表示这是一个模型对象
created	int	模型创建时间的Unix时间戳
owned_by	string	模型所属方，"platform" 表示平台内置，"user" 表示用户自定义模型
provider	string	模型供应商名称，如 "OpenAI"、"Claude"、"LinkAI" 等

注意：

• 返回的模型列表中的 id 字段可直接用于 对话接口 和 记忆对话接口 中的 model 参数
• owned_by 为 "platform" 的模型为平台预置模型，所有用户都可以使用；为 "user" 的模型为用户在平台中自定义配置的模型，仅该用户可以使用

错误说明

当接口异常时会返回以下结构：

{
    "error": {
        "message": "Invalid API key",
        "type": "invalid_request_error"
    }
}

根据 HTTP状态码 (status code) 和错误信息判断错误类型：

HTTP状态码	描述
401	接口鉴权失败，请检查 API Key 是否填写正确
403	无访问权限
503	接口调用异常，联系客服处理

示例代码

1. CURL请求

curl --request GET \
  --url https://api.link-ai.tech/v1/models \
  --header 'Authorization: Bearer YOUR_API_KEY'

注意： 在 YOUR_API_KEY 处填入你创建的 API Key。

2. Python代码请求

import requests

url = "https://api.link-ai.tech/v1/models"
headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}

res = requests.get(url, headers=headers)
if res.status_code == 200:
    res_json = res.json()
    models = res_json.get("data", [])
    print(f"共获取到 {len(models)} 个模型：")
    for model in models:
        print(f"模型ID: {model['id']}, 供应商: {model['provider']}, 所属方: {model['owned_by']}")
else:
    error = res.json().get("error")
    print(f"请求异常, 错误码={res.status_code}, 错误类型={error.get('type')}, 错误信息={error.get('message')}")

注意： 在 YOUR_API_KEY 处填入你创建的 API Key。