Přejít na obsah

Tripo P2 Image to 3D

Integrace

ID modelu tripo3d/p2/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.com/v1/run/tripo3d/p2/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Soubory jako v příkladu: 1,10 $ 1 100 kreditů API 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#low-poly

Převod obrázku na 3D s PBR, topologií quad, čtyřmi úrovněmi kvality textury a volbou verze textury

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 textur.

Pokročilé texture_version · export_orientation · face_limit · model_seed · texture_seed · delight · auto_size · export_uv · quad · enable_safety_checker
texture_version

Verze použitá pro modelování textur. Pro fast quality vyberte v3.5-20260815; jiné verze nejsou pro tuto kvalitu podporovány.

export_orientation

Nastavení přední osy pro export modelu, pokud je zadáno.

Horní limit počtu stěn meshe, se samostatným limitem 25,000 pro quad topologii.

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

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

POST /run/tripo3d/p2/image-to-3d?wait=20 cena → 1,10 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/tripo3d/p2/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.com/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 P2 Image to 3D

Převede jeden obrázek z `image_url` na 3D model až s 50,000 plochami (25,000 pro sítě quad). Kvalita textury může být fast, standard, detailed nebo extreme a `texture_version` vybírá model textury. Další volby zahrnují mapy PBR, odstranění osvětlení, export UV, automatickou velikost a výstupní osu orientace (`export_orientation`). Samostatné seedy řídí geometrii a textury.

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
48 – 50 000
Horní limit počtu stěn meshe, se samostatným limitem 25,000 pro quad topologii.
texturevolitelné
Typboolean
Výchozítrue
Určuje, zda model obdrží vygenerované textury.
pbrvolitelné
Typboolean
Výchozítrue
Řídí generování map materiálů PBR. Zapnutí PBR aktivuje také textury.
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
faststandarddetailedextreme
Nastavení kvality textur.
texture_versionvolitelné
Typenum
v3.5-20260815v3.0-20250812v2.5-20250123
Verze použitá pro modelování textur. Pro fast quality vyberte v3.5-20260815; jiné verze nejsou pro tuto kvalitu podporovány.
delightvolitelné
Typboolean
Výchozítrue
Odstranění předem zapečeného osvětlení před texturováním pomocí v3.5-20260815.
auto_sizevolitelné
Typboolean
Výchozífalse
Automatické měřítko, které modelu přiřadí skutečné rozměry měřené v metrech.
export_uvvolitelné
Typboolean
Výchozítrue
Řídí, zda model obdrží vygenerované UV souřadnice.
export_orientationvolitelné
Typenum
+x-x-y+y
Nastavení přední osy pro export modelu, pokud je zadáno.
quadvolitelné
Typboolean
Výchozífalse
Topologie meshe používající quady místo trojúhelníků.
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/p2/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": 1100,
    "usd": "1.10",
    "charged": 1100,
    "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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/p2/image-to-3d.md. Všechny modely a návody: https://doitong.com/developers/llms.txt