> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vidgo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 3D 模型

> Vidgo API 上可用的全部 3D 生成模型及其 model ID。

所有3D 模型都通过 `POST /api/generate/submit` 调用。在 `model` 中传入 model ID，在 `input` 中传入该模型的参数，并可选传入 `callback_url`。请求会立即返回 `task_id`，任务异步执行。

## 工作流程

1. 使用下表中的 model ID 向 `POST /api/generate/submit` 提交任务。
2. 使用返回的 `task_id` 轮询[获取任务状态](https://docs.vidgo.ai/zh/api-manual/task-management/status.md)，或在 `callback_url` 接收结果（参见 [Webhook 回调](https://docs.vidgo.ai/zh/api-manual/task-management/webhooks.md)）。
3. 状态为 `finished` 时，下载 `files` 中的文件。

3D 任务可能返回多个文件，例如模型文件、预览图和贴图。请处理 `files` 数组中的每一项。

## 模型

| 模型 | 厂商 | Model ID |
| - | - | - |
| [Meshy 6 Text to 3D](https://docs.vidgo.ai/zh/api-manual/3d-series/meshy-v6-text-to-3d.md) | Meshy | `meshy/v6/text-to-3d` |
| [Meshy 6 Image to 3D](https://docs.vidgo.ai/zh/api-manual/3d-series/meshy-v6-image-to-3d.md) | Meshy | `meshy/v6/image-to-3d` |
| [Meshy 6 Multi Image to 3D](https://docs.vidgo.ai/zh/api-manual/3d-series/meshy-v6-multi-image-to-3d.md) | Meshy | `meshy/v6/multi-image-to-3d` |
| [Meshy 7.1 文生 3D](https://docs.vidgo.ai/zh/api-manual/3d-series/meshy-v7-1-text-to-3d.md) | Meshy | `meshy/v7.1/text-to-3d` |
| [Meshy 7.1 图生 3D](https://docs.vidgo.ai/zh/api-manual/3d-series/meshy-v7-1-image-to-3d.md) | Meshy | `meshy/v7.1/image-to-3d` |
| [Meshy 7.1 多图生 3D](https://docs.vidgo.ai/zh/api-manual/3d-series/meshy-v7-1-multi-image-to-3d.md) | Meshy | `meshy/v7.1/multi-image-to-3d` |
| [Hunyuan 3D v3.1 Pro Text to 3D](https://docs.vidgo.ai/zh/api-manual/3d-series/hunyuan-3d-v3-1-pro-text-to-3d.md) | Hunyuan3D | `hunyuan-3d/v3.1/pro/text-to-3d` |
| [Hunyuan 3D v3.1 Pro Image to 3D](https://docs.vidgo.ai/zh/api-manual/3d-series/hunyuan-3d-v3-1-pro-image-to-3d.md) | Hunyuan3D | `hunyuan-3d/v3.1/pro/image-to-3d` |
| [Hunyuan 3D v3.1 Rapid Text to 3D](https://docs.vidgo.ai/zh/api-manual/3d-series/hunyuan-3d-v3-1-rapid-text-to-3d.md) | Hunyuan3D | `hunyuan-3d/v3.1/rapid/text-to-3d` |
| [Hunyuan 3D v3.1 Rapid Image to 3D](https://docs.vidgo.ai/zh/api-manual/3d-series/hunyuan-3d-v3-1-rapid-image-to-3d.md) | Hunyuan3D | `hunyuan-3d/v3.1/rapid/image-to-3d` |
| [Tripo3D H3.1 Text to 3D](https://docs.vidgo.ai/zh/api-manual/3d-series/tripo3d-h3-1-text-to-3d.md) | Tripo3D | `tripo3d/h3.1/text-to-3d` |
| [Tripo3D H3.1 Image to 3D](https://docs.vidgo.ai/zh/api-manual/3d-series/tripo3d-h3-1-image-to-3d.md) | Tripo3D | `tripo3d/h3.1/image-to-3d` |
| [Tripo3D H3.1 Multiview to 3D](https://docs.vidgo.ai/zh/api-manual/3d-series/tripo3d-h3-1-multiview-to-3d.md) | Tripo3D | `tripo3d/h3.1/multiview-to-3d` |
| [Tripo3D P1 Text to 3D](https://docs.vidgo.ai/zh/api-manual/3d-series/tripo3d-p1-text-to-3d.md) | Tripo3D | `tripo3d/p1/text-to-3d` |
| [Tripo3D P1 Image to 3D](https://docs.vidgo.ai/zh/api-manual/3d-series/tripo3d-p1-image-to-3d.md) | Tripo3D | `tripo3d/p1/image-to-3d` |

## 注意事项

* 每个模型页面列出了其 model ID 的参数、限制和模式。各模型之间的参数不通用。
* 生成的文件在创建后 24 小时内有效，请及时下载并保存。
* URL 输入必须是可公开访问的 HTTP(S) URL。如需使用本地文件，请先通过[文件管理](https://docs.vidgo.ai/zh/api-manual/file-series/upload-url.md)上传。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.