Langkau ke kandungan

Hyper3D - Rodin V2.5 - Image to 3D

Integrasikan

ID model 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"

Permintaan ini: $0.40 400 kredit API Jalankan pada halaman ini

Dapatkan kunci API
Hyper3D Imej ke 3D Output 4KPantas #image-to-3d

Imej kepada 3D dengan Rodin V2.5 menggunakan sehingga 5 imej rujukan dan pilihan peringkat kualiti

Hyper3D · 3D

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

0 / 1024

Pandukan penjanaan dengan teks, atau biarkan model memperoleh prompt secara automatik daripada imej dengan mengosongkan medan ini dalam mod Image-to-3D.

Lanjutan 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
Lepaskan fail, atau · sehingga 5

URL imej sumber, terhad kepada 5 imej dan wajib dalam mod Image-to-3D, untuk menjana model.

geometry_file_format lalai glb

Format fail geometri, dipilih daripada glb, usdz, fbx, obj, stl; lalai ialah glb.

material lalai All

Pilihan output bahan: pilih None untuk geometri tanpa tekstur, atau All untuk menerima kedua-dua varian bahan. Untuk pencahayaan realistik dengan bahan berasaskan fizik, pilih PBR; untuk pencahayaan terprabina tanpa peta PBR, pilih Shaded.

texture_mode

Pilih kualiti tekstur secara jelas atau serahkan pilihan kepada API, yang menggunakan lalai sesuai dengan aras.

lalai Gen-2.5-High

