Skip to main content
POST
  1. Submit the request with VIDGO_API_KEY. A task_id is returned immediately. Keep it until the task reaches finished or failed.
  2. Use Query Task Status to retrieve the result. If you provide a callback_url, Vidgo sends the result to your webhook when the task finishes or fails.

Tripo3D P1 Image to 3D

Turn a reference image into a 3D object with Tripo3D P1, with optional textures and control over polygon count.

Available Models

  • tripo3d/p1/image-to-3d - Generate a 3D model from an image.

Output Options

Face Limit

  • face_limit: Optional. Set the face-count limit. Integer from 48 to 20000.

Key Features

  • Generate a 3D model from an image.
  • Accepts exactly 1 image in image_urls.
  • Retrieve model assets and available previews or supporting files from the task result.

Advanced Parameters

Set model and optional callback_url at the request root. Place all workflow parameters, including output options, inside input. Use the input fields listed below for this workflow. Provide a publicly accessible HTTP(S) image URL.

Image URLs

  • image_urls: Required. Provide publicly accessible image URLs. Supply exactly 1 item. Each item must be an HTTP(S) URL.

Texture

  • texture: Optional. Control texture generation. Use true or false. Default: true.

Model Seed

  • model_seed: Optional. Set the model-generation seed. Integer.

Output Files

  • Read every item in the returned files array.
  • Model assets use file_type: "3d"; previews use file_type: "image".
  • Supporting files use file_type: "other". Preserve each returned file and its label, format, content_type, file_name, and file_size metadata when present.
  • Use the model_glb file for 3D preview and the thumbnail file as its cover image when these labels are present.

Authorizations

Authorization
string
header
required

Use VIDGO_API_KEY.

Body

application/json

Set model and optional callback_url at the request root. Place the fields listed for this workflow inside input.

model
string
required
Example:

"tripo3d/p1/image-to-3d"

input
object
required
callback_url
string | null

Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks.

Response

Task submitted

code
enum<integer>
required
Available options:
200
data
object
required