Tripo H3.1 API

O modelu Tripo H3.1

Dokładne kształty 3D i wierne kolory z jednego zdjęcia produktu.

Wywołujesz go nazwą modelu tripo/h3.1/image-to-3d w POST /jobs/createTask, od 0,432 USD.

Wprowadzenie

Tripo H3.1 to model obraz-do-3D, który Tripo AI przedstawiło w marcu 2026 roku z myślą o zasobach produkcyjnych; ma ostrzejszą geometrię, lepsze dopasowanie do obrazu wejściowego i tekstury wyższej jakości niż wcześniejsze modele serii H. Wysyłasz jeden obraz (image_url) i otrzymujesz jeden binarny plik glTF (.glb). W przeciwieństwie do konwerterów z jednym przełącznikiem każdy etap potoku jest dostępny: czy teksturować siatkę, czy dodać mapy PBR, tekstury HD, szczegółową geometrię, topologię czworokątów, docelową liczbę ścian, skalowanie do rzeczywistych wymiarów, końcową orientację oraz dwa niezależne seed. Nie ma promptu.

Najważniejsze cechy

Kształt zgodny z obrazem

W naszym teście z butem model zachował proporcje zdjęcia i umieścił pętlę na pięcie, haczyki sznurowadeł oraz bieżnik po właściwych stronach, mimo że zdjęcie pokazywało tylko przód. Wynik z teksturami przeniósł zużytą skórę, czerwone sznurowadła i szwy na siatkę.

Tekstury, które można włączać i ulepszać

Tekstury są domyślnie włączone i przychodzą jako pełny zestaw PBR. Nasz plik z ustawieniami domyślnymi zawierał w jednym materiale mapę koloru bazowego 2048 pikseli, mapę metal-roughness i mapę normalnych.

Topologia i rozmiar pod kontrolą

face_limit ogranicza liczbę ścian od 1 000 do 2 000 000, quad_mesh przełącza na czworokątne wielokąty do edycji w narzędziu do modelowania, a geometry_quality: detailed przeznacza więcej obliczeń na drobne detale powierzchni. auto_size skaluje siatkę do rzeczywistych wymiarów, a model_orientation: align_image obraca ją zgodnie ze zdjęciem.

Co zmierzyliśmy

Przy ustawieniach domyślnych widok z przodu skórzanego buta (1024×1024) wrócił po 167 sekundach jako plik GLB o rozmiarze 45,8 MB, z 1 471 382 trójkątami i trzema teksturami. Ta gęstość jest powodem, dla którego dla wszystkiego, co pokazywane jest w przeglądarce, warto ustawić face_limit.

Parametry żądania

Ceny

Ceny podano w USD. API korzysta z oddzielnego salda w dolarach amerykańskich. Kredytów strony nie można używać w API ani zamieniać na saldo API. Nie można też zamieniać salda API na kredyty strony. Po przyjęciu zadania rezerwujemy maksymalną kwotę wyceny na saldzie API. Po zakończeniu naliczamy opłatę za rzeczywiste użycie, nie wyższą niż rezerwacja, i zwalniamy resztę. Jeśli zadanie się nie powiedzie, rezerwacja zostaje zwolniona.

Przed uruchomieniem wyślij tę samą treść żądania do POST /jobs/quote, aby zobaczyć szacowaną i maksymalną opłatę w USD. Wycena nie uruchamia zadania ani nie obciąża salda.

Zastosowania

Zasoby do gier, AR i scen w czasie rzeczywistym

Ustaw face_limit zgodnie z budżetem sceny, włącz quad_mesh, jeśli zasób będzie edytowany, i zostaw PBR włączone, aby model reagował na oświetlenie sceny.

Wizualizacja produktów i druk

W przeglądarce produktów zostaw tekstury włączone i użyj texture_quality: detailed, gdy etykiety lub szwy muszą pozostać czytelne. Do druku 3D lub rzeźby wyłącz oba przełączniki tekstur i ustaw auto_size, aby siatka miała realistyczną skalę.

Poradnik promptów i porady dla zaawansowanych

Zacznij od czystego zdjęcia

Jeden podmiot, w całości w kadrze, na jednolitym tle. Ujęcie pod kątem trzech czwartych przekazuje modelowi więcej informacji o głębi niż prosty widok z przodu. JPEG, PNG lub WebP do 10 MB.

Włączaj tylko to, czego potrzebujesz

Wykonaj pierwszy przebieg z ustawieniami domyślnymi i face_limit, a potem ulepsz tylko ten etap, który nie wystarcza.

Iteruj dwoma seedami

seed utrwala geometrię, a texture_seed — teksturę. Zachowaj seed i zmieniaj texture_seed, aby wypróbować nowe powierzchnie na tym samym kształcie, albo zachowaj texture_seed, gdy eksplorujesz kształty.

Sprawdź ukrytą stronę

Przed użyciem otwórz GLB w przeglądarce i obróć go w pełni. Jeśli niewidoczna strona jest błędna, inny kąt kamery na zdjęciu źródłowym pomoże bardziej niż jakiekolwiek ustawienie.

Szybki start z API

Wywołaj API Tripo H3.1 w trzech krokach

1. Utwórz klucz API. Zaloguj się do PopNow i utwórz klucz w konsoli API. Klucze zaczynają się od sk-popnow-. Wywołania korzystają z oddzielnego salda w dolarach amerykańskich.
2. Wyślij żądanie. Wyślij POST /jobs/createTask z model tripo/h3.1/image-to-3d i obiektem input zgodnym z tabelą parametrów. Odpowiedź od razu zwraca ID zadania.
3. Odbierz wynik. Odpytuj GET /jobs/recordInfo po ID zadania albo podaj callBackUrl, a wyślemy tam wynik. Gdy zadanie się powiedzie, pobierz pliki z linków wyjściowych.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "tripo/h3.1/image-to-3d",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "generate_texture": true,
    "generate_pbr": true,
    "texture_quality": "standard",
    "geometry_quality": "standard",
    "model_orientation": "default"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Podmień prompt i linki na własne. Odniesienie do odpowiedzi, odpytywania i callbacku znajdziesz na karcie API.

Pytania o API Tripo H3.1

Inne API: obrazy

• API Seed3D 2.0Bogato teksturowane modele 3D z jednego obrazu, świetne do postaciOd 0,48 USD za generację

Więcej o Tripo H3.1

Wypróbuj

Tripo H3.1: generator obrazów AI onlineTwórz obrazy z Tripo H3.1 w PopNow

Dokumentacja

ID modelu i schemat wejścia Tripo H3.1 w dokumentacji APISzybki start z API PopNow: wyślij pierwsze żądaniePrzewodnik po generowaniu obrazów przez API PopNowWebhooki: wyniki Tripo H3.1 bez odpytywania