Creative Lab 公仔人偶 API

通过两个阶段，将一张照片转换为大头公仔收藏品 3D 人偶。prototype 任务会根据照片生成一张概念图像。build 任务会将该图像转换为带纹理的 3D 模型，并将 prototype 任务的 ID 作为 input_task_id。

POST /openapi/creative-lab/vinyl-figure/v1/prototype
POST /openapi/creative-lab/vinyl-figure/v1/build

POST/openapi/creative-lab/vinyl-figure/v1/prototype

创建 Vinyl Figure prototype 任务

根据一张照片生成一张 vinyl-figure 风格的概念图。要构建 3D 模型，请将此任务的 ID 作为 input_task_id 传递给 build endpoint。有关该任务字段的说明，请参阅 Vinyl Figure prototype 任务对象。

Request

POST

/openapi/creative-lab/vinyl-figure/v1/prototype

# Stage 1: generate a vinyl-figure-style concept image
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_url": "<your publicly accessible image url or base64-encoded data URI>"
  }'

Response

{
  "result": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de"
}

Prototype example

Start with a source photo, then generate the prototype image used by the build stage.

Source photo used as the Creative Lab Vinyl Figure input — Prototype input

Big-head vinyl figure prototype image generated from the source photo — Prototype output

参数

Name
image_url
Type
string
必选
Description
要转换为大头 vinyl figure 的照片，可以是公开可访问的 URL，也可以是 data URI（data:image/jpeg;base64,<your base64-encoded image data>）。
图片必须是 JPG、JPEG、PNG 或 WebP 文件，且不超过 20 MB。
Name
name
Type
string
Description
任务的名称，最多 100 个字符。该名称会在任务的 name 字段中返回。名称过长会返回 400。
Name
remove_background
Type
boolean
默认值 false
Description
是否从 prototype 图像中移除背景。true 会返回透明的 RGBA PNG，这样你就可以把主体放到任意背景上。build 阶段也会以去除背景后的图像为起点。如果 Meshy 无法移除背景，它会返回带有背景的图像，任务仍然会成功。

返回值

result 字段保存新 prototype 任务的 ID。获取任务或流式获取任务，直到 status 变为 SUCCEEDED。然后将该 ID 作为 input_task_id 传递给 build endpoint。

失败情况

Name
400 - Bad Request
Description
请求无法执行。例如：
- 缺少 image_url。
- 图片不是 JPG、JPEG、PNG 或 WebP 文件。
- 图片过小、超过 20 MB，或超过最大像素数限制。
- Meshy 无法下载该图片，例如 URL 返回 404 或超时。
- data URI 不是有效的 base64 编码。
- 该图片被标记为 NSFW。
错误信息会说明具体发现的问题。修复请求后重新发送。
Name
401 - Unauthorized
Description
API key 缺失或无效。请检查 Authorization 请求头。
Name
402 - Payment Required
Description
以下情况之一适用：
- 账户的积分不足。
- API key、workspace 或成员已达到其积分限额。
- 账户使用的是免费套餐。
请检查你的积分和套餐，然后重试。
Name
403 - Forbidden
Description
你的团队开启了 IP Filtering，Meshy 将该图片标记为涉及第三方知识产权。请发送你拥有使用权的图片。
Name
429 - Too Many Requests
Description
达到了以下某个限制：
- 你发送的请求超出了速率限制所允许的数量。请等待几秒钟后重试。参见 Rate limits。
- 你排队或正在运行的任务过多。请等待部分任务完成后重试。
- 在没有积分的无限量套餐下，已达到可在无积分情况下运行的任务数量上限。请等待某个任务完成，或增加积分。
Name
500 - Internal Server Error
Description
Meshy 遇到了服务器错误，例如无法对图片执行知识产权检查。Meshy 不会创建该任务，并会退还已扣除的任何积分。请重试该请求。

POST/openapi/creative-lab/vinyl-figure/v1/build

创建一个 Vinyl Figure 构建任务

