Przejdź do treści

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

Integracja

Identyfikator 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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

To żądanie: 0,10 $ 100 kredytów API Uruchom na tej stronie

Uzyskaj klucz API
Hyper3D Obraz na 3D Wynik 4KSzybki #image-to-3d

Szybsze przekształcanie obrazu w 3D przez Rodin V2.5, ograniczone do trzech najniższych poziomów do szybkiego prototypowania

Hyper3D · 3D

Tutaj pojawi się pierwszy wynik

Zbuduj poniżej żądanie i uruchom je za pomocą klucza API. Wyniki są kopiowane do naszej przestrzeni dyskowej i przechowywane bezterminowo lub 7 dni bezpłatnie.

Zbuduj żądanie

Elementy sterujące są generowane ze schematu modelu. Kod i cena aktualizują się podczas ich zmiany.

0 / 1024

Kieruj generowaniem za pomocą tekstu albo pozwól modelowi automatycznie wyprowadzić prompt z obrazów, pozostawiając to pole puste w trybie Image-to-3D.

Zaawansowane 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
Upuść plik lub · do 5

Adresy URL obrazów źródłowych, maksymalnie 5 obrazów; wymagane w trybie Image-to-3D do wygenerowania modelu.

geometry_file_format domyślnie glb

Format pliku geometrii, wybierany spośród glb, usdz, fbx, obj, stl; domyślnie glb.

material domyślnie Shaded

Wybór wynikowego materiału: wybierz None dla geometrii bez tekstur albo All, aby otrzymać oba warianty materiału. Dla realistycznego oświetlenia i materiałów opartych na fizyce wybierz PBR; dla wypieczonego oświetlenia bez map PBR wybierz Shaded.

texture_mode

Wybierz jakość tekstury jawnie albo pozostaw wybór API, które używa wartości domyślnej odpowiedniej dla danego poziomu.

domyślnie Gen-2.5-Extreme-Low

