Přejít na obsah

Tripo H3.1 Image to 3D

Integrace

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

Soubory jako v příkladu: 0,30 $ 300 kreditů API · ≈ 32,27 ₽ vaše soubory se před spuštěním změří Spustit na této stránce

Získat API klíč
Tripo Obrázek na 3D #3d#image-to-3d#3d-generation#tripo

Generování 3D z jednoho obrázku s materiály PBR, quad sítěmi a nastavením počtu ploch

Tripo · 3D

Zde se zobrazí váš první výsledek

Níže sestavte požadavek a spusťte ho pomocí svého API klíče. Výstupy se kopírují do našeho úložiště a uchovávají se navždy nebo 7 dne zdarma.

Sestavit požadavek

Ovládací prvky se generují ze schématu modelu. Kód a cena se aktualizují podle provedených změn.

•povinné image_url
Přetáhněte soubor nebo

URL vstupního obrázku použitého k vytvoření 3D modelu.

texture_quality výchozí standard

Nastavení kvality textury; volba 'detailed' zvýší rozlišení textury.

geometry_quality výchozí standard

Nastavení kvality geometrie.

Pokročilé texture_alignment · orientation · face_limit · model_seed · texture_seed · auto_size · enable_safety_checker
texture_alignment výchozí original_image

Reference zarovnání textur: použijte 'geometry' pro vygenerovanou geometrii nebo 'original_image' pro vstupní obrázek.

orientation výchozí default

Orientace modelu; 'align_image' jej automaticky otočí podle vstupního obrázku.

Explicitní cílový počet ploch pro generování sítě, který při zadání přepisuje adaptivní výběr počtu modelem.

Seed používaný k reprodukovatelnému generování geometrie.

Seed používaný k reprodukovatelnému generování textur.

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"

Spustit tento požadavek

Váš klíč zůstává v tomto prohlížeči: odesílá se pouze do Doitong API a uloží se do localStorage jen tehdy, když zaškrtnete možnost Zapamatovat. Získat klíč API

O modelu Tripo H3.1 Image to 3D

Vytváří 3D model z jednoho obrázku v `image_url`. Možnosti zahrnují `face_limit` (1,000 až 2,000,000), `texture`, `pbr`, standardní nebo detailní `texture_quality` a `geometry_quality`, topologii `quad`, `auto_size` a `orientation`. Výsledek obsahuje náhledový renderování a ID úlohy pro pozdější rigging.

Parametry

Odešlete buď kanonický název, nebo nativní název, ne oba. Kanonické názvy

NázevTyp VýchozíPovolené Popis
image_urlpovinné image
Typurl · image
URL vstupního obrázku použitého k vytvoření 3D modelu.
face_limitvolitelné
Typinteger | null
1 000 – 2 000 000
Explicitní cílový počet ploch pro generování sítě, který při zadání přepisuje adaptivní výběr počtu modelem.
texturevolitelné
Typboolean
Výchozítrue
Určuje, zda model obdrží vygenerované textury.
pbrvolitelné
Typboolean
Výchozítrue
Povoluje materiály PBR (Physically Based Rendering) a při hodnotě true také zapíná generování textur.
model_seedvolitelné
Typinteger | null
Seed používaný k reprodukovatelnému generování geometrie.
texture_seedvolitelné
Typinteger | null
Seed používaný k reprodukovatelnému generování textur.
texture_qualityvolitelné
Typenum
Výchozístandard
standarddetailed
Nastavení kvality textury; volba 'detailed' zvýší rozlišení textury.
geometry_qualityvolitelné
Typenum
Výchozístandard
standarddetailed
Nastavení kvality geometrie.
texture_alignmentvolitelné
Typenum
Výchozíoriginal_image
original_imagegeometry
Reference zarovnání textur: použijte 'geometry' pro vygenerovanou geometrii nebo 'original_image' pro vstupní obrázek.
auto_sizevolitelné
Typboolean
Výchozífalse
Automatické měřítko, které modelu přiřadí skutečné rozměry měřené v metrech.
orientationvolitelné
Typenum
Výchozídefault
defaultalign_image
Orientace modelu; 'align_image' jej automaticky otočí podle vstupního obrázku.
quadvolitelné
Typboolean
Výchozífalse
Volba mezi trojúhelníkovými stěnami a čtyřstrannými quady povolením quad topologie. U výsledků s quady se vrací soubor FBX, kdykoli Tripo dodá data jako bajty FBX.
enable_safety_checkervolitelné
Typboolean
Výchozítrue
Kontrolu lze uvolnit nastavením na false, pokud je volající autorizován.
povinné Kanonický název, také podporován

Parametry souborů přijímají veřejnou adresu https:// URL, data: URI do 10 MB nebo file_url nahraného souboru. Soubory

Výstup

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 soubory, vaše volbaKaždý outputs[].url je kopie v našem úložišti: uchovávaná navždy (zpoplatněná za GB-měsíc) nebo 7 dne zdarma podle nastavení účtu nebo ?storage=.
Stejná struktura u každého modelutype, url, content_type, width, height a duration pro obrázky, video i zvuk. output je vlastní objekt výsledku modelu.
Pole výstupu
model_mesh
object {url, content_type, file_name, file_size}Soubor GLB nebo FBX obsahující vygenerovaný 3D model; formát určuje to, co vytvoří Tripo.
model_urls
object {glb, fbx, base_model, pbr_model}URL odkazující na alternativní verze 3D modelu.
rendered_image
object {url, content_type, file_name, file_size} | nullVykreslený náhled vygenerovaného 3D modelu.
task_id
string | nullZnovu použitelné ID úlohy Tripo identifikující vygenerovaný model pro rig nebo rig-check, což umožňuje tyto operace bez dalšího nahrávání modelu.

Další modely: Obrázek na 3D

Pro AI agenty: tato stránka je ve formátu Markdown na adrese https://doitong.com/cs/developers/models/tripo3d/h3.1/image-to-3d.md. Všechny modely a návody: https://doitong.com/developers/llms.txt