根据一个成功的原型任务生成带贴图的 3D vinyl figure。有关其字段，请参阅 Vinyl Figure 构建任务对象。

Request

POST

/openapi/creative-lab/vinyl-figure/v1/build

# Stage 2: chain build off a succeeded prototype task
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "input_task_id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de"
  }'

Response

{
  "result": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef"
}

参数

Name
input_task_id
Type
string
必选
Description
要构建的原型任务的 ID。它必须是你的账户使用 POST /openapi/creative-lab/vinyl-figure/v1/prototype 创建的任务，且其状态为 SUCCEEDED。
如果该 ID 不是来自 API 的 Vinyl Figure 原型任务之一，将返回 404，这也包括在 web 应用中创建的原型。
Name
name
Type
string
Description
任务的名称，最多 100 个字符。它会在任务的 name 字段中返回。超长的名称会返回 400。

返回值

result 字段保存新构建任务的 ID。获取该任务或对其进行流式获取，直到 status 为 SUCCEEDED。然后从 model_urls.glb 下载带贴图的 GLB。若需要 OBJ，则从 model_urls.obj 下载，并从 model_urls.mtl 下载其 material 文件。

失败模式

Name
400 - Bad Request
Description
请求无法执行。例如：
- input_task_id 缺失或不是有效的任务 ID。
- 原型任务的状态不是 SUCCEEDED。如果它仍在运行，请等待后重试。如果它失败或被取消，请创建一个新的原型任务。
- 原型任务成功了，但没有图像。请创建一个新的原型任务。
错误消息会说明发现了哪种问题。
Name
401 - Unauthorized
Description
API key 缺失或无效。请检查 Authorization 请求头。
Name
402 - Payment Required
Description
以下情况之一适用：
- 账户没有足够的积分。
- 该 API key、workspace 或成员已达到其积分限额。
- 该账户处于免费套餐。
请检查你的积分和套餐，然后重试。
Name
404 - Not Found
Description
input_task_id 与你的账户通过 API 创建的任何 Vinyl Figure 原型任务都不匹配。在 web 应用中创建的原型也会返回 404。请发送来自原型创建响应中的 result ID。
Name
429 - Too Many Requests
Description
达到了以下限制之一：
- 你发送的请求超过了速率限制允许的数量。请等待几秒钟后重试。参见速率限制。
- 你排队或正在运行的任务过多。请等待部分任务完成后重试。
- 在无限套餐下且积分已用完的情况下，你已达到了无需积分即可运行的任务数量上限。请等待某个任务完成，或添加积分。

GET/openapi/creative-lab/vinyl-figure/v1/(prototype|build)/:id

获取 Vinyl Figure 任务

返回一个 prototype 或 build 任务。路径必须与任务所处的阶段相匹配。通过 /prototype/:id 请求一个 build 任务会返回 404，通过 /build/:id 请求一个 prototype 任务同样会返回 404。

关于字段说明，请参阅 Vinyl Figure prototype 任务对象和 Vinyl Figure build 任务对象。

Request

GET

/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de

# Prototype
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# Build
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Prototype Response

{
  "id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de",
  "type": "creative-lab-vinyl-figure-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969600000,
  "started_at": 1752969604000,
  "finished_at": 1752969630000,
  "expires_at": 1753228830000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Build Response

{
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "type": "creative-lab-vinyl-figure-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969700000,
  "started_at": 1752969710000,
  "finished_at": 1752969735000,
  "expires_at": 1753228935000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 30,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/texture_0.png?Expires=***"
    }
  ]
}

参数

Name
id
Type
path
Description
创建响应中返回的任务 ID。

返回值

与路径所示阶段相匹配的 prototype 任务对象或 build 任务对象。

失败模式

