Preskoči na vsebino

Tripo H3.1 Image to 3D

Integracija

ID modela 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"

Datoteke, kot je primer: 0,30 $ 300 API kreditov · ≈ 32,27 ₽ vaše datoteke se izmerijo pred zagonom Zaženi na tej strani

Pridobi ključ API
Tripo Slika v 3D #3d#image-to-3d#3d-generation#tripo

Ustvarjanje 3D-modela iz ene slike z materiali PBR, štirikotnimi mrežami in nadzorom števila ploskev

Tripo · 3D

Tukaj bo vaš prvi rezultat

Spodaj sestavite zahtevo in jo zaženite s svojim ključem API. Izhodi se kopirajo v našo shrambo, kjer se hranijo za vedno ali 7 dni brezplačno.

Ustvari zahtevo

Kontrolniki se ustvarijo iz sheme modela. Koda in cena se posodobita, ko ju spreminjate.

•obvezno image_url
Spustite datoteko ali

URL vhodne slike za ustvarjanje 3D-modela.

texture_quality privzeto standard

Nastavitev kakovosti teksture; izbira možnosti 'detailed' poveča ločljivost teksture.

geometry_quality privzeto standard

Nastavitev kakovosti geometrije.

Napredno texture_alignment · orientation · face_limit · model_seed · texture_seed · auto_size · enable_safety_checker
texture_alignment privzeto original_image

Referenca za poravnavo teksture: uporabite 'geometry' za generirano geometrijo ali 'original_image' za vhodno sliko.

orientation privzeto default

Usmerjenost modela; 'align_image' ga samodejno zavrti tako, da se ujema z vhodno sliko.

Izrecno ciljno število ploskev za generiranje mreže, ki ob podaji preglasi prilagodljivo izbiro števila modela.

Seme, uporabljeno za ponovljivo generiranje geometrije.

Seme, uporabljeno za ponovljivo generiranje tekstur.

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

Zaženi to zahtevo

Vaš ključ ostane v tem brskalniku: pošlje se samo v Doitong API in shrani v localStorage samo, če označite možnost Zapomni si. Pridobi ključ API

O modelu Tripo H3.1 Image to 3D

Ustvari 3D-model iz ene slike na `image_url`. Možnosti vključujejo `face_limit` (1,000 do 2,000,000), `texture`, `pbr`, standardno ali podrobno `texture_quality` in `geometry_quality`, topologijo `quad`, `auto_size` in `orientation`. Rezultat vključuje predogledni izris in ID opravila za poznejše skeletiranje.

Parametri

Pošlji kanonično ali izvorno ime, ne obeh. Kanonična imena

ImeVrsta PrivzetoDovoljeno Opis
image_urlobvezno image
Vrstaurl · image
URL vhodne slike za ustvarjanje 3D-modela.
face_limitneobvezno
Vrstainteger | null
1000 – 2.000.000
Izrecno ciljno število ploskev za generiranje mreže, ki ob podaji preglasi prilagodljivo izbiro števila modela.
textureneobvezno
Vrstaboolean
Privzetotrue
Določa, ali model prejme ustvarjene teksture.
pbrneobvezno
Vrstaboolean
Privzetotrue
Omogoči materiale PBR (Physically Based Rendering), kar ob vrednosti true vključi tudi generiranje tekstur.
model_seedneobvezno
Vrstainteger | null
Seme, uporabljeno za ponovljivo generiranje geometrije.
texture_seedneobvezno
Vrstainteger | null
Seme, uporabljeno za ponovljivo generiranje tekstur.
texture_qualityneobvezno
Vrstaenum
Privzetostandard
standarddetailed
Nastavitev kakovosti teksture; izbira možnosti 'detailed' poveča ločljivost teksture.
geometry_qualityneobvezno
Vrstaenum
Privzetostandard
standarddetailed
Nastavitev kakovosti geometrije.
texture_alignmentneobvezno
Vrstaenum
Privzetooriginal_image
original_imagegeometry
Referenca za poravnavo teksture: uporabite 'geometry' za generirano geometrijo ali 'original_image' za vhodno sliko.
auto_sizeneobvezno
Vrstaboolean
Privzetofalse
Samodejno skaliranje za določitev dejanskih mer modela v metrih.
orientationneobvezno
Vrstaenum
Privzetodefault
defaultalign_image
Usmerjenost modela; 'align_image' ga samodejno zavrti tako, da se ujema z vhodno sliko.
quadneobvezno
Vrstaboolean
Privzetofalse
Izbirajte med trikotnimi ploskvami in štirikotniki z 4 stranicami tako, da omogočite topologijo quad. Pri rezultatih quad se vrne datoteka FBX, kadar Tripo podatke zagotovi kot bajte FBX.
enable_safety_checkerneobvezno
Vrstaboolean
Privzetotrue
Preverjanje je mogoče omiliti z nastavitvijo false, če je klicatelj pooblaščen.
obvezno Kanonično ime, prav tako sprejeto

Parametri datotek sprejmejo javni https:// URL, podatkovni URI data: do 10 MB ali file_url naložene datoteke. Datoteke

Izhod

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"
  }
}
Vaše datoteke, vaša izbiraVsak outputs[].url je kopija v naši shrambi: hrani se za vedno (plačilo na GB-mesec) ali 7 dni brezplačno, glede na nastavitev računa ali ?storage=.
Enaka struktura pri vsakem modelutype, url, content_type, width, height in duration za slike, videoposnetke in zvok. output je lasten objekt rezultata modela.
Polja izhoda
model_mesh
object {url, content_type, file_name, file_size}Datoteka GLB ali FBX z generiranim 3D-modelom; format določi to, kar ustvari Tripo.
model_urls
object {glb, fbx, base_model, pbr_model}URL-ji, ki kažejo na alternativne različice 3D-modela.
rendered_image
object {url, content_type, file_name, file_size} | nullUpodobljen predogled, ki prikazuje generirani 3D-model.
task_id
string | nullPonovno uporabljiv ID opravila Tripo, ki identificira generirani model za rig ali rig-check in omogoča te operacije brez ponovnega nalaganja modela.

Več modelov: Slika v 3D

Za agente AI: ta stran je v obliki Markdown na voljo na https://doitong.com/sl/developers/models/tripo3d/h3.1/image-to-3d.md. Vsi modeli in vodniki: https://doitong.com/developers/llms.txt