İçeriğe geç

Hyper3D - Rodin V2.5 - Text to 3D

Entegre et

Model kimliği hyper3d/rodin/v2.5/text-to-3d
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/hyper3d/rodin/v2.5/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

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

Bu istek: $0,40 400 API kredisi · ≈ ₽43,03 Bu sayfada çalıştır

API anahtarı al
Hyper3D Metinden 3D'ye 4K çıktıHızlı #text-to-3d

En fazla 1024 karakterlik istemle altı kademede Rodin V2.5 metinden 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.

•gerekli 88 / 1024

Model üretimini yönlendiren metin talimatları; Text-to-3D modunda zorunludur.

Gelişmiş geometry_file_format · material · texture_mode · tier · quality_mesh_option · seed · enable_creative_mode · hd_texture · texture_delight · is_micro · TAPose · enable_safety_checker · bbox_condition · addons
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.

Gerekirse uygulanacak ek seçenekler.

POST /run/hyper3d/rodin/v2.5/text-to-3d?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.ru/v1/run/hyper3d/rodin/v2.5/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/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 - Text to 3D hakkında

Gerekli `prompt` ile en fazla 1024 karakterden 3D model üretir. Gen-2.5-Minimum ile Gen-2.5-Extreme-High arasında bir `tier` seçin (varsayılan High), dörtgen veya üçgen poligon ağı boyutu ve PBR ya da Shaded gibi bir `material` belirleyin. glb, usdz, fbx, obj veya stl olarak dışa aktarın ve `seed` değerini 0 ile 65535 arasında ayarlayın.

Parametreler

AdTür Varsayılanİzin verilen Açıklama
promptgerekli
Türstring
≤ 1.024 karakter
Model üretimini yönlendiren metin talimatları; Text-to-3D modunda zorunludur.
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.
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
Gerekirse uygulanacak ek seçenekler.
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.
enable_safety_checkeristeğe bağlı
Türboolean
Varsayılantrue
Çağıran yetkiliyse false ayarlanarak tarama gevşetilebilir.
gerekli

Çıktı

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5/text-to-3d",
  "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": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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: Metinden 3D'ye

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