Skip to main content
ArtEmotion
3D

Tripo H3.1

Credit-based pricing. Supports reference images.

Tripo H3.1 preview
Output
3D mesh

Inputs

  • Reference image (required)

Example prompt

A weathered stone gargoyle perched on a gothic spire, wings folded, cracked surface with moss
Try this prompt →
LLM-ready

API & LLM schema

Exact request contract for this model. Agents can fetch it from /api/v1/models?id=tripo3d/h3.1/image-to-3d.

POST/api/v1/generate21 fields · 3 required
FieldTypeRequirementContract
model_idconstantRequiredArtEmotion model identifier.
extraobjectOptionalModel-specific settings may also be nested here.
max_creditsnumberOptionalReject before submission if the estimated list price exceeds this cap. · Range: 1–…
webhook_urlstringOptionalFormat: uri
webhook_secretstringOptionalOptional model input.
folder_idstringOptionalOptional model input.
promptstringRequiredOptional model input.
texture_qualitystringOptionaldetailed produces high-resolution textures; extreme is the highest tier. · Allowed: standard, detailed, extreme · Default: standard
geometry_qualitystringOptionaldetailed produces higher-polygon geometry. · Allowed: standard, detailed · Default: standard
texture_alignmentstringOptionalHow textures are aligned: to the input image or to the generated geometry. · Allowed: original_image, geometry · Default: original_image
orientationstringOptionalAlign Image auto-rotates the model to match the input image orientation. · Allowed: default, align_image · Default: default
pbrbooleanOptionalGenerate physically-based rendering materials. · Default: true
texturebooleanOptionalGenerate textures for the model. Disabling saves credits. · Default: true
face_limitnumberOptionalTarget polygon count. Leave unset for adaptive. · Range: 1000–2000000
quadbooleanOptionalOutput quad topology instead of triangles (+5 cr). Returns FBX. · Default: false
smart_low_polybooleanOptionalGenerate hand-crafted low-poly topology (+10 cr). · Default: false
generate_partsbooleanOptionalCreate segmented, editable model parts (+20 cr). Requires Texture, PBR, and Quad Mesh to be off. · Default: false
auto_sizebooleanOptionalScale model to real-world dimensions (meters). · Default: false
model_seedintegerOptionalSeed for geometry reproducibility.
texture_seednumberOptionalSeed for texture generation reproducibility.
reference_image_urlstringRequiredFormat: uri
Minimal request example
{
  "model_id": "tripo3d/h3.1/image-to-3d",
  "prompt": "A weathered stone gargoyle perched on a gothic spire, wings folded, cracked surface with moss",
  "reference_image_url": "https://example.com/reference_image"
}
Raw JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=tripo3d%2Fh3.1%2Fimage-to-3d",
  "title": "Tripo H3.1 generation request",
  "description": "Request body accepted by POST /api/v1/generate for tripo3d/h3.1/image-to-3d.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "tripo3d/h3.1/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_quality": {
      "title": "Texture Quality",
      "description": "detailed produces high-resolution textures; extreme is the highest tier.",
      "default": "standard",
      "type": "string",
      "enum": [
        "standard",
        "detailed",
        "extreme"
      ]
    },
    "geometry_quality": {
      "title": "Geometry Quality",
      "description": "detailed produces higher-polygon geometry.",
      "default": "standard",
      "type": "string",
      "enum": [
        "standard",
        "detailed"
      ]
    },
    "texture_alignment": {
      "title": "Texture Alignment",
      "description": "How textures are aligned: to the input image or to the generated geometry.",
      "default": "original_image",
      "type": "string",
      "enum": [
        "original_image",
        "geometry"
      ]
    },
    "orientation": {
      "title": "Orientation",
      "description": "Align Image auto-rotates the model to match the input image orientation.",
      "default": "default",
      "type": "string",
      "enum": [
        "default",
        "align_image"
      ]
    },
    "pbr": {
      "title": "PBR",
      "description": "Generate physically-based rendering materials.",
      "default": true,
      "type": "boolean"
    },
    "texture": {
      "title": "Texture",
      "description": "Generate textures for the model. Disabling saves credits.",
      "default": true,
      "type": "boolean"
    },
    "face_limit": {
      "title": "Face Limit",
      "description": "Target polygon count. Leave unset for adaptive.",
      "type": "number",
      "minimum": 1000,
      "maximum": 2000000,
      "multipleOf": 1
    },
    "quad": {
      "title": "Quad Mesh",
      "description": "Output quad topology instead of triangles (+5 cr). Returns FBX.",
      "default": false,
      "type": "boolean"
    },
    "smart_low_poly": {
      "title": "Smart Low Poly",
      "description": "Generate hand-crafted low-poly topology (+10 cr).",
      "default": false,
      "type": "boolean"
    },
    "generate_parts": {
      "title": "Generate Parts",
      "description": "Create segmented, editable model parts (+20 cr). Requires Texture, PBR, and Quad Mesh to be off.",
      "default": false,
      "type": "boolean"
    },
    "auto_size": {
      "title": "Auto Size",
      "description": "Scale model to real-world dimensions (meters).",
      "default": false,
      "type": "boolean"
    },
    "model_seed": {
      "title": "Seed",
      "description": "Seed for geometry reproducibility.",
      "type": "integer"
    },
    "texture_seed": {
      "title": "Texture Seed",
      "description": "Seed for texture generation reproducibility.",
      "type": "number",
      "multipleOf": 1
    },
    "reference_image_url": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "model_id",
    "prompt",
    "reference_image_url"
  ],
  "additionalProperties": false
}

FAQ

How much does Tripo H3.1 cost on ArtEmotion?

Credit-based pricing. You pay in ArtEmotion credits — every plan and top-up converts USD to credits at a fixed rate.

Do I get my credits back if Tripo H3.1 fails?

Yes — failed generations are never charged. The credits are released back to your balance automatically.

Can I call Tripo H3.1 from the API?

Yes. Use POST /api/v1/generate with model_id: "tripo3d/h3.1/image-to-3d". See the API reference for the full schema.

Where are my generations stored?

Every output is saved to your personal Library. You can export or delete everything any time from Privacy & deletion.

Ready to generate with Tripo H3.1?

Start now →

No commitment. New accounts get 50 free credits on signup. See pricing.