Text to model (P1-20260311)

This page lists all supported parameters for text_to_model when model_version is P1-20260311.

When to use P1

• Choose P1 when prompt-only generation needs stronger low-poly topology quality.
• If you need richer fidelity controls, consider text_to_model H3.

Endpoint

Parameters

Required parameters

type: This field must be set to text_to_model.

prompt: A text value that directs the model generation. The maximum prompt length is 1024 characters, equivalent to approximately 100 words. The API supports multiple languages. However, emojis and certain special Unicode characters are not supported.

model_version: Should always be P1-20260311.

Common parameters

negative_prompt: A text value which provides a reverse direction to assist in generating content contrasting with the original prompt. The maximum length is 255 characters.

image_seed: An integer value chosed randomly if not set. This is the random seed for image generation.

model_seed: An integer value chosed randomly if not set. This is the random seed for model generation. For model_version>=v2.0-20240919 or Turbo-v1.0-20250506, the seed controls the geometry generation process, ensuring identical models when the same seed is used.

face_limit: An integer value which limits the number of faces on the output model. The range is 48 ~ 20000. If this option is not set, the face limit will be adaptively determined.

texture: A bool value to enable texturing, set false to get a base model without any textures. The default value is true. This will cost 10 less credits when set to false, this will not work for version v1.4-20240625.

pbr: A bool value to enable pbr, set false to get a model without pbr. The default value is true.

TIP

If this option is set to true, value of texture will be ignored and set to true.

Advanced parameters

texture_seed: An integer value chosed randomly if not set. This is the random seed for texture generation for model_version>=v2.0-20240919 or Turbo-v1.0-20250506. Using the same seed will produce identical textures. If you want a model with different textures, please use same model_seed and different texture_seed.

texture_quality: A text value to control the texture quality. Can be set to detailed or standard. detailed provides high-resolution textures, resulting in more refined and realistic representation of intricate parts. The default value is standard. This will cost 10 additional credits when set to detailed.

Combination rules when texture_quality = detailed:

• texture=false, pbr=false: Upscales the texture to 4K. PBR material will be removed. Only available for v3.0-20250812.
• texture=false, pbr=true: Generates PBR with the current texture.
• texture=true, pbr=false: Regenerates HD texture without PBR.
• texture=true, pbr=true: Regenerates HD texture with PBR.

WARNING

Setting texture_quality=standard with both texture=false and pbr=false is not allowed.

auto_size: A bool value to automatically scale the model to real-world dimensions with the unit in meters. The default value is false.

TIP

This can only be used in textured model.

compress: A text value to specify the compression type to apply to the texture. Set to geometry to apply geometry-based compression to optimize the output. By Default we use meshopt compression.

export_uv: A bool value to control whether UV unwrapping is performed during generation. The default value is true.

TIP

When set to false, generation speed is significantly improved and model size is reduced. UV unwrapping will be handled during the texturing stage.

Returns

task_id: The identifier for the successfully submitted task.