Meshy 7.1 文生 3D

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "meshy/v7.1/text-to-3d",
  "input": {
    "prompt": "A weathered bronze lantern with a hexagonal glass cage and a curled iron handle",
    "mode": "full",
    "topology": "quad",
    "target_polycount": 30000,
    "enable_pbr": true
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1762160000-abc123",
    "status": "not_started",
    "created_time": "2026-11-03T10:30:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Request timeout

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

POST

api

generate

submit

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "meshy/v7.1/text-to-3d",
  "input": {
    "prompt": "A weathered bronze lantern with a hexagonal glass cage and a curled iron handle",
    "mode": "full",
    "topology": "quad",
    "target_polycount": 30000,
    "enable_pbr": true
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1762160000-abc123",
    "status": "not_started",
    "created_time": "2026-11-03T10:30:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Request timeout

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

提交后会返回 task_id。如果提供了 callback_url，当任务状态变为 finished 或 failed 时，系统会向 callback_url 发送 POST 请求。
无论是否提供 callback_url，都可以通过统一的查询任务状态接口获取结果。

Meshy 7.1 文生 3D 根据文字描述生成 3D 模型。可以选择快速的仅几何体 preview，或带纹理的 full 模型；可为游戏引擎控制拓扑和多边形数量，还可以为人形角色做骨骼绑定和动画。 Meshy 7.1 是 Meshy 的 3D 生成模型，重点提升几何细节。Vidgo 提供三个 model ID：文生 3D、图生 3D和多图生 3D。

模型

meshy/v7.1/text-to-3d — Meshy 7.1 文生 3D，输出预览或带纹理的模型。

功能

用最多 600 个字符的提示词文生 3D。
preview（仅几何体）或 full（带纹理）模式。
model_type: standard 时几何细节最高 4k，或用 smart-topology 生成更规整的低面数网格。
三角形或四边形拓扑，并可设置目标多边形数量。
PBR 贴图，可用文字或图片引导纹理。
可选人形骨骼绑定和动画预设。

必填参数

prompt（string）：要生成的物体，包括形状、材质、颜色和风格。1–600 个字符，不能为空白。

可选参数

mode（string）：preview（仅几何体）或 full（带纹理）。默认 full。
model_type（string）：standard 或 smart-topology。默认 standard。
seed（integer）：种子，用于获得可复现的结果。
enable_prompt_expansion（boolean）：让模型扩写简短的提示词。默认 false。
topology（string）：triangle 或 quad。默认 triangle。
target_polycount（integer）：100–300000，默认 30000。model_type: smart-topology 时范围为 100–15000，默认 4000。
should_remesh（boolean）：对输出重新网格化。默认 true；false 保留原始三角网格。
symmetry_mode（string）：off、auto 或 on。默认 auto。
pose_mode（string）：""（不限定姿势）、a-pose 或 t-pose。默认 ""。
geometry_resolution（string）：standard、2k 或 4k。仅在 model_type: standard 时可用。
enable_pbr（boolean）：在基础颜色纹理之外生成金属度、粗糙度和法线贴图。默认 false。
texture_prompt（string）：纹理的文字引导，最多 600 个字符。
texture_image_url（string）：引导纹理的图片（公开 HTTP(S) URL 或 data:image/... URI）。
enable_rigging（boolean）：将模型自动绑定为人形角色骨骼。默认 false。
rigging_height_meters（number）：骨骼绑定使用的角色身高（米），必须大于 0。默认 1.7。
enable_animation（boolean）：应用动画预设。需要 enable_rigging: true。默认 false。
animation_action_id（integer）：动画预设 ID，0–696。默认 92。
enable_safety_checker（boolean）：上游安全检查。默认 true。

输出

请读取查询任务状态或回调返回的 files 数组中的每一项。模型文件为 file_type: "3d"（通常是 GLB，可用时还有 FBX、OBJ、USDZ 或 STL），预览图和缩略图为 file_type: "image"，纹理、绑定或动画资源等辅助文件可能为 file_type: "other"。并非每个任务都会返回全部格式，不要假定文件列表固定。

示例

带纹理道具：mode: full，四边形拓扑，目标 30,000 个多边形，并生成 PBR 贴图。
仅几何体预览：mode: preview，geometry_resolution: 2k，固定 seed，适合在生成纹理前检查造型。
带骨骼绑定和动画的角色：t-pose 的全身角色，开启 enable_rigging 和 enable_animation，并提供 callback_url。

注意事项

本 ID 只接受文本。使用照片或概念图请用 Meshy 7.1 图生 3D；使用同一物体的多个视角请用 Meshy 7.1 多图生 3D。
model_type: smart-topology 时传 geometry_resolution 会返回 400，target_polycount 超过 15,000 也会返回 400。geometry_resolution 控制网格细节，而非纹理图片尺寸。
只开 enable_animation: true 而不开 enable_rigging: true 会返回 400。骨骼绑定最适合四肢清晰、处于 a-pose 或 t-pose 的人形角色；用于生产前请检查骨骼和网格。
上文未列出的字段（如 image_urls、should_texture）会返回 400。model 和 callback_url 放在请求根级，不要放进 input。
积分在提交时预扣：每个模型有基础费用，生成纹理（mode: full，即默认值）、enable_rigging 和 enable_animation 会分别增加费用。多边形数量、拓扑、geometry_resolution 和图片数量不影响价格。任务失败会全额退还。当前费率见定价页。

授权

Authorization

string

header

必填

所有 API 接口都需要 Bearer Token 认证

获取 API Key：

进入仪表盘 → API 密钥（API Key 管理页面）获取你的 API Key

在请求头中添加：

Authorization: Bearer VIDGO_API_KEY

请求体

application/json

model

string

必填

模型 ID，填 meshy/v7.1/text-to-3d。

示例:

"meshy/v7.1/text-to-3d"

input

object

必填

生成参数。

Show child attributes

callback_url

string<uri> | null

可选的公开 HTTP(S) 地址，任务变为 finished 或 failed 时会收到 POST 请求。建议使用 HTTPS。省略、传 null 或空字符串即不发送回调。

示例:

"https://your-domain.com/callback"

响应

任务已提交

code

enum<integer>

必填

HTTP 状态码。

可用选项:

200

data

object

必填

Show child attributes

​模型

​功能

​必填参数

​可选参数

​输出

​示例

​注意事项

授权

请求体

响应

模型

功能

必填参数

可选参数

输出

示例

注意事项