Poziom generowania; Gen-2.5-Minimum wymusza tryb minimum i siatkę 50K Triangle niezależnie od `quality_mesh_option`. Szczegóły poziomów są dostępne w [dokumentacji Hyper3D](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

domyślnie Auto

Wybierz jakość wraz z topologią siatki: Quad sprzyja gładkim powierzchniom, a Triangle szczegółowości geometrii. Szybki endpoint jest przeznaczony głównie do testowania i prototypowania, z limitem 20K; dla siatek wyższej jakości użyj standardowego endpointu, w którym Minimum, Extreme-Low i Low obsługują do 1M Triangle, a dostępne liczby ścian zależą od poziomu. W Hyper3D API `quality_override` określa liczbę ścian, a `mesh_mode` określa Quad/Raw. Auto wybiera zalecane ustawienia: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.

Opcjonalne losowe ziarno w zakresie 0–65535.

Ogranicz maksymalny rozmiar generowanego modelu za pomocą ControlNet.

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

Uruchom to żądanie

Klucz pozostaje w tej przeglądarce: jest wysyłany tylko do Doitong API i zapisywany (localStorage) tylko po zaznaczeniu opcji Zapamiętaj. Uzyskaj klucz API

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

Tworzy model 3D z jednego do pięciu obrazów w `image_urls`, z opcjonalnym `prompt`. `tier` jest ograniczone do Minimum, Extreme-Low (domyślnie) i Low, a opcje siatki kończą się na 20K ścian. Materiał domyślnie to Shaded. Formaty wyjściowe to glb, usdz, fbx, obj lub stl.

Parametry

Wyślij nazwę kanoniczną albo natywną, nie obie. Nazwy kanoniczne

NazwaTyp DomyślneDozwolone Opis
image_urlsopcjonalne images
Typurl[] · image
≤ 5 elementów
Adresy URL obrazów źródłowych, maksymalnie 5 obrazów; wymagane w trybie Image-to-3D do wygenerowania modelu.
tieropcjonalne
Typenum
DomyślneGen-2.5-Extreme-Low
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-Low
Poziom generowania; Gen-2.5-Minimum wymusza tryb minimum i siatkę 50K Triangle niezależnie od `quality_mesh_option`. Szczegóły poziomów są dostępne w [dokumentacji Hyper3D](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
promptopcjonalne
Typstring
Domyślne
≤ 1024 znaki
Kieruj generowaniem za pomocą tekstu albo pozwól modelowi automatycznie wyprowadzić prompt z obrazów, pozostawiając to pole puste w trybie Image-to-3D.
use_original_alphaopcjonalne
Typboolean
Domyślnefalse
Steruje zachowaniem kanałów przezroczystości obrazu wejściowego podczas generowania treści 3D.
seedopcjonalne
Typinteger | null
0 – 65 535
Opcjonalne losowe ziarno w zakresie 0–65535.
geometry_file_formatopcjonalne
Typenum
Domyślneglb
glbusdzfbxobjstl
Format pliku geometrii, wybierany spośród glb, usdz, fbx, obj, stl; domyślnie glb.
materialopcjonalne
Typenum
DomyślneShaded
PBRShadedAllNone
Wybór wynikowego materiału: wybierz None dla geometrii bez tekstur albo All, aby otrzymać oba warianty materiału. Dla realistycznego oświetlenia i materiałów opartych na fizyce wybierz PBR; dla wypieczonego oświetlenia bez map PBR wybierz Shaded.
quality_mesh_optionopcjonalne
Typenum
DomyślneAuto
Auto1K Quad4K Quad8K Quad18K Quad20K Quad2K Triangle4K Triangle8K Triangle10K Triangle20K Triangle
Wybierz jakość wraz z topologią siatki: Quad sprzyja gładkim powierzchniom, a Triangle szczegółowości geometrii. Szybki endpoint jest przeznaczony głównie do testowania i prototypowania, z limitem 20K; dla siatek wyższej jakości użyj standardowego endpointu, w którym Minimum, Extreme-Low i Low obsługują do 1M Triangle, a dostępne liczby ścian zależą od poziomu. W Hyper3D API `quality_override` określa liczbę ścian, a `mesh_mode` określa Quad/Raw. Auto wybiera zalecane ustawienia: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.
texture_modeopcjonalne
Typenum
legacyextreme-lowlowmediumhigh
Wybierz jakość tekstury jawnie albo pozostaw wybór API, które używa wartości domyślnej odpowiedniej dla danego poziomu.
enable_creative_modeopcjonalne
Typboolean
Domyślnefalse
Tryb kreatywnego generowania, równoważny `geometry_instruct_mode` ustawionemu na `creative` w Hyper3D API. Włączenie zwiększa niezawodność generowania bez pogorszenia spójności wyniku.
hd_textureopcjonalne
Typboolean
Domyślnefalse
Steruje zaawansowanym przetwarzaniem tekstur po generowaniu w celu poprawy wierności wizualnej.
texture_delightopcjonalne
Typboolean
Domyślnefalse
Usuwa z wygenerowanych tekstur wbudowane oświetlenie i refleksy.
is_microopcjonalne
Typboolean
Domyślnefalse
Dodaje drobniejsze szczegóły geometryczne w skali mikro; działa tylko, gdy `tier="Gen-2.5-Extreme-High"`.
TAPoseopcjonalne
Typboolean
Domyślnefalse
Ustawienie pozy modelu postaci ułatwiające rigging i animację w oprogramowaniu 3D: włączenie generuje postacie w pozie T lub A.
bbox_conditionopcjonalne
Typobject
Ogranicz maksymalny rozmiar generowanego modelu za pomocą ControlNet.
bbox_condition.widthopcjonalne
Typinteger
Domyślne0
1 – 2048
Ograniczenie szerokości bounding box wzdłuż osi x.
bbox_condition.heightopcjonalne
Typinteger
Domyślne0
1 – 2048
Ograniczenie wysokości bounding box wzdłuż osi y.
bbox_condition.lengthopcjonalne
Typinteger
Domyślne0
1 – 2048
Ograniczenie długości bounding box wzdłuż osi z.
preview_renderopcjonalne
Typboolean
Domyślnefalse
Przełącznik renderowania podglądu, dodający do dostarczonych plików modelu obraz przedstawiający wygenerowany model 3D.
enable_safety_checkeropcjonalne
Typboolean
Domyślnetrue
Filtrowanie można złagodzić, ustawiając false, jeśli wywołujący ma odpowiednie uprawnienia.
wymagane Nazwa kanoniczna, również akceptowana

Parametry plików przyjmują publiczny URL https://, identyfikator URI data: do 10 MB albo file_url przesłanego pliku. Pliki

Wynik

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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Twoje pliki, Twój wybórKażdy outputs[].url to kopia w naszej przestrzeni dyskowej: przechowywana bezterminowo (opłata za GB-miesiąc) lub 7 dni bezpłatnie, zgodnie z ustawieniem konta lub ?storage=.
Taki sam format w każdym modelutype, url, content_type, width, height i duration — tak samo dla obrazów, filmów i dźwięku. output to własny obiekt wyniku modelu.
Pola wyniku
model_mesh
object {url, content_type, file_name, file_size}Plik zawierający wygenerowany obiekt 3D.
model_meshes
array of object {url, content_type, file_name, file_size}Dodatkowe pliki obiektu 3D wygenerowane przez Hyper3D i zwracane oprócz model_mesh.
seed
integerZiarno używane podczas generowania.
textures
array of object {url, content_type, file_name, file_size, width, height}Tekstury utworzone dla obiektu 3D.

Więcej modeli: Obraz na 3D

Dla agentów AI: ta strona w formacie Markdown jest dostępna pod adresem https://doitong.com/pl/developers/models/hyper3d/rodin/v2.5/fast.md. Wszystkie modele i przewodniki: https://doitong.com/developers/llms.txt