Trinity
Trinity AI

中文

English

中文

English

API 概述 ​

通过 HTTPS + API Key 调用生文、生图、生视频。在请求体中用 model 指定模型 ID，网关完成鉴权与路由。

服务地区：不对中国大陆提供服务。见 服务地区。

基址 ​

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

除 Gemini 原生接口外，路径均相对于含 /v1 的 base（示例：POST {TRINITY_BASE_URL}/chat/completions）。Gemini generateContent 使用 API Host https://api.trinitydesk.ai 与 /v1beta/... 路径，见 创建 Gemini Content。

鉴权 ​

每个请求须携带：

http
Authorization: Bearer <TRINITY_API_KEY>
Content-Type: application/json
  • API Key 在 控制台 创建，前缀一般为 xh-...（详见 管理 API 密钥）。
  • 环境变量里只存 Key 本体，不要带 Bearer 前缀。

追踪与结算（请求头） ​

适用于生文类 POST（含流式、含 Gemini Content）及生图 POST /chat/completions、POST /images/generations、POST /images/edits。

请求头必填作用
X-Request-Id否追踪 ID，排障与日志关联；最长 128 字符；未传时服务端生成
X-Idempotency-Key否结算幂等键；同 workspace 内相同键仅首笔成功扣费；重试须保持不变
X-Conversation-Id否会话分组 ID；多轮对话建议固定传同一值；最长 128 字符
X-Session-Id否X-Conversation-Id 别名；仅当未传后者时生效

响应（含 SSE）回写：X-Request-Id、X-Settlement-Key；传入 X-Conversation-Id 时回写该头。

计费

不传 X-Idempotency-Key 时，每次 HTTP 调用独立计费。网络超时后重放同一笔业务，应固定结算键，追踪 ID 可更换。

能力一览 ​

能力方法路径
获取模型GET/models
对话补全（生文）POST/chat/completions
Responses（生文）POST/responses
Messages（生文）POST/messages
Gemini Content（生文）POST/v1beta/models/{model}:generateContent · :streamGenerateContent
图像生成（Images）POST/images/generations
图像编辑（Images）POST/images/edits
图像生成（统一契约）POST/chat/completions + modalities / image_config
查询生图任务GET/image/tasks/{taskId}
创建视频任务POST/video/generations
查询视频任务GET/video/tasks/{taskId}
登记视频素材POST/video/assets
查询视频素材GET/video/assets/{assetId}
实时音频 client_secretsPOST/realtime/client_secrets
实时音频 WebRTCPOST/realtime/calls
实时音频 usage 上报POST/realtime/usage
实时音频 WebSocketUpgrade/realtime?model=
Gemini Live 同声传译Upgrade/ws/google.ai.generativelanguage.v1beta.GenerativeService.BidiGenerateContent
Gemini Live 同声传译（平台）Upgrade/realtime?model=gemini-3.5-live-translate-preview
联网搜索POST/web_search
路径适用场景
/chat/completions文本、工具、多模态输入；生图统一契约（modalities / image_config）
/images/generationsOpenAI / Azure Images 文生图形态
/images/editsOpenAI / Azure Images 改图形态（multipart）
/responses客户端按 Responses 协议组装请求
/messages客户端按 Anthropic Messages 协议组装请求
/v1beta/models/{model}:generateContent客户端按 Gemini generateContent 协议组装请求

同一模型不一定支持全部路径。可用模型 ID 见 GET /models 或 模型广场。

生图有两条路径：Images 兼容见 创建图像（Images）、编辑图像（Images）；统一契约见 创建图像生成（chat）。

模型 ID ​

请求体 model（或 Gemini Content 路径参数 {model}）填模型 ID（非展示名）。示例：

模态示例 ID
生文gpt-5.5、claude-sonnet-4-6、gemini-2.5-flash
生图gpt-image-2、gemini-2.5-flash-image、Hunyuan-3.0、OG-image2-medium
生视频kling-2.6
音频gpt-realtime-2.1、gemini-3.5-live-translate-preview

查询方式：GET /models（可选 ?modality=text|image|video|audio|all）或 模型广场。

价目与折扣

公开价目见模型列表与广场展示。企业折扣、专属价目请联系我们（控制台工单或您的客户成功经理）。

响应与错误 ​

  • 成功：JSON，或 stream: true 时的 SSE（text/event-stream）。
  • 失败：error 对象，含 message、type、code — 见 错误与调试。

相关 ​

© Trinity AI

© Trinity AI