Přejít na obsah

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

Integrace

ID modelu hyper3d/rodin/v2.5/fast
# 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/fast?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Tento požadavek: 0,10 $ 100 kreditů API · ≈ 10,47 ₽ Spustit na této stránce

Získat API klíč
Hyper3D Obrázek na 3D Výstup 4KRychlé #image-to-3d

Rychlejší převod obrázku na 3D pomocí Rodin V2.5 omezený na tři nejnižší úrovně pro rychlé prototypování

Hyper3D · 3D

Zde se zobrazí váš první výsledek

Níže sestavte požadavek a spusťte ho pomocí svého API klíče. Výstupy se kopírují do našeho úložiště a uchovávají se navždy nebo 7 dne zdarma.

Sestavit požadavek

Ovládací prvky se generují ze schématu modelu. Kód a cena se aktualizují podle provedených změn.

0 / 1024

Veďte generování textem, nebo ponechte toto pole v režimu Image-to-3D prázdné a nechte model automaticky odvodit prompt z obrázků.

Pokročilé 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
image_urls
Přetáhněte soubor nebo · až 5

URL zdrojových obrázků, omezené na 5 obrázků a povinné v režimu Image-to-3D, pro generování modelu.

geometry_file_format výchozí glb

Formát souboru geometrie vybraný z glb, usdz, fbx, obj, stl; výchozí je glb.

material výchozí Shaded

Výběr výstupu materiálu: zvolte None pro geometrii bez textur nebo All pro obě varianty materiálu. Pro realistické osvětlení s fyzikálně založenými materiály zvolte PBR; pro předpečené osvětlení bez map PBR zvolte Shaded.

texture_mode

Zvolte kvalitu textury explicitně, nebo ponechte volbu na API, které použije výchozí hodnotu vhodnou pro danou úroveň.

výchozí Gen-2.5-Extreme-Low

