İçeriğe geç

Hyper3D - Rodin V2.5 - Image to 3D

Entegre et

Model kimliği 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"

Bu istek: $0,40 400 API kredisi Bu sayfada çalıştır

API anahtarı al
Hyper3D Görselden 3D'ye 4K çıktıHızlı #image-to-3d

En fazla 5 referans görüntüsü ve kalite kademesi seçimiyle Rodin V2.5 görüntüden 3D

Hyper3D · 3D

İlk sonucunuz burada görünecek

Aşağıda bir istek oluşturun ve API anahtarınızla çalıştırın. Çıktılar depolamamıza kopyalanır ve sonsuza kadar veya ücretsiz olarak 7 gün boyunca saklanır.

İstek oluştur

Kontroller model şemasından oluşturulur. Değerleri değiştirdikçe kod ve fiyat güncellenir.

0 / 1024

Üretimi metinle yönlendirin veya Image-to-3D modunda bunu boş bırakarak modelin istemi görsellerden otomatik türetmesini sağlayın.

Gelişmiş 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
Dosyayı bırakın veya · 5 adede kadar

Model üretimi için en fazla 5 görselle sınırlı ve Image-to-3D modunda zorunlu kaynak görsel URL'leri.

geometry_file_format varsayılan glb

glb, usdz, fbx, obj, stl arasından seçilen geometri dosyası biçimi; varsayılan glb'dir.

material varsayılan All

Malzeme çıktı seçimi: dokusuz geometri için None, her iki malzeme çeşidini almak için All seçin. Fizik tabanlı malzemelerle gerçekçi aydınlatma için PBR, PBR haritaları olmadan önceden işlenmiş aydınlatma için Shaded seçin.

texture_mode

Doku kalitesini açıkça seçin veya katmana uygun varsayılanı kullanan seçimi API'ye bırakın.

varsayılan Gen-2.5-High

Mesh ayrıntı katmanı; katmanın artırılması ayrıntı ekler, ancak Gen-2.5-Minimum minimum modu otomatik olarak etkinleştirir ve quality_mesh_option'dan bağımsız olarak 50K Triangle zorunlu kılar. Ayrıntılar [belgelerde](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers) bulunur.

varsayılan Auto

Mesh topolojisi ve kalitesi; kullanılabilir yüz sayıları katman tarafından belirlenir: Extreme-Low, Low ve Medium en fazla 1M Triangle; High ve Extreme-High ise 20K Triangle ile 2M Triangle arasını destekler. Auto şu önerilen ayarları uygular: 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. Manuel seçimde Quad pürüzsüz yüzeyleri, Triangle ayrıntılı geometriyi önceliklendirir; Hyper3D API topolojiyi `mesh_mode` (Quad/Raw), yüz sayısını `quality_override` olarak alır.

0–65535 aralığında isteğe bağlı rastgeleleştirme tohumu.

ControlNet kullanarak üretilen modelin ne kadar büyük olabileceğini sınırlar.

Liste olarak veya tek bir eklenti için tek değer olarak sağlanan isteğe bağlı eklenti seçimi.

POST /run/hyper3d/rodin/v2.5?wait=20 fiyat → $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"

Bu isteği çalıştır

Anahtarınız bu tarayıcıda kalır: yalnızca Doitong API'ye gönderilir ve yalnızca Hatırla seçeneğini işaretlerseniz localStorage'a kaydedilir. API anahtarı al

Hyper3D - Rodin V2.5 - Image to 3D hakkında

`image_urls` içindeki bir ile beş görselden, isteğe bağlı en fazla 1024 karakterlik bir `prompt` ile 3D model oluşturur. Altı katman Gen-2.5-Minimum ile Gen-2.5-Extreme-High arasında değişir; varsayılan High'dır. Seçenekler arasında geometri biçimi (glb, usdz, fbx, obj, stl), `material`, dörtgen veya üçgen poligon ağı boyutları, iskelet eklemeye uygun karakterler için `TAPose` ve `hd_texture` bulunur.

Parametreler

Kanonik adı veya yerel adı gönderin; ikisini birden göndermeyin. Kanonik adlar

