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

Rodin by Hyper3D API

hyper3d/rodin

Bir metin prompt’undan ya da bir veya birden fazla referans görselden üretime hazır, dokulu bir 3D model (GLB, USDZ, FBX, OBJ ya da STL) üretin.

0.4
OpenAPI

Model girdisi

Input

Text description of the 3D object to generate. Required for text-to-3D (provide this OR one or more input images).

One or more image URLs to reconstruct into a 3D model. Required for image-to-3D (provide these OR a text prompt). Multiple images are combined per the condition_mode setting.

Additional Settings

Customize your input with more control.

How multiple input images are combined: concat treats them as different views of the same object; fuse blends features from distinct references. Only relevant when input_image_urls has more than one image.

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

Export format of the generated 3D mesh.

Material type baked into the mesh: PBR (physically based) or Shaded.

Generation quality; higher values yield denser geometry and richer textures at the cost of speed.

Enable enhanced geometry export for finer surface detail.

Generation tier: Regular for full generation, or Sketch for a faster rough pass.

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

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

Model çıktısı

Output

Loading
Generated in 108.846 seconds
Logs (1 lines)

Örnek istekler

Örnekler

Rodin by Hyper3D API

Rodin 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.4 per output.

POST https://queue.modelrunner.run/hyper3d/rodin

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 \
  -H "Authorization: Key $MRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tier": "Regular",
    "TAPose": false,
    "prompt": "A stylized medieval treasure chest with iron bands and a domed wooden lid, ornate metal latch, game-ready prop",
    "quality": "medium",
    "material": "PBR",
    "use_hyper": false,
    "condition_mode": "concat",
    "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/requests/$REQUEST_ID/status" \
  -H "Authorization: Key $MRUN_API_KEY"
curl "https://queue.modelrunner.run/hyper3d/rodin/requests/$REQUEST_ID" \
  -H "Authorization: Key $MRUN_API_KEY"

JavaScript

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

