Trinity
Trinity AI

中文

English

中文

English

快速入门 ​

开始使用 Trinity AI ​

Trinity AI 通过 HTTPS + API Key 调用生文、生图、生视频；model 指定 模型广场 ↗ 或 获取模型 中的模型 ID。生文默认走 POST /chat/completions；若客户端已集成 Responses 或 Messages 协议，见 创建 Responses、创建 Messages。视频走 POST /video/generations 异步任务。

根据集成方式，有两种常见路径：

方法最适合
HTTP API完全控制，任意语言，直接发 HTTP 请求
应用场景Cursor、Codex CLI、WorkBuddy 等 IDE / Agent 内配置

重要 · 模型与密钥

  • API Key 前缀一般为 xh-...（从 控制台 · API 密钥 ↗ 创建后完整复制，仅展示一次）。
  • 请求里的 model 填模型 ID（非展示名），须与账号可见列表一致，例如 gpt-5.5。
  • 请勿在公共仓库、前端 bundle 或日志中暴露完整密钥。

INFO

X-Request-Id、X-Idempotency-Key 等追踪/结算头为可选，用于排障与重试幂等，见 API 概述。限额说明见 限流；其他问题见 常见问题。

认证与接入地址 ​

  1. 在 控制台 · API 密钥 ↗ 创建 API Key。
  2. 配置环境变量（生产基址如下；专属部署以交付信息为准）：
bash
export TRINITY_API_KEY="xh-..."
export TRINITY_BASE_URL="https://api.trinitydesk.ai/v1"
typescript
process.env.TRINITY_API_KEY = "xh-...";
process.env.TRINITY_BASE_URL = "https://api.trinitydesk.ai/v1";
python
import os
os.environ["TRINITY_API_KEY"] = "xh-..."
os.environ["TRINITY_BASE_URL"] = "https://api.trinitydesk.ai/v1"

详见 管理 API 密钥。

使用 API ​

最直接的方式：向 {TRINITY_BASE_URL}/chat/completions 发送标准 HTTP POST——兼容任意语言或框架。

下文示例使用 gpt-5.5。请将 model 改为你账号可见的模型 ID（GET /models 或 模型广场 ↗）。

python
import json
import os
import requests

response = requests.post(
    url=f"{os.environ['TRINITY_BASE_URL']}/chat/completions",
    headers={
        "Authorization": f"Bearer {os.environ['TRINITY_API_KEY']}",
        "Content-Type": "application/json",
    },
    data=json.dumps({
        "model": "gpt-5.5",
        "messages": [{"role": "user", "content": "你好"}],
    }),
)
print(response.json()["choices"][0]["message"]["content"])
typescript
const res = await fetch(`${process.env.TRINITY_BASE_URL}/chat/completions`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${process.env.TRINITY_API_KEY}`,
  },
  body: JSON.stringify({
    model: "gpt-5.5",
    messages: [{ role: "user", content: "你好" }],
  }),
});
const data = await res.json();
console.log(data.choices[0]?.message?.content);
bash
curl -sS "${TRINITY_BASE_URL}/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${TRINITY_API_KEY}" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{ "role": "user", "content": "你好" }]
  }'

API 亦支持流式：请求体设置 "stream": true，响应为 SSE，见 流式 SSE。完整字段见 创建对话补全。

下一步 ​

能力指南API
生文（默认）流式输出创建对话补全
生文（Responses）—创建 Responses
生文（Messages）—创建 Messages
图片输入 / 生成多模态图像生成
视频输入 / 生成视频生成创建视频任务
IDE / Agent 配置应用场景Cursor · Codex CLI · WorkBuddy
模型列表—获取模型

© Trinity AI

© Trinity AI