Name
400 - Bad Request
Description
id 不是有效的任务 ID。请使用创建响应中返回的 result ID。
Name
403 - Forbidden
Description
你的团队已开启 IP Filtering，且 Meshy 将该任务的图像标记为涉及第三方知识产权。使用 Enterprise 方案的团队不会收到此错误。请使用你拥有使用权的图像来创建 prototype 任务。
Name
404 - Not Found
Description
你的账户下没有此 ID 对应的 Vinyl Figure 任务，或该任务所处的阶段与路径不匹配。请检查 ID，并使用 /prototype 或 /build 来匹配该任务。
Name
500 - Internal Server Error
Description
Meshy 无法运行知识产权检查。请重试请求。

DELETE/openapi/creative-lab/vinyl-figure/v1/(prototype|build)/:id

删除 Vinyl Figure 任务

取消一个 Vinyl Figure 任务。取消 PENDING 任务会退还其积分。IN_PROGRESS 任务被取消时不会退款，因为已有工作进程开始处理该任务。处于最终状态（SUCCEEDED、FAILED 或 CANCELED）的任务无法取消。

路径必须与任务所处的阶段相匹配。例如，使用构建任务的 ID 对 /prototype/:id 执行 DELETE 操作会返回 404。

Request

DELETE

/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de

curl --request DELETE \
  --url https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// Returns 204 No Content on success (empty body).

路径参数

Name
id
Type
path
Description
要取消的任务的 ID。

返回值

204 No Content，响应体为空。

失败情况

Name
400 - Bad Request
Description
以下情况之一适用：
- id 不是有效的任务 ID。请发送创建响应中的 result ID。
- 该任务已处于最终状态（SUCCEEDED、FAILED 或 CANCELED），因此无法取消。
Name
404 - Not Found
Description
你的账户下没有此 ID 对应的 Vinyl Figure 任务，或该任务所处的阶段与路径不匹配。请检查 ID，并使用 /prototype 或 /build 来匹配该任务。

GET/openapi/creative-lab/vinyl-figure/v1/(prototype|build)/:id/stream

以流式方式获取 Vinyl Figure 任务

以服务器发送事件（SSE）的形式流式传输 Vinyl Figure 任务的更新。路径必须与任务所处的阶段相匹配。如果不匹配，例如将一个 build 任务的 ID 用于 /prototype/:id/stream，流会发送一个 status_code: 404 的 error 事件，然后关闭连接。

Request

GET

/openapi/creative-lab/vinyl-figure/v1/build/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/stream

curl -N https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Error event example (wrong stage or task not found)
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Message event examples illustrate task progress.
// Every frame is the full task object; fields not yet populated are null / empty.
// The following PENDING frame is shortened to the fields that change.
event: message
data: {
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "type": "creative-lab-vinyl-figure-build",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969700000,
  "started_at": 1752969710000,
  "finished_at": 1752969735000,
  "expires_at": 1753228935000,
  "task_error": null,
  "consumed_credits": 30,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/texture_0.png?Expires=***"
    }
  ]
}

参数

Name
id
Type
path
Description
创建响应中返回的任务 ID。

返回值

一个 prototype 或 build 任务对象的流。每个事件都携带完整的任务对象，与获取 Vinyl Figure 任务返回的内容一致。当任务处于 PENDING 或 IN_PROGRESS 状态时，其输出字段仍为空（null、[] 或 {}），finished_at 为 null。

如果IP 过滤功能拦截了任务的结果，流会在该位置发送一个 error 事件，其中的 status_code 与直接发起 get 请求时会返回的状态码相同。

GET/openapi/creative-lab/vinyl-figure/v1/(prototype|build)

列出 Vinyl Figure 任务

返回你某个阶段的 Vinyl Figure 任务，一次返回一页。路径决定了阶段：/prototype 仅返回 prototype 任务，/build 仅返回 build 任务。

Request

GET

/openapi/creative-lab/vinyl-figure/v1/prototype

# List prototype tasks
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# List build tasks
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response (List Prototype Tasks)