const result = await modelrunner.subscribe("hyper3d/rodin", {
  input: {
    "tier": "Regular",
    "TAPose": false,
    "prompt": "A stylized medieval treasure chest with iron bands and a domed wooden lid, ornate metal latch, game-ready prop",
    "quality": "medium",
    "material": "PBR",
    "use_hyper": false,
    "condition_mode": "concat",
    "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",
    headers=headers,
    json={
      "tier": "Regular",
      "TAPose": false,
      "prompt": "A stylized medieval treasure chest with iron bands and a domed wooden lid, ornate metal latch, game-ready prop",
      "quality": "medium",
      "material": "PBR",
      "use_hyper": false,
      "condition_mode": "concat",
      "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 by Hyper3D
NameTypeRequiredDescription
promptstringnoText description of the 3D object to generate. Required for text-to-3D (provide this OR one or more input images). Default: "".
input_image_urlsarraynoOne or more image URLs to reconstruct into a 3D model. Required for image-to-3D (provide these OR a text prompt). Multiple images are combined per the condition_mode setting.
condition_modeenumnoHow multiple input images are combined: concat treats them as different views of the same object; fuse blends features from distinct references. Only relevant when input_image_urls has more than one image. One of: fuse, concat. Default: "concat".
seedintegernoRandom seed for reproducible generation. Leave unset for a random result.
geometry_file_formatenumnoExport format of the generated 3D mesh. One of: glb, usdz, fbx, obj, stl. Default: "glb".
materialenumnoMaterial type baked into the mesh: PBR (physically based) or Shaded. One of: PBR, Shaded. Default: "PBR".
qualityenumnoGeneration quality; higher values yield denser geometry and richer textures at the cost of speed. One of: high, medium, low, extra-low. Default: "medium".
use_hyperbooleannoEnable enhanced geometry export for finer surface detail. Default: false.
tierenumnoGeneration tier: Regular for full generation, or Sketch for a faster rough pass. One of: Regular, Sketch. Default: "Regular".
TAPosebooleannoGenerate human-like models in a rig-friendly T/A pose. Default: false.

Machine-readable: OpenAPI schema · llms.txt

Use Rodin by Hyper3D from Claude & Cursor (MCP)

Point Claude Code, Claude Desktop, Cursor, or any MCP client at the ModelRunner MCP server and Rodin 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.

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 on ModelRunner to generate 3d”. MCP setup guide.

Model Detayları

Model Detayları

Hyper3D’nin Rodin modeli, bir metin açıklamasını ya da bir veya birden fazla referans görseli eksiksiz, dokulu bir 3D modele dönüştürür. Bir prompt (text-to-3D), bir görsel ya da görsel seti (image-to-3D) ya da ikisini birden verirsiniz; model, PBR malzemeleri içine pişirilmiş, indirilebilir bir mesh döndürür — yalnızca nokta bulutu değil, geometri artı yüzey malzemesi. Hızlı ön izlemelerden yüksek detaylı üretim varlıklarına kadar pipeline’ınıza uyacak dışa aktarma biçimini (GLB, USDZ, FBX, OBJ ya da STL) ve kalite kademesini seçin. Öne çıkan yanı, her iki girdi modunu tek bir endpoint üzerinden işlemesi ve oyunlar, AR/VR ve 3D baskı için gerçekten üretime hazır varlıklar üretmesidir.

## En uygun olduğu işler - Bir ürün ya da konsept fotoğrafını oyunlar ya da AR için dokulu bir 3D varlığa dönüştürmek - Referans görsel olmadığında bir metin açıklamasından 3D model üretmek - Daha temiz geometri için bir nesneyi aynı öznenin birkaç görünümünden yeniden kurmak - Motorunuzun ihtiyaç duyduğu belirli biçimde mesh üretmek (Apple AR için USDZ, DCC araçları için FBX/OBJ, 3D baskı için STL) - Nötr bir T/A pozunun rigging’e yardımcı olduğu insan ya da karakter modelleri

## Ş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 image-to-image modeli kullanın - Durağan bir mesh yerine animasyonlu bir 3D sahne ya da video gerekiyorsa — bir image-to-video modeli kullanın - Geometriyi yeniden kurmak yerine mevcut bir fotoğrafı düzenlemek istiyorsanız — bir görsel düzenleme modeli kullanın

## İpuçları - `prompt` ya da `input_image_urls` verin (ya da ikisini birden). Hiçbirini göndermemek üretim aşamasında başarısız olur. - Çoklu görsel girdisinde, görseller aynı nesnenin farklı görünümleriyse `condition_mode` alanını `concat`, farklı referansların özelliklerini birleştiriyorsanız `fuse` yapın. - `geometry_file_format` alanını hedef pipeline’ınıza göre ayarlayın; çıktı URL’si her zaman seçilen biçimdeki bir mesh’e işaret eder. - İnsan benzeri modellerde rigging’e uygun bir T/A pozu için `TAPose` etkinleştirin.

## Gelişmiş Yapılandırma - `condition_mode`: `concat` (tek nesnenin çoklu görünümü, varsayılan) ya da `fuse` (farklı referans görsellerin özelliklerini harmanla). Yalnızca birden fazla `input_image_urls` ile anlamlıdır. - `quality`: `high`, `medium` (varsayılan), `low` ya da `extra-low` — detay ile hız arasında denge kurun. Daha yüksek kalite daha yoğun geometri ve daha zengin dokular verir. - `tier`: tam üretim için `Regular` (varsayılan) ya da daha hızlı kaba bir geçiş için `Sketch`. - `material`: `PBR` (varsayılan, fiziksel tabanlı) ya da `Shaded`. - `use_hyper`: daha ince yüzey detayı için gelişmiş geometri dışa aktarımını etkinleştirin.

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

const result = await modelrunner.subscribe("hyper3d/rodin", { input: { prompt: "A simple wooden stool", geometry_file_format: "glb", quality: "medium", tier: "Regular", material: "PBR", }, }); ```