---
title: "3D图片生成接口"
method: POST
path: "/image3ds/generations"
tags: ["Image3d"]
---

# 3D图片生成接口

`POST /image3ds/generations`

基于文本提示/参考图生成3D的接口，支持多种图片生成模型和参数配置

## Request body

- object
  - `model` string, required — 3D模型
  - `prompt` string — 文本提示
  - `image` string — 基于图片生成3D，支持图片URL/Base64编码，如果包含多视角则该参数值为前视图，大小不超过8M
  - `multi_view_images` object[] — 多视角图片列表，仅混元3D和混元3D专业版支持该参数，支持图片URL/Base64编码。
    - `view_type` 'back' | 'left' | 'right' — 视角类型，视角参考值：left：左视图；right：右视图；back：后视图
    - `view_image_url` string — 视角图片URL，每个视角仅限制一张图片，格式为png/jpg，大小不超过8M
  - `result_format` 'OBJ，GLB，STL，USDZ，FBX，MP4' — 3D输出格式设置，仅混元3D支持该参数，豆包3D通过文本提示指令设置。
  - `enable_pbr` boolean — 是否开启PBR材质，默认false，仅混元3D支持该参数。
  - `face_count` integer — 3D模型面数，仅混元3D专业版支持该参数，默认500000，取值范围[40000,1500000]
  - `extra_body` object — 额外参数配置项，以适配不同3D模型的多样化配置，仅混元3D专业版支持该参数。
    - `generate_type` 'Normal' | 'LowPoly' | 'Geometry' | 'Sketch' — 生成任务类型，默认Normal，参考值： - Normal：可生成带纹理的几何模型。 - LowPoly：可生成智能减面后的模型。 - Geometry：可生成不带纹理的几何模型（白模），选择此任务时，`enable_pbr` 参数不生效。 - Sketch：可输入草图或线稿图生成模型，此模式下 `prompt` 和 `image` 可一起输入。
    - `polygon_type` 'triangle' | 'quadrilateral' — 多边形类型， 表示模型的表面由几边形网格构成。该参数仅在 `generate_type` 中选择 `LowPoly` 模式可生效。参考值： - triangle：三角形面。 - quadrilateral：四边形面与三角形面混合生成。
  - `async` boolean — 是否异步生成，默认false，即同步等待图片生成成功后返回生成结果，如果异步需要通过调用图片获取接口获取生成结果
  - `retries` integer — 自动重试次数，默认0，表示失败不重试

## Response `200`

成功响应

- object
  - `task_id` string, uuid — 任务ID
  - `task_status` 'pending' | 'running' | 'succeed' | 'failed' — 任务状态
  - `created` integer, required — 创建时间戳
  - `data` object[], required — 生成的3D文件列表(仅在task_status=succeed时返回)
    - `type` 'OBJ，GLB，STL，USDZ，FBX，MP4', required — 3D文件类型
    - `url` string, uri, required — 3D文件URL
    - `preview_url` string, uri — 3D预览图URL

## Other responses

- `400` — 参数验证错误
- `401` — 未授权
- `413` — 提示文本过长
- `500` — 标准错误响应

---

[API](https://skmtc.dev/geekai/apis/api.md) · [All operations](https://skmtc.dev/geekai/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/geekai/api/revisions/2bf0c8f70a39/schema)