Przejdź do treści

Tripo H3.1 Image to 3D

Integracja

Identyfikator modelu tripo3d/h3.1/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/tripo3d/h3.1/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"

Pliki takie jak przykład: 0,30 $ 300 kredytów API · ≈ 32,27 ₽ Twoje pliki są mierzone przed uruchomieniem Uruchom na tej stronie

Uzyskaj klucz API
Tripo Obraz na 3D #3d#image-to-3d#3d-generation#tripo

Generowanie 3D z pojedynczego obrazu z materiałami PBR, siatkami quad i kontrolą liczby ścian

Tripo · 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

URL obrazu wejściowego używanego do utworzenia modelu 3D.

texture_quality domyślnie standard

Ustawienie jakości tekstur; wybór wartości 'detailed' zwiększa rozdzielczość tekstur.

geometry_quality domyślnie standard

Ustawienie jakości geometrii.

Zaawansowane texture_alignment · orientation · face_limit · model_seed · texture_seed · auto_size · enable_safety_checker
texture_alignment domyślnie original_image

Element odniesienia do wyrównania tekstury: użyj 'geometry' dla wygenerowanej geometrii lub 'original_image' dla obrazu wejściowego.

orientation domyślnie default

Orientacja modelu; 'align_image' automatycznie obraca go, aby dopasować go do obrazu wejściowego.

Jawny cel liczby ścian podczas generowania siatki, zastępujący adaptacyjny wybór liczby przez model, jeśli zostanie podany.

Ziarno używane do zapewnienia powtarzalności generowania geometrii.

Ziarno używane do zapewnienia powtarzalności generowania tekstur.

POST /run/tripo3d/h3.1/image-to-3d?wait=20 wycena → 0,30 $
# 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/tripo3d/h3.1/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 Tripo H3.1 Image to 3D

Buduje model 3D z jednego obrazu pod adresem `image_url`. Opcje obejmują `face_limit` (od 1,000 do 2,000,000), `texture`, `pbr`, standardową lub szczegółową `texture_quality` i `geometry_quality`, topologię `quad`, `auto_size` oraz `orientation`. Wynik zawiera podgląd renderowania i identyfikator zadania do późniejszego rigowania.

Parametry

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

NazwaTyp DomyślneDozwolone Opis
image_urlwymagane image
Typurl · image
URL obrazu wejściowego używanego do utworzenia modelu 3D.
face_limitopcjonalne
Typinteger | null
1000 – 2 000 000
Jawny cel liczby ścian podczas generowania siatki, zastępujący adaptacyjny wybór liczby przez model, jeśli zostanie podany.
textureopcjonalne
Typboolean
Domyślnetrue
Określa, czy model otrzymuje wygenerowane tekstury.
pbropcjonalne
Typboolean
Domyślnetrue
Włącza materiały PBR (Physically Based Rendering), co przy wartości true włącza również generowanie tekstur.
model_seedopcjonalne
Typinteger | null
Ziarno używane do zapewnienia powtarzalności generowania geometrii.
texture_seedopcjonalne
Typinteger | null
Ziarno używane do zapewnienia powtarzalności generowania tekstur.
texture_qualityopcjonalne
Typenum
Domyślnestandard
standarddetailed
Ustawienie jakości tekstur; wybór wartości 'detailed' zwiększa rozdzielczość tekstur.
geometry_qualityopcjonalne
Typenum
Domyślnestandard
standarddetailed
Ustawienie jakości geometrii.
texture_alignmentopcjonalne
Typenum
Domyślneoriginal_image
original_imagegeometry
Element odniesienia do wyrównania tekstury: użyj 'geometry' dla wygenerowanej geometrii lub 'original_image' dla obrazu wejściowego.
auto_sizeopcjonalne
Typboolean
Domyślnefalse
Automatyczne skalowanie nadające modelowi rzeczywiste wymiary mierzone w metrach.
orientationopcjonalne
Typenum
Domyślnedefault
defaultalign_image
Orientacja modelu; 'align_image' automatycznie obraca go, aby dopasować go do obrazu wejściowego.
quadopcjonalne
Typboolean
Domyślnefalse
Wybór między ścianami trójkątnymi a czworokątami z 4 bokami przez włączenie topologii quad. W przypadku wyników quad zwracany jest plik FBX, gdy Tripo dostarczy dane jako bajty FBX.
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": "tripo3d/h3.1/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": 300,
    "usd": "0.30",
    "charged": 300,
    "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
    },
    "model_urls": {
      "glb": {
        "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
      },
      "fbx": {
        "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
      },
      "base_model": {
        "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
      },
      "pbr_model": {
        "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
      }
    },
    "rendered_image": {
      "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
    },
    "task_id": "string"
  },
  "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 GLB lub FBX zawierający wygenerowany model 3D; format zależy od tego, co wygeneruje Tripo.
model_urls
object {glb, fbx, base_model, pbr_model}Adresy URL wskazujące alternatywne wersje modelu 3D.
rendered_image
object {url, content_type, file_name, file_size} | nullWyrenderowany podgląd przedstawiający wygenerowany model 3D.
task_id
string | nullWielokrotnego użytku identyfikator zadania Tripo identyfikujący wygenerowany model dla rig lub rig-check, umożliwiający wykonanie tych operacji bez ponownego przesyłania modelu.

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