Tripo3D v2.5 Image → 3D

{
  "model_id": "tripo3d/tripo/v2.5/image-to-3d",
  "prompt": "A heroic space marine in heavy gold and charcoal exo-suit armor with glowing orange energy cells",
  "reference_image_url": "https://example.com/reference_image"
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=tripo3d%2Ftripo%2Fv2.5%2Fimage-to-3d",
  "title": "Tripo3D v2.5 Image → 3D generation request",
  "description": "Request body accepted by POST /api/v1/generate for tripo3d/tripo/v2.5/image-to-3d.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "tripo3d/tripo/v2.5/image-to-3d",
      "description": "ArtEmotion model identifier."
    },
    "extra": {
      "type": "object",
      "additionalProperties": true,
      "description": "Model-specific settings may also be nested here."
    },
    "max_credits": {
      "type": "number",
      "minimum": 1,
      "description": "Reject before submission if the estimated list price exceeds this cap."
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048
    },
    "webhook_secret": {
      "type": "string",
      "maxLength": 512
    },
    "folder_id": {
      "type": "string"
    },
    "prompt": {
      "type": "string"
    },
    "texture": {
      "title": "Texture",
      "description": "Generate textures for the model. Disable to get a base model without any textures.",
      "default": true,
      "type": "boolean"
    },
    "texture_quality": {
      "title": "Texture Quality",
      "description": "Texture resolution tier. Detailed and Extreme produce higher-resolution textures at extra cost.",
      "default": "standard",
      "type": "string",
      "enum": [
        "standard",
        "detailed",
        "extreme"
      ]
    },
    "pbr": {
      "title": "PBR Maps",
      "description": "Generate PBR (metallic/roughness) materials. When enabled, texture is treated as enabled.",
      "default": true,
      "type": "boolean"
    },
    "orientation": {
      "title": "Orientation",
      "description": "Auto-rotate the mesh to match the viewing angle of the input image. Only takes effect when texture is enabled.",
      "default": "default",
      "type": "string",
      "enum": [
        "default",
        "align_image"
      ]
    },
    "texture_alignment": {
      "title": "Texture Alignment",
      "description": "Determines the prioritization of texture alignment in the 3D model.",
      "default": "original_image",
      "type": "string",
      "enum": [
        "original_image",
        "geometry"
      ]
    },
    "auto_size": {
      "title": "Auto Size",
      "description": "Automatically scale the model to real-world dimensions (meters).",
      "default": false,
      "type": "boolean"
    },
    "quad": {
      "title": "Quad Mesh",
      "description": "Enable quad mesh output. Forces FBX output. If face_limit is not set, defaults to 10000.",
      "default": false,
      "type": "boolean"
    },
    "smart_low_poly": {
      "title": "Smart Low Poly",
      "description": "Generate low-poly meshes with hand-crafted topology. Works best on simple inputs; face_limit should be 1000-20000.",
      "default": false,
      "type": "boolean"
    },
    "generate_parts": {
      "title": "Generate Parts",
      "description": "Generate segmented, editable model parts. Requires texture, PBR, and quad to be disabled.",
      "default": false,
      "type": "boolean"
    },
    "texture_seed": {
      "title": "Texture Seed",
      "description": "Random seed for texture generation. Using the same seed produces identical textures.",
      "type": "number",
      "multipleOf": 1
    },
    "face_limit": {
      "title": "Face Limit",
      "description": "Limits the number of faces on the output model (max 500,000 for v2.5). If not set, adaptively determined.",
      "type": "number",
      "minimum": 1,
      "maximum": 500000,
      "multipleOf": 1
    },
    "model_seed": {
      "title": "Seed",
      "description": "Random seed for model geometry generation.",
      "type": "integer"
    },
    "aspect_ratio": {
      "type": "string",
      "enum": [
        "1:1"
      ]
    },
    "resolution": {
      "type": "string",
      "enum": [
        "1024"
      ]
    },
    "reference_image_url": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "model_id",
    "prompt",
    "reference_image_url"
  ],
  "additionalProperties": false
}