Zum Inhalt springen

Hyper3D - Rodin V2.5 - Image to 3D

Integrieren

Modell-ID hyper3d/rodin/v2.5
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hyper3d/rodin/v2.5?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": ""
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Diese Anfrage: 0,40 $ 400 API-Credits Auf dieser Seite ausführen

API-Schlüssel abrufen
Hyper3D Bild zu 3D 4K-AusgabeSchnell #image-to-3d

Bild-zu-3D mit Rodin V2.5 aus bis zu 5 Referenzbildern und wählbaren Qualitätsstufen

Hyper3D · 3D

Dein erstes Ergebnis erscheint hier

Erstelle unten eine Anfrage und führe sie mit deinem API-Schlüssel aus. Ausgaben werden in unseren Speicher kopiert und dauerhaft oder 7 Tage kostenlos aufbewahrt.

Anfrage erstellen

Die Steuerelemente werden aus dem Modellschema generiert. Code und Preis werden aktualisiert, während du sie änderst.

0 / 1024

Steuern Sie die Generierung mit Text oder lassen Sie das Feld im Image-to-3D-Modus leer, damit das Modell automatisch einen Prompt aus den Bildern ableitet.

Erweitert images · geometry_file_format · material · texture_mode · tier · quality_mesh_option · seed · use_original_alpha · enable_creative_mode · hd_texture · texture_delight · is_micro · TAPose · preview_render · enable_safety_checker · bbox_condition · addons
image_urls
Datei ablegen oder · bis zu 5

URLs der Quellbilder zur Generierung des Modells; auf 5 Bilder begrenzt und im Image-to-3D-Modus erforderlich.

geometry_file_format Standard glb

Dateiformat der Geometrie, wählbar aus glb, usdz, fbx, obj, stl; Standard ist glb.

material Standard All

Auswahl der Materialausgabe: Wählen Sie None für Geometrie ohne Texturen oder All, um beide Materialvarianten zu erhalten. Wählen Sie PBR für realistische Beleuchtung mit physikalisch basierten Materialien oder Shaded für vorberechnete Beleuchtung ohne PBR-Maps.

texture_mode

Wählen Sie die Texturqualität explizit oder überlassen Sie die Auswahl der API, die einen zur Stufe passenden Standard verwendet.

Standard Gen-2.5-High

