文生模型（Turbo-v1.0-20250506）

本页列出 text_to_model 在 model_version 为 Turbo-v1.0-20250506 时支持的全部参数。

何时使用 Turbo-v1.0

• 当你希望文生模型任务尽快返回结果时，优先使用 Turbo-v1.0。
• 如果你需要更强的质量调优能力，可改用 H3 或 P1。

接口地址

参数

必填参数

type: 该字段必须设置为 text_to_model。

prompt: 用于引导模型生成的 text 文本。 prompt 最长 1024 个字符，约等于 100 个英文单词。 API 支持多语言输入，但不支持 emoji 和部分特殊 Unicode 字符。

model_version: 应设置为 Turbo-v1.0-20250506。

常用参数

negative_prompt: text 值，用于提供与原始 prompt 相反的引导方向，帮助排除或反向约束生成内容。最大长度为 255 个字符。

image_seed: integer 值；若不设置将随机生成。该值为图像生成随机种子。

model_seed: 一个 integer 值；若不设置将随机生成。它是模型生成的随机种子。对于 model_version>=v2.0-20240919 或 Turbo-v1.0-20250506，该种子会控制几何生成过程，使用相同种子可得到一致的模型。

texture: bool 值，用于启用贴图。设为 false 时会输出不带贴图的基础模型。默认值为 true。设为 false 可少消耗 10 credits；该规则不适用于版本 v1.4-20240625。

进阶参数

texture_seed: 一个 integer 值；若不设置将随机生成。它是 model_version>=v2.0-20240919 或 Turbo-v1.0-20250506 时纹理生成的随机种子。使用相同种子会得到一致的贴图。若希望同一模型生成不同贴图，请保持 model_seed 相同并使用不同的 texture_seed。

texture_quality: 用于控制贴图质量的 text 值。可选 detailed 或 standard。detailed 会提供更高分辨率贴图，在复杂细节上更精细、更真实，适合对视觉保真度要求较高的模型。默认值为 standard。设为 detailed 时会额外消耗 10 credits。

texture_quality=detailed 时的组合规则：

• texture=false, pbr=false：将贴图放大至 4K，PBR 材质将被移除。仅 v3.0-20250812 可用。
• texture=false, pbr=true：基于当前贴图生成 PBR。
• texture=true, pbr=false：重新生成高清贴图，不含 PBR。
• texture=true, pbr=true：重新生成高清贴图并含 PBR。

注意

texture_quality=standard 时，texture=false 与 pbr=false 同时设置不被允许。

pbr: bool 值，用于启用 pbr。设为 false 时会输出不带 pbr 的模型。默认值为 true。

TIP

若该选项为 true，texture 的取值会被忽略并强制视为 true。

smart_low_poly: bool 值，用于控制是否生成具有人为优化拓扑的低模网格。输入复杂度较低时效果最佳。默认值为 false。设为 true 时会额外消耗 10 credits。

Caution

复杂模型存在失败可能。

quad: bool 值，设为 true 可启用四边面网格输出。若 quad=true 且未设置 face_limit，则 face_limit 会默认设为 10000。建议不超过 150,000。设为 true 时会额外消耗 5 credits。

TIP

启用该选项会强制输出为 FBX 模型。

face_limit: 用于限制输出模型面数的 integer 值。若不设置，系统会自适应决定面数。

三角面限制（默认输出）：

模型版本	Standard（geometry_quality=standard）	Ultra（geometry_quality=detailed）
v3.1-20260211	不超过 1,500,000	不超过 2,000,000
v3.0-20250812	不超过 1,000,000	不超过 1,500,000

四边面限制（quad=true）：建议不超过 150,000。

若 smart_low_poly=true，范围应为 1000~20000；若同时 quad=true，范围应为 500~10000。

auto_size: bool 值，用于将模型自动缩放到现实世界尺寸（单位为米）。默认值为 false。

TIP

该参数仅可用于带贴图的模型。

compress: 用于指定压缩类型的 text 值。设置为 geometry 时会应用基于几何的压缩以优化输出。默认使用 meshopt 压缩。

generate_parts: 生成分段后的 3D 模型，并使每个部分可编辑。默认值为 false。设为 true 时会额外消耗 20 credits。

TIP

generate_parts 与 texture=true 或 pbr=true 不兼容。若要生成分段，请将 texture=false 且 pbr=false；

generate_parts 也与 quad=true 不兼容。若要生成分段，请将 quad=false。

export_uv: bool 值，用于控制生成过程中是否执行 UV 展开。默认值为 true。

TIP

设为 false 时，生成速度会显著提升且模型体积更小。UV 展开会在贴图阶段完成。

返回值

task_id: 成功提交任务后的唯一标识。