SuperAPI AI 工具集

tripo

编程与开发

查看项目

更新于 10-16 07:25

技能介绍

用途:Tripo(VAST 出品)可将文本提示与图片转换为高保真 3D 模型,并通过 API 完成精修、重贴图、风格化、格式转换、动画与后处理,还可查询账户余额。官方文档见 https://platform.tripo3d.ai/docs/introduction。

前提:需在 app.vm0.ai/connectors 连接 Tripo 连接器,连接器注入 TRIPO_API_KEY(tsk_ 前缀),所有请求用 Authorization: Bearer $TRIPO_API_KEY 认证。全部端点基址为 https://api.tripo3d.ai/v2/openapi。

主要能力:文本生成模型(type: text_to_model,可选 negative_prompt、texture、pbr、face_limit、model_version);图片生成模型(image_to_model,需先上传取 file_token,file.type 取 png/jpg/webp,建议分辨率≥256×256);多视图生成模型(multiview_to_model,最多四张正/左/背/右视图 token);精修(refine_model,传 draft_model_task_id);贴图(texture_model);绑定与重定向动画(animate_rig 后接 animate_retarget,如 preset:walk);转换/后处理(convert_model,支持 GLTF、FBX、OBJ、STL、USDZ);余额查询 GET /wallet。

使用方式:均为异步任务——先 POST /task 提交,响应为 {"code":0,"data":{"task_id":"..."}},再轮询 GET /task/<task-id>,status 为 queued、running 属进行中,success、failed、banned、expired、cancelled 属最终态;成功后 data.output 提供结果 URL,随后用 curl -L 下载。上传用 POST /upload/sts(或 POST /upload)获取 file_token,不能直接传原始 URL。

限制与注意:输出 URL 在任务成功后 5 分钟过期,须立即持久化;每次生成消耗账户点数,大批量前先查 /wallet 并在 Tripo 计费面板充值;banned 表示提示词或图片违反内容政策;failed/expired 可重试,若反复出现需向 Tripo 支持反馈 task_id。连接器排障可运行 zero doctor check-connector --env-name TRIPO_API_KEY,或 zero doctor check-connector --url https://api.tripo3d.ai/v2/openapi/wallet --method GET。具体价格、模型版本清单等资料未提供。