curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "tripo3d/h3.1/text-to-3d",
  "input": {
    "prompt": "A quiet forest under soft morning light, with natural detail.",
    "texture": true,
    "texture_quality": "standard",
    "geometry_quality": "standard",
    "quad": false
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-example",
    "status": "running",
    "created_time": "2026-09-10T08:00:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

"Request timeout"

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

​

Tripo3D H3.1 Text to 3D

Create textured 3D objects from text with Tripo3D H3.1, with control over mesh detail, surface quality, and PBR materials.

​

Available Models

• tripo3d/h3.1/text-to-3d - Generate a 3D model from a text prompt.

​

Output Options

​

Face Limit

• face_limit: Optional. Set the face-count limit. Integer from 1000 to 2000000.

​

Geometry Quality

• geometry_quality: Optional. Accepted values: standard, detailed. Default: standard.

​

Key Features

• Generate a 3D model from a text prompt.
• 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 parameters listed below for this generation workflow.

​

Prompt

• prompt: Required. Describe the desired 3D object. Length: 1-1,024 characters.

​

Negative Prompt

• negative_prompt: Optional. Describe content to avoid. Maximum length: 1,024 characters.

​

Texture

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

​

PBR

• pbr: Optional. Generate physically based rendering (PBR) materials when texture is true. Use true or false.

​

Model Seed

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

​

Image Seed

• image_seed: Optional. Set the image-generation seed. Integer.

​

Texture Seed

• texture_seed: Optional. Set the texture-generation seed. Integer.

​

Texture Quality

• texture_quality: Optional. Accepted values: standard, detailed. Default: standard.

​

Auto Size

• auto_size: Optional. Control automatic model sizing. Use true or false.

​

Quad

• quad: Optional. Request quad topology. Use true or false. Default: false.

​

Output Files

• Read every item in the returned files array.
• Model assets use file_type: "3d"; previews use file_type: "image".
• Additional artifacts may use file_type: "other". Retain accompanying assets and available label, format, content_type, file_name, and file_size metadata.