AdTür Varsayılanİzin verilen Açıklama
promptisteğe bağlı
Türstring
Varsayılan
≤ 1.024 karakter
Üretimi metinle yönlendirin veya Image-to-3D modunda bunu boş bırakarak modelin istemi görsellerden otomatik türetmesini sağlayın.
image_urlsisteğe bağlı images
Türurl[] · image
≤ 5 öğe
Model üretimi için en fazla 5 görselle sınırlı ve Image-to-3D modunda zorunlu kaynak görsel URL'leri.
tieristeğe bağlı
Türenum
VarsayılanGen-2.5-High
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-LowGen-2.5-MediumGen-2.5-HighGen-2.5-Extreme-High
Mesh ayrıntı katmanı; katmanın artırılması ayrıntı ekler, ancak Gen-2.5-Minimum minimum modu otomatik olarak etkinleştirir ve quality_mesh_option'dan bağımsız olarak 50K Triangle zorunlu kılar. Ayrıntılar [belgelerde](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers) bulunur.
use_original_alphaisteğe bağlı
Türboolean
Varsayılanfalse
3D içerik üretirken girdi görselinin saydamlık kanallarının korunmasını denetler.
seedisteğe bağlı
Türinteger | null
0 – 65.535
0–65535 aralığında isteğe bağlı rastgeleleştirme tohumu.
geometry_file_formatisteğe bağlı
Türenum
Varsayılanglb
glbusdzfbxobjstl
glb, usdz, fbx, obj, stl arasından seçilen geometri dosyası biçimi; varsayılan glb'dir.
materialisteğe bağlı
Türenum
VarsayılanAll
PBRShadedAllNone
Malzeme çıktı seçimi: dokusuz geometri için None, her iki malzeme çeşidini almak için All seçin. Fizik tabanlı malzemelerle gerçekçi aydınlatma için PBR, PBR haritaları olmadan önceden işlenmiş aydınlatma için Shaded seçin.
quality_mesh_optionisteğe bağlı
Türenum
VarsayılanAuto
Auto4K Quad8K Quad18K Quad50K Quad100K Quad200K Quad2K Triangle20K Triangle50K Triangle150K Triangle500K Triangle1M Triangle2M Triangle
Mesh topolojisi ve kalitesi; kullanılabilir yüz sayıları katman tarafından belirlenir: Extreme-Low, Low ve Medium en fazla 1M Triangle; High ve Extreme-High ise 20K Triangle ile 2M Triangle arasını destekler. Auto şu önerilen ayarları uygular: 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. Manuel seçimde Quad pürüzsüz yüzeyleri, Triangle ayrıntılı geometriyi önceliklendirir; Hyper3D API topolojiyi `mesh_mode` (Quad/Raw), yüz sayısını `quality_override` olarak alır.
texture_modeisteğe bağlı
Türenum
legacyextreme-lowlowmediumhigh
Doku kalitesini açıkça seçin veya katmana uygun varsayılanı kullanan seçimi API'ye bırakın.
enable_creative_modeisteğe bağlı
Türboolean
Varsayılanfalse
Hyper3D API'de `geometry_instruct_mode` değerinin `creative` olarak ayarlanmasına eşdeğer yaratıcı üretim modu. Etkinleştirilmesi çıktı tutarlılığından ödün vermeden üretimi daha dayanıklı hâle getirir.
hd_textureisteğe bağlı
Türboolean
Varsayılanfalse
Görsel doğruluğu iyileştirmek için gelişmiş doku son işleme yöntemlerini denetler.
texture_delightisteğe bağlı
Türboolean
Varsayılanfalse
Önceden işlenmiş aydınlatmayı ve vurguları üretilen dokulardan çıkarır.
is_microisteğe bağlı
Türboolean
Varsayılanfalse
Mikro ölçekte daha ince geometrik ayrıntı ekler; yalnızca `tier="Gen-2.5-Extreme-High"` olduğunda etkili olur.
TAPoseisteğe bağlı
Türboolean
Varsayılanfalse
3D yazılımında donatma ve animasyonu kolaylaştıran karakter pozu ayarı: etkinleştirildiğinde karakterleri T-pose veya A-pose olarak üretir.
bbox_conditionisteğe bağlı
Türobject
ControlNet kullanarak üretilen modelin ne kadar büyük olabileceğini sınırlar.
bbox_condition.widthisteğe bağlı
Türinteger
Varsayılan0
1 – 2.048
Sınırlayıcı kutu kısıtının x eksenindeki genişliği.
bbox_condition.heightisteğe bağlı
Türinteger
Varsayılan0
1 – 2.048
Sınırlayıcı kutu kısıtının y eksenindeki yüksekliği.
bbox_condition.lengthisteğe bağlı
Türinteger
Varsayılan0
1 – 2.048
Sınırlayıcı kutu kısıtının z eksenindeki uzunluğu.
addonsisteğe bağlı
Türobject
Liste olarak veya tek bir eklenti için tek değer olarak sağlanan isteğe bağlı eklenti seçimi.
addons.high_packisteğe bağlı
Türboolean
Varsayılanfalse
HighPack geliştirmesi: Quad çıktısı, quality parametresiyle istenen yüz sayısının yaklaşık 16 katını içerir ve dokular varsayılan 2K yerine 4K çözünürlük kullanır.
preview_renderisteğe bağlı
Türboolean
Varsayılanfalse
Teslim edilen model dosyalarına üretilen 3D modeli gösteren bir görsel ekleyen önizleme işleme anahtarı.
enable_safety_checkeristeğe bağlı
Türboolean
Varsayılantrue
Çağıran yetkiliyse false ayarlanarak tarama gevşetilebilir.
gerekli Kanonik ad, bu ad da kabul edilir

Dosya parametreleri herkese açık bir https:// URL'si, 10 MB'a kadar bir data: URI'si veya yüklenen bir dosyanın file_url değerini kabul eder. Dosyalar

Çıktı

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"
  }
}
Dosyalarınız, seçiminizHer outputs[].url, depolamamızdaki bir kopyadır: sonsuza kadar (GB-ay başına ücretli) veya ücretsiz olarak 7 gün boyunca, hesap ayarınızla ya da ?storage= ile saklanır.
Her modelde aynı yapıGörüntüler, video ve ses için type, url, content_type, width, height ve duration aynıdır. output, modelin kendi sonuç nesnesidir.
Çıktı alanları
model_mesh
object {url, content_type, file_name, file_size}Üretilen 3D nesneyi içeren dosya.
model_meshes
array of object {url, content_type, file_name, file_size}Hyper3D tarafından üretilen ve model_mesh'e ek olarak döndürülen ek 3D nesne dosyaları.
seed
integerÜretim sırasında uygulanan seed.
textures
array of object {url, content_type, file_name, file_size, width, height}3D nesne için üretilen dokular.

Daha fazla model: Görselden 3D'ye

AI aracıları için: bu sayfanın Markdown biçimi şurada: https://doitong.com/tr/developers/models/hyper3d/rodin/v2.5.md. Tüm modeller ve kılavuzlar: https://doitong.com/developers/llms.txt