Przejdź do treści

Tripo H3.1 Text to 3D

Integracja

Identyfikator modelu tripo3d/h3.1/text-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/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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,20 $ 200 kredytów API · ≈ 21,52 ₽ Twoje pliki są mierzone przed uruchomieniem Uruchom na tej stronie

Uzyskaj klucz API
Tripo Tekst na 3D #3d#text-to-3d#3d-generation#tripo

Generator siatki 3D z tekstu z negatywnym promptem, osobnymi poziomami jakości geometrii i tekstury oraz bardzo wysokim limitem ś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 88 / 1024

Tekstowy opis żądanego obiektu 3D, ograniczony do 1024 znaków.

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 negative_prompt · face_limit · model_seed · image_seed · texture_seed · auto_size · enable_safety_checker
0 / 1024

Opis cech, które należy wykluczyć z wygenerowanego modelu.

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 podczas etapu text-to-image.

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

POST /run/tripo3d/h3.1/text-to-3d?wait=20 wycena → 0,20 $
# 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/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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 Text to 3D

Tworzy model 3D z opisu tekstowego o długości do 1024 znaków, z opcjonalnym `negative_prompt` określającym niepożądane cechy. `face_limit` przyjmuje od 1,000 do 2,000,000 ścian. `geometry_quality` i `texture_quality` mogą mieć wartość standard lub detailed. Opcje obejmują materiały PBR, topologię quad, automatyczne skalowanie do rzeczywistego rozmiaru oraz osobne ziarna dla geometrii, etapu text-to-image i tekstury.

Parametry

NazwaTyp DomyślneDozwolone Opis
promptwymagane
Typstring
≤ 1024 znaki
Tekstowy opis żądanego obiektu 3D, ograniczony do 1024 znaków.
negative_promptopcjonalne
Typstring | null
≤ 1024 znaki
Opis cech, które należy wykluczyć z wygenerowanego modelu.
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.
image_seedopcjonalne
Typinteger | null
Ziarno używane podczas etapu text-to-image.
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.
auto_sizeopcjonalne
Typboolean
Domyślnefalse
Automatyczne skalowanie nadające modelowi rzeczywiste wymiary mierzone w metrach.
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

Wynik

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/h3.1/text-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": 200,
    "usd": "0.20",
    "charged": 200,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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: Tekst 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/text-to-3d.md. Wszystkie modele i przewodniki: https://doitong.com/developers/llms.txt