Detailstufe des Meshs; eine höhere Stufe erhöht den Detailgrad. Gen-2.5-Minimum aktiviert jedoch automatisch den Minimalmodus und erzwingt 50K Triangle unabhängig von quality_mesh_option. Weitere Details finden Sie in der [Dokumentation](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

Standard Auto

Mesh-Topologie und Qualität, wobei die verfügbaren Flächenzahlen von der Stufe abhängen: Extreme-Low, Low und Medium erlauben bis zu 1M Triangle; High und Extreme-High unterstützen 20K Triangle bis 2M Triangle. Auto wendet diese empfohlenen Einstellungen an: 1. Gen-2.5-Minimum → 50K Triangle; 2. Gen-2.5-Extreme-Low → 50K Triangle; 3. Gen-2.5-Low → 50K Triangle; 4. Gen-2.5-Medium → 500K Triangle; 5. Gen-2.5-High → 500K Triangle; Gen-2.5-Extreme-High → 1M Triangle. Bei manueller Auswahl eignet sich Quad für glatte Oberflächen und Triangle für detaillierte Geometrie; die Hyper3D API erhält die Topologie als `mesh_mode` (Quad/Raw) und die Flächenzahl als `quality_override`.

Optionaler Zufalls-Seed im Bereich von 0–65535.

Begrenzen Sie die Größe des generierten Modells mithilfe eines ControlNet.

Optionale Auswahl von Erweiterungen, als Liste oder bei nur einer Erweiterung als Einzelwert.

POST /run/hyper3d/rodin/v2.5?wait=20 Preis → 0,40 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hyper3d/rodin/v2.5?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": ""
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Diese Anfrage ausführen

Dein Schlüssel bleibt in diesem Browser: Er wird nur an die Doitong API gesendet und nur gespeichert (localStorage), wenn du „Merken“ aktivierst. API-Schlüssel abrufen

Über Hyper3D - Rodin V2.5 - Image to 3D

Erstellt ein 3D-Modell aus einem bis fünf Bildern in `image_urls`, mit optionalem `prompt` mit bis zu 1024 Zeichen. Sechs Stufen reichen von Gen-2.5-Minimum bis Gen-2.5-Extreme-High, standardmäßig High. Optionen umfassen das Geometrieformat (glb, usdz, fbx, obj, stl), `material`, Quad- oder Dreiecks-Meshgrößen, `TAPose` für rig-freundliche Charaktere und `hd_texture`.

Parameter

Sende entweder den kanonischen Namen oder den nativen Namen, nicht beide. Kanonische Namen

NameTyp StandardZulässig Beschreibung
promptoptional
Typstring
Standard
≤ 1.024 Zeichen
Steuern Sie die Generierung mit Text oder lassen Sie das Feld im Image-to-3D-Modus leer, damit das Modell automatisch einen Prompt aus den Bildern ableitet.
image_urlsoptional images
Typurl[] · image
≤ 5 Elemente
URLs der Quellbilder zur Generierung des Modells; auf 5 Bilder begrenzt und im Image-to-3D-Modus erforderlich.
tieroptional
Typenum
StandardGen-2.5-High
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-LowGen-2.5-MediumGen-2.5-HighGen-2.5-Extreme-High
Detailstufe des Meshs; eine höhere Stufe erhöht den Detailgrad. Gen-2.5-Minimum aktiviert jedoch automatisch den Minimalmodus und erzwingt 50K Triangle unabhängig von quality_mesh_option. Weitere Details finden Sie in der [Dokumentation](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
use_original_alphaoptional
Typboolean
Standardfalse
Steuert die Beibehaltung der Transparenzkanäle der Eingabebilder bei der Generierung von 3D-Inhalten.
seedoptional
Typinteger | null
0 – 65.535
Optionaler Zufalls-Seed im Bereich von 0–65535.
geometry_file_formatoptional
Typenum
Standardglb
glbusdzfbxobjstl
Dateiformat der Geometrie, wählbar aus glb, usdz, fbx, obj, stl; Standard ist glb.
materialoptional
Typenum
StandardAll
PBRShadedAllNone
Auswahl der Materialausgabe: Wählen Sie None für Geometrie ohne Texturen oder All, um beide Materialvarianten zu erhalten. Wählen Sie PBR für realistische Beleuchtung mit physikalisch basierten Materialien oder Shaded für vorberechnete Beleuchtung ohne PBR-Maps.
quality_mesh_optionoptional
Typenum
StandardAuto
Auto4K Quad8K Quad18K Quad50K Quad100K Quad200K Quad2K Triangle20K Triangle50K Triangle150K Triangle500K Triangle1M Triangle2M Triangle
Mesh-Topologie und Qualität, wobei die verfügbaren Flächenzahlen von der Stufe abhängen: Extreme-Low, Low und Medium erlauben bis zu 1M Triangle; High und Extreme-High unterstützen 20K Triangle bis 2M Triangle. Auto wendet diese empfohlenen Einstellungen an: 1. Gen-2.5-Minimum → 50K Triangle; 2. Gen-2.5-Extreme-Low → 50K Triangle; 3. Gen-2.5-Low → 50K Triangle; 4. Gen-2.5-Medium → 500K Triangle; 5. Gen-2.5-High → 500K Triangle; Gen-2.5-Extreme-High → 1M Triangle. Bei manueller Auswahl eignet sich Quad für glatte Oberflächen und Triangle für detaillierte Geometrie; die Hyper3D API erhält die Topologie als `mesh_mode` (Quad/Raw) und die Flächenzahl als `quality_override`.
texture_modeoptional
Typenum
legacyextreme-lowlowmediumhigh
Wählen Sie die Texturqualität explizit oder überlassen Sie die Auswahl der API, die einen zur Stufe passenden Standard verwendet.
enable_creative_modeoptional
Typboolean
Standardfalse
Kreativer Generierungsmodus, entspricht `geometry_instruct_mode` mit dem Wert `creative` in der Hyper3D API. Die Aktivierung macht die Generierung robuster, ohne die Konsistenz der Ausgabe zu beeinträchtigen.
hd_textureoptional
Typboolean
Standardfalse
Steuert die erweiterte Textur-Nachbearbeitung zur Verbesserung der visuellen Wiedergabetreue.
texture_delightoptional
Typboolean
Standardfalse
Entfernt vorberechnete Beleuchtung und Glanzlichter aus generierten Texturen.
is_microoptional
Typboolean
Standardfalse
Fügt feinere geometrische Details im Mikrobereich hinzu; wirkt nur bei `tier="Gen-2.5-Extreme-High"`.
TAPoseoptional
Typboolean
Standardfalse
Einstellung der Figurenpose für einfacheres Rigging und Animieren in 3D-Software: Bei Aktivierung werden Figuren entweder in T-Pose oder A-Pose generiert.
bbox_conditionoptional
Typobject
Begrenzen Sie die Größe des generierten Modells mithilfe eines ControlNet.
bbox_condition.widthoptional
Typinteger
Standard0
1 – 2.048
Breite der Begrenzungsbox entlang der x-Achse.
bbox_condition.heightoptional
Typinteger
Standard0
1 – 2.048
Höhe der Begrenzungsbox entlang der y-Achse.
bbox_condition.lengthoptional
Typinteger
Standard0
1 – 2.048
Länge der Begrenzungsbox entlang der z-Achse.
addonsoptional
Typobject
Optionale Auswahl von Erweiterungen, als Liste oder bei nur einer Erweiterung als Einzelwert.
addons.high_packoptional
Typboolean
Standardfalse
HighPack-Erweiterung: Die Quad-Ausgabe hat etwa 16-mal so viele Flächen wie über den Parameter quality angefordert, und Texturen verwenden eine Auflösung von 4K statt des Standards 2K.
preview_renderoptional
Typboolean
Standardfalse
Schalter für das Vorschau-Rendering, der den gelieferten Modelldateien ein Bild des generierten 3D-Modells hinzufügt.
enable_safety_checkeroptional
Typboolean
Standardtrue
Die Prüfung kann durch Setzen auf false gelockert werden, sofern der Aufrufer dazu berechtigt ist.
erforderlich Kanonischer Name, ebenfalls akzeptiert

Dateiparameter akzeptieren eine öffentliche https://-URL, eine data:-URI bis 10 MB oder die file_url eines Uploads. Dateien

Ausgabe

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 400,
    "usd": "0.40",
    "charged": 400,
    "refunded": 0
  },
  "input": {
    "prompt": ""
  },
  "output": {
    "model_mesh": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "model_meshes": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    ],
    "seed": 42,
    "textures": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ]
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Deine Dateien, deine EntscheidungJede outputs[].url ist eine Kopie in unserem Speicher: dauerhaft aufbewahrt (Abrechnung pro GB-Monat) oder 7 Tage kostenlos – je nach Kontoeinstellung oder ?storage=.
Gleiche Struktur bei jedem Modelltype, url, content_type, width, height und duration – für Bilder, Video und Audio gleichermaßen. output ist das Ergebnisobjekt des Modells.
Ausgabefelder
model_mesh
object {url, content_type, file_name, file_size}Datei mit dem generierten 3D-Objekt.
model_meshes
array of object {url, content_type, file_name, file_size}Zusätzliche 3D-Objektdateien, die von Hyper3D generiert und zusätzlich zu model_mesh zurückgegeben werden.
seed
integerWährend der Generierung angewendeter Seed.
textures
array of object {url, content_type, file_name, file_size, width, height}Für das 3D-Objekt erzeugte Texturen.

Weitere Modelle: Bild zu 3D

Für KI-Agenten: Diese Seite ist als Markdown verfügbar unter https://doitong.com/de/developers/models/hyper3d/rodin/v2.5.md. Alle Modelle und Anleitungen: https://doitong.com/developers/llms.txt