[
  {
    "id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de",
    "type": "creative-lab-vinyl-figure-prototype",
    "name": "",
    "status": "SUCCEEDED",
    "progress": 100,
    "created_at": 1752969600000,
    "started_at": 1752969604000,
    "finished_at": 1752969630000,
    "expires_at": 1753228830000,
    "preceding_tasks": 0,
    "task_error": null,
    "consumed_credits": 6,
    "image_urls": [
      "https://assets.meshy.ai/***/concept.png?Expires=***"
    ]
  }
]

路径参数

Name
stage
Type
path
必选
Description
要列出的阶段，prototype 或 build。

查询参数

Name
page_num
Type
integer
默认值 1
Description
要返回的页码，范围为 1 到 255。0 返回第一页。超出 0 到 255 范围的值将返回 400。
Name
page_size
Type
integer
默认值 10
Description
每页任务数量，最多 100。101 到 255 之间的值将返回 100 个任务，0 则使用默认值。超出 0 到 255 范围的值将返回 400。
Name
sort_by
Type
string
默认值 -created_at
Description
排序方式。
可用值：
- -created_at：最新的排在前面
- +created_at：最旧的排在前面

返回值

一个数组，包含与路径中阶段相匹配的 prototype 任务对象或build 任务对象。

The Vinyl Figure prototype task object

prototype 任务会根据照片生成 vinyl-figure 风格的概念图。要将图像转换为 3D 模型，请将该任务的 ID 作为 input_task_id 传递给build endpoint。

属性

Example Vinyl Figure Prototype Task Object

{
  "id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de",
  "type": "creative-lab-vinyl-figure-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969600000,
  "started_at": 1752969604000,
  "finished_at": 1752969630000,
  "expires_at": 1753228830000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Name
id
Type
string
Description
任务 ID。不要依赖其格式。
Name
type
Type
string
Description
任务类型，始终为 creative-lab-vinyl-figure-prototype。
Name
name
Type
string
Description
你在创建任务时发送的 name，如果没有发送则为 ""。
Name
status
Type
string
Description
任务的状态。
可用取值：
- PENDING：在队列中等待
- IN_PROGRESS：正在生成结果
- SUCCEEDED：最终状态，附带结果
- FAILED：最终状态，失败原因在 task_error 中
- CANCELED：最终状态，没有结果
Name
progress
Type
integer
Description
已完成工作的百分比，范围从 0 到 100。在任务开始之前为 0，成功后为 100。
Name
created_at
Type
timestamp
Description
任务创建的时间，以 Unix 毫秒表示。
Name
started_at
Type
timestamp
Description
工作进程开始处理任务的时间，以 Unix 毫秒表示。在此之前为 null。
Name
finished_at
Type
timestamp
Description
任务达到最终状态的时间，以 Unix 毫秒表示。在此之前为 null。
Name
expires_at
Type
timestamp
Description
任务结果过期的时间，以 Unix 毫秒表示。该时间为 finished_at 之后 3 天，或在任务完成之前为 created_at 之后 3 天。对于会无限期保留 API 结果的企业版账户，该时间约为之后 100 年。参见资产保留期。
Name
preceding_tasks
Type
integer
Description
任务处于 PENDING 状态时在队列中的位置。1 表示它将是下一个开始的任务。任务离开队列后为 0，在列表结果中始终为 0。
Name
task_error
Type
object
Description
任务失败的原因。除非 status 为 FAILED，否则为 null。参见 Errors。
Name
consumed_credits
Type
integer
Description
该任务在退款之后所扣除的积分数量。返回错误的请求不会被扣费。失败的任务为 0，因为 Meshy 会对其进行退款。只有在任务处于 PENDING 状态时取消才会退款。如果 Meshy 无法读取扣费信息，get 或 stream 响应中将不包含该字段，而 list 请求会返回 500。这种情况下，请重试该请求。
Name
image_urls
Type
array of strings
Description
概念图的下载链接。任务成功后，该数组中会有一个 URL，在此之前为空数组。

Vinyl Figure 构建任务对象

构建任务会根据成功的原型任务生成带贴图的 3D vinyl figure。其 model_urls、thumbnail_url 和 texture_urls 字段的格式与 Image to 3D 任务对象中的相同。

属性

Example Vinyl Figure Build Task Object

{
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "type": "creative-lab-vinyl-figure-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969700000,
  "started_at": 1752969710000,
  "finished_at": 1752969735000,
  "expires_at": 1753228935000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 30,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/texture_0.png?Expires=***"
    }
  ]
}

