Ana içeriğe geç
YeniSeedance 2.5 yayında→
ModelRunner
hyper3d avatarı

Rodin Gen-2 by Hyper3D API

hyper3d/rodin/gen-2

Bir metin prompt’undan ya da en fazla beş referans görselden PBR dokulu, temiz quad topolojili bir 3D model (GLB, OBJ, USDZ, FBX, STL) üretin.

0.399
Makale
OpenAPI

Model girdisi

Input

Text description of the 3D object to generate (English only, up to 400 characters; longer text is truncated). Required for text-to-3D; provide this OR one or more input images.

One to five reference image URLs to reconstruct into a 3D model. Required for image-to-3D; provide these OR a text prompt.

Additional Settings

Customize your input with more control.

Material set baked into the mesh: PBR (physically based, default), Shaded, All, or None.

Topology mode: Quad (default) for clean, animation-friendly quad topology, or Raw for a dense triangle mesh.

Export format of the generated 3D mesh.

Min: 500 - Max: 1000000

Target face count. Leave unset to use the mode default (about 18k for Quad, 500k for Raw). Valid range depends on mesh_mode: Raw 500 to 1,000,000, Quad 1,000 to 200,000.

Surface subdivision detail: high, medium (default), or low.

Generate high-definition texture maps for finer surface detail.

Generate human-like models in a rig-friendly T/A pose.

Random seed for reproducible generation. Leave unset for a random result.

You need to be logged in to run this model and view results.
Log in

Model çıktısı

Output

Loading
Generated in 199 seconds
Logs (1 lines)

Örnek istekler

Örnekler

Rodin Gen-2 by Hyper3D API

Rodin Gen-2 by Hyper3D is a image-to-3d AI model by hyper3d. On ModelRunner it runs through a REST API or via MCP from any AI assistant, at $0.399 per output.

POST https://queue.modelrunner.run/hyper3d/rodin/gen-2

cURL

# Submit a request to the queue. Input fields go at the top level of the
# body. The optional reserved "metadata" object holds your own flat string
# tags — stored on the request, never sent to the model; filter later with
# GET https://queue.modelrunner.run/requests?metadata=<url-encoded JSON>.
curl -X POST https://queue.modelrunner.run/hyper3d/rodin/gen-2 \
  -H "Authorization: Key $MRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "TAPose": false,
    "prompt": "a vintage brass diving helmet with rounded portholes and riveted seams, weathered patina, thick glass viewport",
    "material": "PBR",
    "mesh_mode": "Quad",
    "hd_texture": false,
    "subdivisionlevel": "medium",
    "geometry_file_format": "glb",
    "metadata": {
      "project": "my-project"
    }
  }'
# → { "request_id": "...", "status_url": "...", "response_url": "..." }

# Poll status_url until "COMPLETED", then fetch the result
curl "https://queue.modelrunner.run/hyper3d/rodin/gen-2/requests/$REQUEST_ID/status" \
  -H "Authorization: Key $MRUN_API_KEY"
curl "https://queue.modelrunner.run/hyper3d/rodin/gen-2/requests/$REQUEST_ID" \
  -H "Authorization: Key $MRUN_API_KEY"

JavaScript

import { modelrunner } from "@modelrunner/client";

const result = await modelrunner.subscribe("hyper3d/rodin/gen-2", {
  input: {
    "TAPose": false,
    "prompt": "a vintage brass diving helmet with rounded portholes and riveted seams, weathered patina, thick glass viewport",
    "material": "PBR",
    "mesh_mode": "Quad",
    "hd_texture": false,
    "subdivisionlevel": "medium",
    "geometry_file_format": "glb"
  },
});
console.log(result);

Python

import os
import requests

headers = {"Authorization": f"Key {os.environ['MRUN_API_KEY']}"}

submitted = requests.post(
    "https://queue.modelrunner.run/hyper3d/rodin/gen-2",
    headers=headers,
    json={
      "TAPose": false,
      "prompt": "a vintage brass diving helmet with rounded portholes and riveted seams, weathered patina, thick glass viewport",
      "material": "PBR",
      "mesh_mode": "Quad",
      "hd_texture": false,
      "subdivisionlevel": "medium",
      "geometry_file_format": "glb"
    },
).json()

# Poll submitted["status_url"] until "COMPLETED", then:
result = requests.get(submitted["response_url"], headers=headers).json()

Input parameters

Input parameters of Rodin Gen-2 by Hyper3D
NameTypeRequiredDescription
promptstringnoText description of the 3D object to generate (English only, up to 400 characters; longer text is truncated). Required for text-to-3D; provide this OR one or more input images. Default: "".
input_image_urlsarraynoOne to five reference image URLs to reconstruct into a 3D model. Required for image-to-3D; provide these OR a text prompt.
materialenumnoMaterial set baked into the mesh: PBR (physically based, default), Shaded, All, or None. One of: PBR, Shaded, All, None. Default: "PBR".
mesh_modeenumnoTopology mode: Quad (default) for clean, animation-friendly quad topology, or Raw for a dense triangle mesh. One of: Raw, Quad. Default: "Quad".
geometry_file_formatenumnoExport format of the generated 3D mesh. One of: glb, obj, usdz, fbx, stl. Default: "glb".
quality_overrideintegernoTarget face count. Leave unset to use the mode default (about 18k for Quad, 500k for Raw). Valid range depends on mesh_mode: Raw 500 to 1,000,000, Quad 1,000 to 200,000.
subdivisionlevelenumnoSurface subdivision detail: high, medium (default), or low. One of: high, medium, low. Default: "medium".
hd_texturebooleannoGenerate high-definition texture maps for finer surface detail. Default: false.
TAPosebooleannoGenerate human-like models in a rig-friendly T/A pose. Default: false.
seedintegernoRandom seed for reproducible generation. Leave unset for a random result.

