ndreca/hunyuan3d-2:fa915347 – Run with an API on Replicate

Version

You're looking at a specific version of this model. Jump to the model overview.

ndreca /hunyuan3d-2:fa915347

Playground API

Input

Run this model in Node.js with one line of code:

npx create-replicate --model=ndreca/hunyuan3d-2

or set up a project from scratch

Install Replicate’s Node.js client library:

npm install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import and set up the client:

import Replicate from "replicate";

const replicate = new Replicate({
  auth: process.env.REPLICATE_API_TOKEN,
});

Run ndreca/hunyuan3d-2 using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

const output = await replicate.run(
  "ndreca/hunyuan3d-2:fa915347507a559f8a10eabbd1091abd26880542e3ef314a35e9bddaa5d98b09",
  {
    input: {
      seed: 1234,
      steps: 50,
      guidance_scale: 5.5,
      octree_resolution: 256,
      remove_background: true
    }
  }
);
console.log(output);

To learn more, take a look at the guide on getting started with Node.js.

Install Replicate’s Python client library:

pip install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import the client:

import replicate

Run ndreca/hunyuan3d-2 using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

output = replicate.run(
    "ndreca/hunyuan3d-2:fa915347507a559f8a10eabbd1091abd26880542e3ef314a35e9bddaa5d98b09",
    input={
        "seed": 1234,
        "steps": 50,
        "guidance_scale": 5.5,
        "octree_resolution": 256,
        "remove_background": True
    }
)
print(output)

To learn more, take a look at the guide on getting started with Python.

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Run ndreca/hunyuan3d-2 using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

curl -s -X POST \
  -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Prefer: wait" \
  -d $'{
    "version": "fa915347507a559f8a10eabbd1091abd26880542e3ef314a35e9bddaa5d98b09",
    "input": {
      "seed": 1234,
      "steps": 50,
      "guidance_scale": 5.5,
      "octree_resolution": 256,
      "remove_background": true
    }
  }' \
  https://api.replicate.com/v1/predictions

To learn more, take a look at Replicate’s HTTP API reference docs.

You can run this model locally using Cog. First, install Cog:

brew install cog

If you don’t have Homebrew, there are other installation options available.

Run this to download the model and run it in your local environment:

cog predict r8.im/ndreca/hunyuan3d-2@sha256:fa915347507a559f8a10eabbd1091abd26880542e3ef314a35e9bddaa5d98b09 \
  -i 'seed=1234' \
  -i 'steps=50' \
  -i 'guidance_scale=5.5' \
  -i 'octree_resolution=256' \
  -i 'remove_background=true'

To learn more, take a look at the Cog documentation.

Run this to download the model and run it in your local environment:

docker run -d -p 5000:5000 --gpus=all r8.im/ndreca/hunyuan3d-2@sha256:fa915347507a559f8a10eabbd1091abd26880542e3ef314a35e9bddaa5d98b09
curl -s -X POST \
  -H "Content-Type: application/json" \
  -d $'{
    "input": {
      "seed": 1234,
      "steps": 50,
      "guidance_scale": 5.5,
      "octree_resolution": 256,
      "remove_background": true
    }
  }' \
  http://localhost:5000/predictions

To learn more, take a look at the Cog documentation.

Output

No output yet! Press "Submit" to start a prediction.