Name
id
Type
string
Description
任务 ID。请勿依赖其格式。
Name
type
Type
string
Description
任务类型，始终为 creative-lab-vinyl-figure-build。
Name
name
Type
string
Description
你在创建任务时发送的 name，如果未发送，则为 ""。
Name
status
Type
string
Description
任务的状态。
可用取值：
- PENDING：在队列中等待
- IN_PROGRESS：正在生成结果
- SUCCEEDED：最终状态，附带结果
- FAILED：最终状态，原因见 task_error
- CANCELED：最终状态，无结果
Name
progress
Type
integer
Description
已完成工作的百分比，范围从 0 到 100。任务开始前为 0，成功后为 100。
Name
created_at
Type
timestamp
Description
任务创建的时间，以 Unix 毫秒表示。
Name
started_at
Type
timestamp
Description
工作进程开始处理该任务的时间，以 Unix 毫秒表示。在此之前为 null。
Name
finished_at
Type
timestamp
Description
任务到达最终状态的时间，以 Unix 毫秒表示。在此之前为 null。
Name
expires_at
Type
timestamp
Description
任务结果过期的时间，以 Unix 毫秒表示。它是 finished_at 之后的 3 天，或者在任务完成之前是 created_at 之后的 3 天。对于会无限期保留 API 结果的企业版账户，这个时间约为 100 年之后。请参阅资产保留期。
Name
preceding_tasks
Type
integer
Description
任务处于 PENDING 状态时在队列中的位置。1 表示它将是下一个开始的任务。任务离开队列后为 0，在列表结果中始终为 0。
Name
task_error
Type
object
Description
任务失败的原因。除非 status 为 FAILED，否则为 null。请参阅错误。
Name
consumed_credits
Type
integer
Description
扣除任何退款后，该任务实际扣取的积分数量。返回错误的请求不会被扣费。失败的任务为 0，因为 Meshy 会对其进行退款。取消任务仅在其处于 PENDING 状态时才会退款。如果 Meshy 无法读取扣费信息，get 或 stream 响应会省略该字段，而 list 请求会返回 500。在这种情况下，请重试该请求。
Name
prompt
Type
string
Description
对于 Vinyl Figure 构建任务，始终为 ""。
Name
negative_prompt
Type
string
Description
对于 Vinyl Figure 构建任务，与 prompt 一样，始终为 ""。
Name
texture_prompt
Type
string
Description
对于 Vinyl Figure 构建任务，与 prompt 一样，始终为 ""。
Name
texture_image_url
Type
string
Description
对于 Vinyl Figure 构建任务，与 prompt 一样，始终为 ""。
Name
model_urls
Type
object
Description
3D 模型的下载 URL，分别为带贴图的 GLB 文件，以及附带 MTL 文件的 OBJ 文件。
- Name
  glb
  Type
  string
  Description
  带贴图的 GLB 文件的下载 URL。
- Name
  obj
  Type
  string
  Description
  OBJ 文件的下载 URL，包含 geometry 和 UV。
- Name
  mtl
  Type
  string
  Description
  与 obj 配套使用的 MTL material 文件的下载 URL。请将其与 obj 以及 texture_urls[0].base_color 中的 texture 一起使用。
Name
thumbnail_url
Type
string
Description
模型预览图片的下载 URL。
Name
texture_urls
Type
array
Description
贴图集合，是一个包含单个对象的数组，该对象保存基础颜色贴图。
- Name
  base_color
  Type
  string
  Description
  基础颜色贴图的下载 URL。