快速开始

快速开始

API

MCP 服务

MCP 服务

用 Model Context Protocol 将 AI Agent 连接到 Trellis 2

MCP 服务

Trellis 2 提供了 Model Context Protocol (MCP) 服务,让 AI Agent——Claude Code、Cursor、Codex CLI、Windsurf 以及任何兼容 MCP 的客户端——可以在对话中直接生成 3D 模型。

MCP 服务复用你现有的 API Key 和积分,无需单独注册。

  • 服务地址: https://trellis2.app/api/mcp
  • 传输协议: Streamable HTTP(无状态)
  • 认证方式: Authorization: Bearer tr_...(与 REST API 同一把 Key)

快速开始

在 设置 → API Keys 创建 API Key。

在 Agent 中注册服务。以 Claude Code 为例:

claude mcp add trellis2 --transport http https://trellis2.app/api/mcp \
  --header "Authorization: Bearer tr_你的key"

其他客户端把同样的 URL 和 Header 加进各自的 MCP 配置即可。标准 JSON 格式:

{
  "mcpServers": {
    "trellis2": {
      "type": "http",
      "url": "https://trellis2.app/api/mcp",
      "headers": {
        "Authorization": "Bearer tr_你的key"
      }
    }
  }
}

对 Agent 说:"列出可用的 3D 模型"——Agent 会调用 list_models,连接即已打通。

工具

工具功能
list_models列出可用的 3D 生成模型,含积分成本与能力标签
generate_3d_model从图片 URL 或文本提示发起 3D 生成任务,原子预扣积分
get_task轮询任务状态与进度;完成后返回网格 / 贴图 / 预览的下载地址

典型流程:list_models → generate_3d_model → 轮询 get_task 直到 COMPLETED → 从输出地址下载模型。

生成失败会自动退还积分——与 REST API 同样的保障。

快速开始

Trellis 2 API 入门指南

API 概览

3D 模型生成器 API — 通过编程方式实现图片转 3D 模型

目录

MCP 服务
快速开始
工具