Machine-readable: OpenAPI schema · llms.txt

Use Rodin Gen-2 by Hyper3D from Claude & Cursor (MCP)

Point Claude Code, Claude Desktop, Cursor, or any MCP client at the ModelRunner MCP server and Rodin Gen-2 by Hyper3D becomes a tool your assistant can call directly — it authorizes via OAuth (no API key in config) and runs this model with the run_model tool using the endpoint hyper3d/rodin/gen-2.

MCP client config (Claude Desktop, Cursor)

{
  "mcpServers": {
    "modelrunner": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.modelrunner.run/mcp"]
    }
  }
}

Claude Code

claude mcp add --transport http modelrunner https://mcp.modelrunner.run/mcp

Then ask your assistant, for example: “Run hyper3d/rodin/gen-2 on ModelRunner to generate 3d”. MCP setup guide.

Model Detayları

Model Detayları

Hyper3D’nin Rodin Gen-2 modeli, bir metin açıklamasını ya da bir ila beş referans görseli eksiksiz, dokulu bir 3D modele dönüştürür; text-to-3D ve image-to-3D işlerinin ikisini de tek bir endpoint üzerinden yürütür. PBR malzemeleri içine pişirilmiş, indirilebilir bir mesh (GLB, OBJ, USDZ, FBX ya da STL) döndürür. Önceki nesle göre öne çıkan farkı, geometri kalitesinde kabaca 4 katlık sıçramayla gelen temiz, quad tabanlı topolojidir — daha az bozuk yüzey, daha az elle temizlik. Özyinelemeli, parça tabanlı yaklaşımı, karmaşık nesneleri tek bir kaynaşmış kütleye dönüştürmek yerine yapısal olarak tutarlı tutar.

## En uygun olduğu işler - Bir ürün ya da konsept fotoğrafını oyunlar, AR ya da web için temiz, dokulu bir 3D varlığa dönüştürmek - Referans görsel olmadan yalnızca bir metin prompt’undan 3D model üretmek - Bir nesneyi en fazla beş fotoğraftan oyuna hazır geometri olarak yeniden kurmak - Apple AR için USDZ, DCC araçları için FBX/OBJ ya da 3D baskı için STL olarak dışa aktarmak

## Şu durumlarda başka bir model seçin - 3D mesh değil, yalnızca düz bir 2D görsel gerekiyorsa — bir text-to-image ya da görsel düzenleme modeli kullanın - Durağan bir mesh yerine animasyonlu bir 3D sahne ya da video gerekiyorsa — bir image-to-video modeli kullanın - Daha basit bir kalite kontrol setine sahip önceki Rodin neslini istiyorsanız (mesh modu ve hedef poligon sayısı yerine `quality`/`tier`) — `hyper3d/rodin` kullanın

## İpuçları - Prompt’u 400 karakterin altında ve İngilizce tutun; daha uzun metin kırpılır. Şekil, malzeme ve yüzey bitişi konusunda net olun. - `prompt`, `input_image_urls` ya da ikisini birden verin; hiçbirini göndermemek üretim aşamasında başarısız olur. - Temiz, animasyona uygun topoloji için `mesh_mode` alanını `Quad` olarak bırakın; daha yoğun bir üçgen mesh için `Raw` kullanın. - Yüzey detayı önemliyse `hd_texture` etkinleştirin; üretime hazır dokular için `material` alanını `PBR` olarak tutun. - İnsan benzeri modellerde rigging’e uygun bir T/A pozu için `TAPose` seçeneğini açın.

## Sınırlamalar - Mesh yoğunluğunun üst sınırı yaklaşık 200,000 quad poligon (`Quad`) ya da 1,000,000 üçgendir (`Raw`); daha yoğun mesh’ler için bu nesil doğru araç değildir. - Render edilmiş bir ön izleme döndürülmez — yalnızca mesh dosyası döner — bu yüzden sonuçları incelemek için bir 3D görüntüleyici kullanın.

## Gelişmiş Yapılandırma - `material`: `PBR` (varsayılan), `Shaded`, `All` ya da `None` — mesh’e hangi malzeme setinin pişirileceği. - `quality_override`: hedef poligon sayısı; modun varsayılanını kullanmak için boş bırakın. Geçerli aralık `mesh_mode` değerine bağlıdır (`Raw` 500–1,000,000, `Quad` 1,000–200,000).

ModelRunner JavaScript client ile çalıştırmak için: ```js import { modelrunner } from "@modelrunner/client";

const result = await modelrunner.subscribe("hyper3d/rodin/gen-2", { input: { prompt: "a vintage brass diving helmet with rounded portholes and rivets", mesh_mode: "Quad", geometry_file_format: "glb", material: "PBR", hd_texture: true, }, }); ```