Langkau ke kandungan

Hyper3D - Rodin V2.5 - Text to 3D

Integrasikan

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

Permintaan ini: $0.40 400 kredit API · ≈ ₽43.03 Jalankan pada halaman ini

Dapatkan kunci API
Hyper3D Teks ke 3D Output 4KPantas #text-to-3d

Teks kepada 3D dengan Rodin V2.5 merentasi enam peringkat, daripada prompt sehingga 1024 aksara

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.

•diperlukan 88 / 1024

Arahan teks yang memandu penjanaan model; wajib dalam mod Text-to-3D.

Lanjutan 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 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 untuk digunakan, jika diperlukan.

POST /run/hyper3d/rodin/v2.5/text-to-3d?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.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"

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 - Text to 3D

Menjana model 3D daripada `prompt` wajib sehingga 1024 aksara. Pilih `tier` dari Gen-2.5-Minimum hingga Gen-2.5-Extreme-High (lalai High), saiz jejaring dalam segi empat atau segi tiga, dan `material` seperti PBR atau Shaded. Eksport sebagai glb, usdz, fbx, obj atau stl, dan tetapkan `seed` antara 0 hingga 65535.

Parameter

NamaJenis LalaiDibenarkan Penerangan
promptdiperlukan
Jenisstring
≤ 1,024 aksara
Arahan teks yang memandu penjanaan model; wajib dalam mod Text-to-3D.
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).
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 untuk digunakan, jika diperlukan.
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.
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Pemeriksaan boleh dilonggarkan dengan menetapkannya kepada false, jika pemanggil dibenarkan.
diperlukan

Output

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"
  }
}
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: Teks ke 3D

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