Pereiti prie turinio

Tripo H3.1 Image to 3D

Integruoti

Modelio id 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"

Failai kaip pavyzdyje: 0,30 $ 300 API kreditų · ≈ 32,27 ₽ jūsų failai išmatuojami prieš paleidimą Paleisti šiame puslapyje

Gauti API raktą
Tripo Vaizdas į 3D #3d#image-to-3d#3d-generation#tripo

Vieno vaizdo 3D generavimas su PBR medžiagomis, keturkampiais tinkleliais ir paviršių skaičiaus valdymu

Tripo · 3D

Čia bus pirmasis jūsų rezultatas

Sukurkite užklausą toliau ir paleiskite ją naudodami savo API raktą. Išvestys nukopijuojamos į mūsų saugyklą ir saugomos neribotą laiką arba 7 dienos nemokamai.

Sukurti užklausą

Valdikliai sugeneruojami pagal modelio schemą. Keisdami juos atnaujinsite kodą ir kainą.

•privaloma image_url
Įmeskite failą arba

Įvesties vaizdo URL, naudojamas 3D modeliui sukurti.

texture_quality numatytoji standard

Tekstūros kokybės nustatymas; pasirinkus 'detailed', padidinama tekstūros raiška.

geometry_quality numatytoji standard

Geometrijos kokybės nustatymas.

Išplėstiniai texture_alignment · orientation · face_limit · model_seed · texture_seed · auto_size · enable_safety_checker
texture_alignment numatytoji original_image

Tekstūros lygiavimo nuoroda: generuojamai geometrijai naudokite 'geometry', o įvesties vaizdui – 'original_image'.

orientation numatytoji default

Modelio orientacija; 'align_image' automatiškai pasuka modelį, kad jis sutaptų su įvesties vaizdu.

Aiškiai nurodytas tinklelio generavimo paviršių skaičiaus tikslas, kuris, pateiktas, pakeičia adaptyvų modelio skaičiaus pasirinkimą.

Sėkla, naudojama geometrijos generavimo atkuriamumui užtikrinti.

Sėkla, naudojama tekstūrų generavimo atkuriamumui užtikrinti.

POST /run/tripo3d/h3.1/image-to-3d?wait=20 kaina → 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"

Vykdyti šią užklausą

Jūsų raktas lieka šioje naršyklėje: jis siunčiamas tik į Doitong API ir išsaugomas (localStorage) tik pažymėjus Prisiminti. Gauti API raktą

Apie Tripo H3.1 Image to 3D

Sukuria 3D modelį iš vieno vaizdo, esančio `image_url`. Parinktys apima `face_limit` (1,000-2,000,000), `texture`, `pbr`, standartinę arba detalią `texture_quality` ir `geometry_quality`, `quad` topologiją, `auto_size` ir `orientation`. Rezultate pateikiamas peržiūros atvaizdas ir užduoties ID vėlesniam rigavimui.

Parametrai

Siųskite arba kanoninį, arba savąjį pavadinimą, bet ne abu. Kanoniniai pavadinimai

PavadinimasTipas Numatytoji reikšmėLeidžiama Aprašas
image_urlprivaloma image
Tipasurl · image
Įvesties vaizdo URL, naudojamas 3D modeliui sukurti.
face_limitneprivalomas
Tipasinteger | null
1 000 – 2 000 000
Aiškiai nurodytas tinklelio generavimo paviršių skaičiaus tikslas, kuris, pateiktas, pakeičia adaptyvų modelio skaičiaus pasirinkimą.
textureneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Nurodo, ar modelis gauna sugeneruotas tekstūras.
pbrneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Įjungia PBR medžiagas (Physically Based Rendering), o įjungus taip pat aktyvinamas tekstūrų generavimas.
model_seedneprivalomas
Tipasinteger | null
Sėkla, naudojama geometrijos generavimo atkuriamumui užtikrinti.
texture_seedneprivalomas
Tipasinteger | null
Sėkla, naudojama tekstūrų generavimo atkuriamumui užtikrinti.
texture_qualityneprivalomas
Tipasenum
Numatytoji reikšmėstandard
standarddetailed
Tekstūros kokybės nustatymas; pasirinkus 'detailed', padidinama tekstūros raiška.
geometry_qualityneprivalomas
Tipasenum
Numatytoji reikšmėstandard
standarddetailed
Geometrijos kokybės nustatymas.
texture_alignmentneprivalomas
Tipasenum
Numatytoji reikšmėoriginal_image
original_imagegeometry
Tekstūros lygiavimo nuoroda: generuojamai geometrijai naudokite 'geometry', o įvesties vaizdui – 'original_image'.
auto_sizeneprivalomas
Tipasboolean
Numatytoji reikšmėfalse
Automatinis mastelio keitimas, kad modeliui būtų suteikti metrais išmatuoti realaus pasaulio matmenys.
orientationneprivalomas
Tipasenum
Numatytoji reikšmėdefault
defaultalign_image
Modelio orientacija; 'align_image' automatiškai pasuka modelį, kad jis sutaptų su įvesties vaizdu.
quadneprivalomas
Tipasboolean
Numatytoji reikšmėfalse
Pasirinkite trikampius paviršius arba keturkampius, įjungdami quad topologiją. Keturkampių rezultatų atveju grąžinamas FBX failas, kai Tripo pateikia duomenis kaip FBX baitus.
enable_safety_checkerneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Patikrą galima sušvelninti nustačius false, jei skambinantysis turi teisę tai daryti.
privaloma Kanoninis pavadinimas, taip pat priimamas

Failų parametrams reikia viešo https:// URL, ne didesnio nei 10 MB data: URI arba įkelto failo file_url. Failai

Išvestis

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"
  }
}
Jūsų failai — jūsų pasirinkimasKiekvienas outputs[].url yra kopija mūsų saugykloje: saugoma neribotą laiką (mokama už GB per mėnesį) arba 7 dienos nemokamai, pagal paskyros nustatymą arba ?storage=.
Ta pati struktūra kiekviename modelyjetype, url, content_type, width, height ir duration taikomi vaizdams, vaizdo įrašams ir garsui. output yra paties modelio rezultatų objektas.
Išvesties laukai
model_mesh
object {url, content_type, file_name, file_size}GLB arba FBX failas su sugeneruotu 3D modeliu; formatą nustato tai, ką sugeneruoja Tripo.
model_urls
object {glb, fbx, base_model, pbr_model}URL, nurodantys alternatyvias 3D modelio versijas.
rendered_image
object {url, content_type, file_name, file_size} | nullSugeneruoto 3D modelio atvaizduota peržiūra.
task_id
string | nullPakartotinai naudojamas Tripo užduoties ID, identifikuojantis sugeneruotą modelį rig arba rig-check operacijoms ir leidžiantis jas atlikti dar kartą neįkeliant modelio.

Daugiau modelių: Vaizdas į 3D

AI agentams: šis puslapis Markdown formatu pateikiamas adresu https://doitong.com/lt/developers/models/tripo3d/h3.1/image-to-3d.md. Visi modeliai ir vadovai: https://doitong.com/developers/llms.txt