Image to model (v1.4-20240625)

This page lists all supported parameters for image_to_model when using model_version v1.4-20240625.

When to use v1.4

• Choose v1.4 only for legacy compatibility with older integrations.
• For new integrations, prefer H3, H2, P1, or Turbo-v1.0.

Endpoint

Parameters

Required parameters

type: This field must be set to image_to_model.

file: Specifies the image input.

• type: Indicates the file type. Although currently not validated, specifying the correct file type is strongly advised.
• file_token: The identifier you get from upload, please refer to part of Upload directly. Mutually exclusive with url and object.
• url: A direct URL to the image. Supports JPEG and PNG formats with a maximum size of 20MB. Mutually exclusive with file_token and object.
• object (Strongly Recommended): The information you get from upload, please refer to Upload in STS. Mutually exclusive with url and file_token.
  • bucket: Normally it always will be tripo-data.
  • key: The resource_uri from returns.

model_version: Set to v1.4-20240625.

Common parameters

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.

enable_image_autofix: A bool value to determine if optimize the input image to get better generation result. It will take longer time when request. The default value is false.

Advanced parameters

None in this version.

Returns

task_id: The identifier for the successfully submitted task.