Aras perincian mesh; meningkatkan aras menambah perincian, tetapi Gen-2.5-Minimum mengaktifkan mod minimum secara automatik dan memaksa 50K Triangle tanpa mengira quality_mesh_option. Butiran lanjut terdapat dalam [dokumentasi](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

lalai Auto

Topologi dan kualiti mesh, dengan bilangan muka yang tersedia ditentukan oleh aras: Extreme-Low, Low dan Medium membenarkan sehingga 1M Triangle; High dan Extreme-High menyokong 20K Triangle hingga 2M Triangle. Auto menggunakan tetapan yang disyorkan ini: 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. Untuk pilihan manual, Quad mengutamakan permukaan licin dan Triangle mengutamakan geometri terperinci; Hyper3D API menerima topologi sebagai `mesh_mode` (Quad/Raw) dan bilangan muka sebagai `quality_override`.

Seed rawak pilihan dengan julat 0–65535.

Hadkan saiz maksimum model yang dijana menggunakan ControlNet.

Pilihan tambahan pilihan, dibekalkan sebagai senarai atau, untuk satu tambahan sahaja, sebagai nilai tunggal.

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

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Hyper3D - Rodin V2.5 - Image to 3D

Membina model 3D daripada satu hingga lima imej dalam `image_urls`, dengan `prompt` pilihan sehingga 1024 aksara. Enam tahap berjulat dari Gen-2.5-Minimum hingga Gen-2.5-Extreme-High, dengan lalai High. Pilihan termasuk format geometri (glb, usdz, fbx, obj, stl), `material`, saiz jejaring segi empat atau segi tiga, `TAPose` untuk watak mesra rig, dan `hd_texture`.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
promptpilihan
Jenisstring
Lalai
≤ 1,024 aksara
Pandukan penjanaan dengan teks, atau biarkan model memperoleh prompt secara automatik daripada imej dengan mengosongkan medan ini dalam mod Image-to-3D.
image_urlspilihan images
Jenisurl[] · image
≤ 5 item
URL imej sumber, terhad kepada 5 imej dan wajib dalam mod Image-to-3D, untuk menjana model.
tierpilihan
Jenisenum
LalaiGen-2.5-High
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-LowGen-2.5-MediumGen-2.5-HighGen-2.5-Extreme-High
Aras perincian mesh; meningkatkan aras menambah perincian, tetapi Gen-2.5-Minimum mengaktifkan mod minimum secara automatik dan memaksa 50K Triangle tanpa mengira quality_mesh_option. Butiran lanjut terdapat dalam [dokumentasi](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
use_original_alphapilihan
Jenisboolean
Lalaifalse
Mengawal pengekalan saluran ketelusan imej input semasa menjana kandungan 3D.
seedpilihan
Jenisinteger | null
0 – 65,535
Seed rawak pilihan dengan julat 0–65535.
geometry_file_formatpilihan
Jenisenum
Lalaiglb
glbusdzfbxobjstl
Format fail geometri, dipilih daripada glb, usdz, fbx, obj, stl; lalai ialah glb.
materialpilihan
Jenisenum
LalaiAll
PBRShadedAllNone
Pilihan output bahan: pilih None untuk geometri tanpa tekstur, atau All untuk menerima kedua-dua varian bahan. Untuk pencahayaan realistik dengan bahan berasaskan fizik, pilih PBR; untuk pencahayaan terprabina tanpa peta PBR, pilih Shaded.
quality_mesh_optionpilihan
Jenisenum
LalaiAuto
Auto4K Quad8K Quad18K Quad50K Quad100K Quad200K Quad2K Triangle20K Triangle50K Triangle150K Triangle500K Triangle1M Triangle2M Triangle
Topologi dan kualiti mesh, dengan bilangan muka yang tersedia ditentukan oleh aras: Extreme-Low, Low dan Medium membenarkan sehingga 1M Triangle; High dan Extreme-High menyokong 20K Triangle hingga 2M Triangle. Auto menggunakan tetapan yang disyorkan ini: 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. Untuk pilihan manual, Quad mengutamakan permukaan licin dan Triangle mengutamakan geometri terperinci; Hyper3D API menerima topologi sebagai `mesh_mode` (Quad/Raw) dan bilangan muka sebagai `quality_override`.
texture_modepilihan
Jenisenum
legacyextreme-lowlowmediumhigh
Pilih kualiti tekstur secara jelas atau serahkan pilihan kepada API, yang menggunakan lalai sesuai dengan aras.
enable_creative_modepilihan
Jenisboolean
Lalaifalse
Mod penjanaan kreatif, setara dengan `geometry_instruct_mode` yang ditetapkan kepada `creative` dalam Hyper3D API. Mendayakannya menjadikan penjanaan lebih teguh tanpa menjejaskan ketekalan output.
hd_texturepilihan
Jenisboolean
Lalaifalse
Mengawal pemprosesan pasca tekstur lanjutan untuk memperbaik kesetiaan visual.
texture_delightpilihan
Jenisboolean
Lalaifalse
Membuang pencahayaan dan sorotan terprabina daripada tekstur yang dijana.
is_micropilihan
Jenisboolean
Lalaifalse
Menambah perincian geometri yang lebih halus pada skala mikro; hanya berkuat kuasa apabila `tier="Gen-2.5-Extreme-High"`.
TAPosepilihan
Jenisboolean
Lalaifalse
Tetapan pose watak untuk pemrigaan dan animasi yang lebih mudah dalam perisian 3D: mendayakannya menjana watak dalam pose T atau A.
bbox_conditionpilihan
Jenisobject
Hadkan saiz maksimum model yang dijana menggunakan ControlNet.
bbox_condition.widthpilihan
Jenisinteger
Lalai0
1 – 2,048
Lebar kekangan kotak pembatas sepanjang paksi x.
bbox_condition.heightpilihan
Jenisinteger
Lalai0
1 – 2,048
Tinggi kekangan kotak pembatas sepanjang paksi y.
bbox_condition.lengthpilihan
Jenisinteger
Lalai0
1 – 2,048
Panjang kekangan kotak pembatas sepanjang paksi z.
addonspilihan
Jenisobject
Pilihan tambahan pilihan, dibekalkan sebagai senarai atau, untuk satu tambahan sahaja, sebagai nilai tunggal.
addons.high_packpilihan
Jenisboolean
Lalaifalse
Peningkatan HighPack: output Quad mempunyai kira-kira 16 kali ganda bilangan muka yang diminta melalui parameter kualiti, dan tekstur menggunakan resolusi 4K berbanding lalai 2K.
preview_renderpilihan
Jenisboolean
Lalaifalse
Suis pratonton render yang menambah imej yang menunjukkan model 3D yang dijana kepada fail model yang dihantar.
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Pemeriksaan boleh dilonggarkan dengan menetapkannya kepada false, jika pemanggil dibenarkan.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

Output

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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
model_mesh
object {url, content_type, file_name, file_size}Fail yang mengandungi objek 3D yang dijana.
model_meshes
array of object {url, content_type, file_name, file_size}Fail objek 3D tambahan yang dijana oleh Hyper3D dan dikembalikan selain model_mesh.
seed
integerSeed yang digunakan semasa penjanaan.
textures
array of object {url, content_type, file_name, file_size, width, height}Tekstur yang dihasilkan untuk objek 3D.

Lebih banyak model: Imej ke 3D

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/hyper3d/rodin/v2.5.md. Semua model dan panduan: https://doitong.com/developers/llms.txt