创建 Text to 3D 任务

POST

/domi/providers/meshy/openapi/v2/text-to-3d

Meshy 原协议透明转发。调用方使用 NewAPI AK，网关注入 Meshy API Key。
创建返回 result（task id）；任务族通常提供 list/get/delete/stream。stream 为 SSE，网关逐块刷新且不设置整体响应超时。
input_task_id 与 model_url 等替代输入通常二选一，具体约束已写在字段说明中。

当前网关支持的模型配置：mode=preview 对应 meshy-text-preview，mode=refine 对应 meshy-text-refine；两者配置的上游模型均为 latest。请求通过 mode 选择任务模式，ai_model 是 Meshy 原协议版本参数，不填写上述网关标识。列表依据仓库 SQL 配置，实际可用性取决于部署环境启用配置及 NewAPI 授权。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

示例

{
    "mode": "preview",
    "prompt": "A hand-painted wooden treasure chest",
    "ai_model": "meshy-6",
    "should_remesh": true,
    "target_polycount": 30000,
    "target_formats": [
        "glb",
        "fbx"
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://gateway.domi-kids.com/domi/providers/meshy/openapi/v2/text-to-3d' \
--header 'domi-ai-metadata;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "mode": "preview",
    "prompt": "A hand-painted wooden treasure chest",
    "ai_model": "meshy-6",
    "should_remesh": true,
    "target_polycount": 30000,
    "target_formats": [
        "glb",
        "fbx"
    ]
}'

返回响应

🟢200

application/json

创建成功，result 为 Meshy task id

Bodyapplication/json

示例

{
    "result": "018a210d-8ba4-705c-b111-1f1776f7f578"
}

🟠400

🟠401

🟠4XX

🔴5XX

修改于 2026-09-16 09:19:37

创建可打印性修复任务

查询可打印性修复任务