Available now

Tripo H3.1: image to 3D

By Tripo

Tripo H3.1 makes a 3D model from one image or a text prompt and delivers it as a GLB file, untextured or with standard or detailed textures.

Model ID
Maker
Tripo

Model id

Use this in every request
tripo3d/h3.1/image-to-3d

This model has other modes with their own ids: tripo3d/h3.1/text-to-3d.

Run it

Quote the input, start the generation with the quote, then poll the job. Set RAYWAKE_API_KEY first; see Authentication.

# 1. Price the exact input (quotes are valid for up to 10 minutes)
curl -s https://api.raywake.com/v1/quotes \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "tripo3d/h3.1/image-to-3d",
  "input": {
    "image_url": "https://example.com/input.png"
  }
}'

# 2. Start the generation with the quote_id from step 1
curl -s https://api.raywake.com/v1/generate \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "tripo3d/h3.1/image-to-3d", "quote_id": "QUOTE_ID", "input": {"image_url":"https://example.com/input.png"}}'

# 3. Poll until the status is terminal
curl -s https://api.raywake.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $RAYWAKE_API_KEY"

Input

Input fields for tripo3d/h3.1/image-to-3d
NameTypeDescription
image_urlrequiredstring (image URL)
URL of the input image for 3D model creation.
face_limitinteger
Target number of faces for the generated mesh. If not set, the model adaptively determines the count.
textureboolean
Generate textures for the model. For a model without textures, turn off PBR as well and leave Texture Quality on standard.

Default: true

pbrboolean
Generate PBR (physically based rendering) materials. Needs Texture on.

Default: true

model_seedinteger
Seed for geometry generation reproducibility.
texture_seedinteger
Seed for texture generation reproducibility.
texture_qualitystring (enum)
Detailed produces higher-resolution textures. Needs Texture on.

Default: standard

One of: standard, detailed

geometry_qualitystring (enum)
Quality level for geometry.

Default: standard

One of: standard, detailed

texture_alignmentstring (enum)
How textures are aligned. 'original_image' aligns to input image, 'geometry' aligns to generated geometry.

Default: original_image

One of: original_image, geometry

auto_sizeboolean
Auto-scale the model to real-world dimensions (meters).

Default: false

orientationstring (enum)
Model orientation. 'align_image' auto-rotates to match the input image.

Default: default

One of: default, align_image

Output

A succeeded job lists its results under outputs, stored on our side. See Jobs for every field.

Job excerpt
"outputs": [
  { "type": "image", "url": "https://…", "mime_type": "image/png", "thumbnail_url": "https://…" }
]

Pricing

  • No textures$0.32/ model
  • Standard textures$0.48/ model
  • HD textures$0.64/ model
  • No textures · detailed geometry$0.64/ model
  • Standard textures · detailed geometry$0.80/ model
  • HD textures · detailed geometry$0.96/ model

The exact charge for your input comes from a quote. How charges settle

API docs

About this model

Overview

Upload one image of an object or describe it in a prompt. Textures and PBR materials are on by default; turn both off for a bare mesh, or switch texture quality and geometry quality to detailed for more surface and shape detail. You can cap the face count, fix the seeds and scale the model to real-world size.

What you can build

  • Props and set pieces for games and animation
  • Product models from a catalog photo
  • Quick untextured blockouts to test a shape
  • Variations of one object by changing the seed

Prompting tips

  • A model without textures needs Texture and PBR off and texture quality on standard.
  • Detailed geometry and detailed textures are separate choices; turn on only the one your object needs.
  • Set a face limit when the model is headed for the web or a game engine.
  • In text mode, use the negative prompt to rule out parts you do not want, such as a base or a stand.

Inputs

  • Image (required): URL of the input image for 3D model creation.
  • Face Limit (optional): Target number of faces for the generated mesh. If not set, the model adaptively determines the count. From 1000 to 2000000.
  • Texture (optional): Generate textures for the model. For a model without textures, turn off PBR as well and leave Texture Quality on standard.
  • Pbr (optional): Generate PBR (physically based rendering) materials. Needs Texture on.
  • Model Seed (optional): Seed for geometry generation reproducibility.
  • Texture Seed (optional): Seed for texture generation reproducibility.
  • Texture Quality (optional): Detailed produces higher-resolution textures. Needs Texture on. Options: standard, detailed.
  • Geometry Quality (optional): Quality level for geometry. Options: standard, detailed.
  • Texture Alignment (optional): How textures are aligned. Options: Original image, geometry.
  • Auto Size (optional): Auto-scale the model to real-world dimensions (meters).
  • Orientation (optional): Model orientation. Options: default, Align image.

Output and limits

  • The download is one GLB file with triangle topology; quad meshes are not available here.
  • Small or dense text in the image can come out misspelled.
  • Hands, crowds and complex poses can show artifacts; generate a few variations and pick the best.
  • Some prompts or outputs can be refused by safety checks.

Price guide

  • No textures: $0.32 / model
  • Standard textures: $0.48 / model
  • HD textures / No textures · detailed geometry: $0.64 / model
  • Standard textures · detailed geometry: $0.80 / model
  • HD textures · detailed geometry: $0.96 / model