图片生成多视图 — Tripo Developers

http

Base URL: https://openapi.tripo3d.ai/v3

Endpoint: POST /generation/image-to-multiview

从单张图像生成多视图图像。可作为多视图转模型的预处理步骤，也可用于转台预览。

注意

此接口需要 API Key 认证。请在 Authorization 请求头中传入 Bearer {api_key}。
此接口为异步 API。提交请求后，请使用任务查询接口轮询获取结果，或配置 Webhook 接收任务完成时的自动通知。

请求参数

请求体

inputstring必选

多视图生成的源图像。接受以下输入类型：

以下方式任选其一，不可同时传入多种类型。

file_token：先通过文件上传 API上传图像，然后传入返回的 token。
示例： file_abc123
URL：可公开访问的图像直链。
示例： https://example.com/character.png

说明

支持格式：PNG、JPEG、WebP
主体应清晰可见，背景保持干净。

示例

基础示例

{
  "input": "https://example.com/character.png"}

创建任务

{
  "code": 0,
  "data": {
    "task_id": "task_abc123"}
}

任务结果

{
  "code": 0,
  "data": {
    "task_id": "task_abc123",
    "status": "success",
    "output": {
      "front_view_url": "https://cdn.tripo3d.ai/front.png",
      "left_view_url": "https://cdn.tripo3d.ai/left.png",
      "back_view_url": "https://cdn.tripo3d.ai/back.png",
      "right_view_url": "https://cdn.tripo3d.ai/right.png"}
  }
}

图像生成多视图

curl --request POST \
  --url https://openapi.tripo3d.ai/v3/generation/image-to-multiview \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "input": "https://example.com/character.png"}'

200响应

{
  "code": 0,
  "data": {
    "task_id": "task_abc123"}
}