获取模型

拉取当前 API Key 可用的已上架模型。返回列表中的 id 即后续请求的模型 ID。

也可在 模型广场 浏览。

---

Endpoint

Method	URL
GET	{TRINITY_BASE_URL}/models

---

Base URL

项	值
Base URL	https://api.trinitydesk.ai/v1
协议	HTTPS

export TRINITY_BASE_URL="https://api.trinitydesk.ai/v1"
export TRINITY_API_KEY="xh-..."

---

Headers

Header	必填	说明
Authorization	是	Bearer <TRINITY_API_KEY>
Accept	否	application/json

---

请求示例

curl -sS "${TRINITY_BASE_URL}/models" \
  -H "Authorization: Bearer ${TRINITY_API_KEY}"

curl -sS "${TRINITY_BASE_URL}/models?modality=image" \
  -H "Authorization: Bearer ${TRINITY_API_KEY}"

---

请求参数

参数	位置	必填	说明
modality	query	否	text（省略时默认）、image、video、all

更多字段见 获取模型 · 高级参数。

---

返回字段

字段	说明
object	固定 "list"
data	模型数组
data[].id	模型 ID
data[].created	integer，模型上架时间（Unix 时间戳，秒）
data[].owned_by	原研发方标识，如 openai、anthropic
data[].metadata	上下文长度、展示价等

---

返回示例

{
  "object": "list",
  "data": [
    {
      "id": "gpt-5.5",
      "object": "model",
      "created": 1700000000,
      "owned_by": "trinity",
      "metadata": {
        "context_length": 128000,
        "user_input_price_per_million_usd": 0.15,
        "user_output_price_per_million_usd": 0.60
      }
    }
  ]
}

错误见 错误与调试。

---

Python 示例

import os
import requests

r = requests.get(
    f"{os.environ['TRINITY_BASE_URL']}/models",
    headers={"Authorization": f"Bearer {os.environ['TRINITY_API_KEY']}"},
    params={"modality": "text"},
    timeout=60,
)
r.raise_for_status()
for m in r.json()["data"]:
    print(m["id"])

---

相关

• 获取模型 · 高级参数
• 创建对话补全
• 创建图像生成
• 创建视频生成任务
• 错误与调试