Available now

Trellis 2: image to 3D

By Microsoft

Trellis 2 from Microsoft turns one image into a textured 3D model with PBR materials, delivered as a GLB file.

Model ID
Maker
Microsoft

Model id

Use this in every request
trellis-2-image-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": "trellis-2-image-to-3d",
  "input": {
    "inputImage": [
      "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": "trellis-2-image-to-3d", "quote_id": "QUOTE_ID", "input": {"inputImage":["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 trellis-2-image-to-3d
NameTypeDescription
inputImagerequiredarray of image URLs
Required. One image of the object. A transparent background is kept; otherwise the background is removed automatically.
pipeline_typestring (enum)
3D generation resolution: 512 is the fastest, 1024 the recommended default, 1536 the most detailed.

Default: 1024_cascade

One of: 512, 1024_cascade, 1536_cascade

texture_sizestring (enum)
Size of the texture maps baked into the GLB, in pixels.

Default: 4096

One of: 1024, 2048, 4096, 8192

decimation_targetinteger
Target face count of the exported mesh. Lower values give a smaller file with less detail.

Default: 1000000

seedstring
Optional. Random seed. Leave empty for a new result each time; set it to repeat one.

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

  • 512$0.40/ model
  • 1024$0.48/ model
  • 1536$0.56/ 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. A transparent background is kept; otherwise the background is removed automatically. Choose a resolution of 512, 1024 or 1536, the texture size and the target face count of the mesh.

What you can build

  • Props for games and scenes from concept art or product photos
  • Product models for a 3D viewer
  • Drafts at 512 before a final pass at 1536

Prompting tips

  • Start at 1024; use 1536 for thin parts and fine surface detail, and 512 for drafts.
  • For web use, lower the decimation target and pick a smaller texture size to keep the file light.
  • Only one view goes in, so the back and hidden sides are inferred.

Inputs

  • Input Image (required): One image of the object. A transparent background is kept; otherwise the background is removed automatically.
  • Resolution (optional): 3D generation resolution: 512 is the fastest, 1024 the recommended default, 1536 the most detailed. Options: 512, 1024, 1536.
  • Texture Size (optional): Size of the texture maps baked into the GLB, in pixels. Options: 1024, 2048, 4096, 8192.
  • Decimation Target (optional): Target face count of the exported mesh. Lower values give a smaller file with less detail. From 10000 to 2000000.
  • Seed (optional): Random seed. Leave empty for a new result each time; set it to repeat one.

Output and limits

  • The download is one GLB file with its textures inside.
  • 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

  • 512: $0.40 / model
  • 1024: $0.48 / model
  • 1536: $0.56 / model