Przejdź do treści

Hi3D Image to 3D

Integracja

Identyfikator modelu hitem3d/hi3d/image-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/hitem3d/hi3d/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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"

To żądanie: ≈0,50 $ 500 kredytów API · ≈ 53,79 ₽ Uruchom na tej stronie

Uzyskaj klucz API
Hitem3D Obraz na 3D #image-to-3d#3d#mesh

Konwersja pojedynczego obrazu do siatki 3D z wyborem wersji Hitem3D, wariantami portretowymi i wieloma formatami eksportu

Hitem3D · 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.

•wymagane image_url
Upuść plik lub

Podaj obraz wejściowy jako URL pliku PNG, JPEG lub WebP o rozmiarze nie większym niż 20 MB.

resolution

Rozdzielczość generowania, domyślnie zgodna z rekomendacją modelu: 1024 dla v1.5/v2.0 i warstwy fast w pozostałych przypadkach. Dostępne opcje to 512, 1024, 1536 i 1536pro dla v1.5/v2.0; 1536fast i 1536pro dla v2.1; 1536 dla scene-portraitv1.5; 1536pro dla scene-portraitv2.0; oraz 1536profast i 1536pro dla scene-portraitv2.1.

Zaawansowane model · export_format · face_count · enable_texture · enable_pbr · enable_safety_checker
model domyślnie hitem3dv2.1

Selektor modelu generowania: wybierz rodzinę 'scene-portrait*' dostosowaną do portretów i postaci albo ogólnego przeznaczenia rodzinę 'hitem3d*'.

export_format domyślnie glb

Format używany do zapisu wygenerowanego modelu.

Żądana liczba ścian modelu, zastępująca rekomendację partnera opartą na rozdzielczości. Po pominięciu partner wybiera rekomendowaną wartość, na przykład 500k przy 512, 1M przy 1024 lub 2M przy 1536.

POST /run/hitem3d/hi3d/image-to-3d?wait=20 wycena → 0,50 $
# 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/hitem3d/hi3d/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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"

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 Hi3D Image to 3D

Tworzy model 3D z jednego obrazu (PNG, JPEG lub WebP, do 20MB). Opcja `model` obejmuje wersje ogólne i dostrojone do portretów, a dozwolone wartości `resolution` zależą od wybranej wersji. Mapy tekstur i PBR można włączać, `face_count` mieści się w zakresie od 100,000 do 2,000,000, a eksport jest dostępny w formatach glb, obj, stl, fbx lub usdz.

Parametry

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

NazwaTyp DomyślneDozwolone Opis
modelopcjonalne
Typenum
Domyślnehitem3dv2.1
hitem3dv1.5hitem3dv2.0hitem3dv2.1scene-portraitv1.5scene-portraitv2.0scene-portraitv2.1
Selektor modelu generowania: wybierz rodzinę 'scene-portrait*' dostosowaną do portretów i postaci albo ogólnego przeznaczenia rodzinę 'hitem3d*'.
resolutionopcjonalne
Typenum
512102415361536pro1536fast1536profast
Rozdzielczość generowania, domyślnie zgodna z rekomendacją modelu: 1024 dla v1.5/v2.0 i warstwy fast w pozostałych przypadkach. Dostępne opcje to 512, 1024, 1536 i 1536pro dla v1.5/v2.0; 1536fast i 1536pro dla v2.1; 1536 dla scene-portraitv1.5; 1536pro dla scene-portraitv2.0; oraz 1536profast i 1536pro dla scene-portraitv2.1.
enable_textureopcjonalne
Typboolean
Domyślnetrue
Określa, czy tekstury są generowane wraz z geometrią.
enable_pbropcjonalne
Typboolean
Domyślnetrue
Określa, czy mapy materiałów PBR są tworzone wraz z teksturą.
face_countopcjonalne
Typinteger | null
100 000 – 2 000 000
Żądana liczba ścian modelu, zastępująca rekomendację partnera opartą na rozdzielczości. Po pominięciu partner wybiera rekomendowaną wartość, na przykład 500k przy 512, 1M przy 1024 lub 2M przy 1536.
export_formatopcjonalne
Typenum
Domyślneglb
glbobjstlfbxusdz
Format używany do zapisu wygenerowanego modelu.
enable_safety_checkeropcjonalne
Typboolean
Domyślnetrue
Przełącznik kontroli bezpieczeństwa obrazów wejściowych: true wymaga kontroli bezpieczeństwa przed rozpoczęciem przetwarzania obrazu.
image_urlwymagane image
Typurl · image
Podaj obraz wejściowy jako URL pliku PNG, JPEG lub WebP o rozmiarze nie większym niż 20 MB.
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": "hitem3d/hi3d/image-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": 500,
    "usd": "0.50",
    "charged": 500,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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
    },
    "thumbnail": {
      "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
    }
  },
  "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"
  }
}
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 model 3D.
thumbnail
object {url, content_type, file_name, file_size} | nullObraz podglądu modelu, dostarczany, gdy jest dostępny.

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/hitem3d/hi3d/image-to-3d.md. Wszystkie modele i przewodniki: https://doitong.com/developers/llms.txt