Úroveň generování; Gen-2.5-Minimum vynutí minimální režim a mesh 50K Triangle bez ohledu na `quality_mesh_option`. Podrobnosti o úrovních jsou v [dokumentaci Hyper3D](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

výchozí Auto

Zvolte kvalitu společně s topologií meshe: Quad upřednostňuje hladké povrchy, zatímco Triangle geometrické detaily. Rychlý endpoint je určen hlavně pro testování a prototypování s limitem 20K; pro kvalitnější meshe použijte standardní endpoint, kde Minimum, Extreme-Low a Low podporují až 1M Triangle a dostupné počty ploch závisí na úrovni. V Hyper3D API určuje `quality_override` počet ploch, zatímco `mesh_mode` určuje Quad/Raw. Auto vybere doporučená nastavení: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.

Volitelný seed pro náhodnost v rozsahu 0–65535.

Omezí velikost vygenerovaného modelu pomocí ControlNet.

POST /run/hyper3d/rodin/v2.5/fast?wait=20 cena → 0,10 $
# 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/fast?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Spustit tento požadavek

Váš klíč zůstává v tomto prohlížeči: odesílá se pouze do Doitong API a uloží se do localStorage jen tehdy, když zaškrtnete možnost Zapamatovat. Získat klíč API

O modelu Hyper3D - Rodin V2.5 - Image to 3D - Fast

Vytvoří 3D model z jednoho až pěti obrázků v `image_urls` s volitelným `prompt`. `tier` je omezen na Minimum, Extreme-Low (výchozí) a Low a možnosti sítě dosahují nejvýše 20K ploch. Výchozí materiál je Shaded. Výstupní formáty jsou glb, usdz, fbx, obj nebo stl.

Parametry

Odešlete buď kanonický název, nebo nativní název, ne oba. Kanonické názvy

NázevTyp VýchozíPovolené Popis
image_urlsvolitelné images
Typurl[] · image
≤ 5 položek
URL zdrojových obrázků, omezené na 5 obrázků a povinné v režimu Image-to-3D, pro generování modelu.
tiervolitelné
Typenum
VýchozíGen-2.5-Extreme-Low
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-Low
Úroveň generování; Gen-2.5-Minimum vynutí minimální režim a mesh 50K Triangle bez ohledu na `quality_mesh_option`. Podrobnosti o úrovních jsou v [dokumentaci Hyper3D](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
promptvolitelné
Typstring
Výchozí
≤ 1 024 znaků
Veďte generování textem, nebo ponechte toto pole v režimu Image-to-3D prázdné a nechte model automaticky odvodit prompt z obrázků.
use_original_alphavolitelné
Typboolean
Výchozífalse
Řídí zachování kanálů průhlednosti vstupního obrázku při generování 3D obsahu.
seedvolitelné
Typinteger | null
0 – 65 535
Volitelný seed pro náhodnost v rozsahu 0–65535.
geometry_file_formatvolitelné
Typenum
Výchozíglb
glbusdzfbxobjstl
Formát souboru geometrie vybraný z glb, usdz, fbx, obj, stl; výchozí je glb.
materialvolitelné
Typenum
VýchozíShaded
PBRShadedAllNone
Výběr výstupu materiálu: zvolte None pro geometrii bez textur nebo All pro obě varianty materiálu. Pro realistické osvětlení s fyzikálně založenými materiály zvolte PBR; pro předpečené osvětlení bez map PBR zvolte Shaded.
quality_mesh_optionvolitelné
Typenum
VýchozíAuto
Auto1K Quad4K Quad8K Quad18K Quad20K Quad2K Triangle4K Triangle8K Triangle10K Triangle20K Triangle
Zvolte kvalitu společně s topologií meshe: Quad upřednostňuje hladké povrchy, zatímco Triangle geometrické detaily. Rychlý endpoint je určen hlavně pro testování a prototypování s limitem 20K; pro kvalitnější meshe použijte standardní endpoint, kde Minimum, Extreme-Low a Low podporují až 1M Triangle a dostupné počty ploch závisí na úrovni. V Hyper3D API určuje `quality_override` počet ploch, zatímco `mesh_mode` určuje Quad/Raw. Auto vybere doporučená nastavení: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.
texture_modevolitelné
Typenum
legacyextreme-lowlowmediumhigh
Zvolte kvalitu textury explicitně, nebo ponechte volbu na API, které použije výchozí hodnotu vhodnou pro danou úroveň.
enable_creative_modevolitelné
Typboolean
Výchozífalse
Kreativní režim generování, odpovídající nastavení `geometry_instruct_mode` na `creative` v Hyper3D API. Jeho povolení zvyšuje robustnost generování bez snížení konzistence výstupu.
hd_texturevolitelné
Typboolean
Výchozífalse
Řídí pokročilé následné zpracování textur pro zlepšení vizuální věrnosti.
texture_delightvolitelné
Typboolean
Výchozífalse
Odstraní z vygenerovaných textur předpečené osvětlení a odlesky.
is_microvolitelné
Typboolean
Výchozífalse
Přidá jemnější geometrické detaily v mikroměřítku; projeví se pouze při `tier="Gen-2.5-Extreme-High"`.
TAPosevolitelné
Typboolean
Výchozífalse
Nastavení pozice postavy pro snazší rigging a animaci v 3D softwaru: povolení generuje postavy v pozici T nebo A.
bbox_conditionvolitelné
Typobject
Omezí velikost vygenerovaného modelu pomocí ControlNet.
bbox_condition.widthvolitelné
Typinteger
Výchozí0
1 – 2 048
Omezení šířky ohraničujícího boxu podél osy x.
bbox_condition.heightvolitelné
Typinteger
Výchozí0
1 – 2 048
Omezení výšky ohraničujícího boxu podél osy y.
bbox_condition.lengthvolitelné
Typinteger
Výchozí0
1 – 2 048
Omezení délky ohraničujícího boxu podél osy z.
preview_rendervolitelné
Typboolean
Výchozífalse
Přepínač náhledu vykreslení, který k doručeným souborům modelu přidá obrázek vygenerovaného 3D modelu.
enable_safety_checkervolitelné
Typboolean
Výchozítrue
Kontrolu lze uvolnit nastavením na false, pokud je volající autorizován.
povinné Kanonický název, také podporován

Parametry souborů přijímají veřejnou adresu https:// URL, data: URI do 10 MB nebo file_url nahraného souboru. Soubory

Výstup

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5/fast",
  "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": 100,
    "usd": "0.10",
    "charged": 100,
    "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Vaše soubory, vaše volbaKaždý outputs[].url je kopie v našem úložišti: uchovávaná navždy (zpoplatněná za GB-měsíc) nebo 7 dne zdarma podle nastavení účtu nebo ?storage=.
Stejná struktura u každého modelutype, url, content_type, width, height a duration pro obrázky, video i zvuk. output je vlastní objekt výsledku modelu.
Pole výstupu
model_mesh
object {url, content_type, file_name, file_size}Soubor obsahující vygenerovaný 3D objekt.
model_meshes
array of object {url, content_type, file_name, file_size}Další soubory 3D objektu vytvořené pomocí Hyper3D a vrácené kromě model_mesh.
seed
integerSeed použitý během generování.
textures
array of object {url, content_type, file_name, file_size, width, height}Textury vytvořené pro 3D objekt.

Další modely: Obrázek na 3D

Pro AI agenty: tato stránka je ve formátu Markdown na adrese https://doitong.com/cs/developers/models/hyper3d/rodin/v2.5/fast.md. Všechny modely a návody: https://doitong.com/developers/llms.txt