Saltar al cuntegna

Tripo P2 Image to 3D

Integrar

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

Datotecas sco l'exempel: $1,10 1 100 credits API tias datotecas vegnan mesiradas avant l'execuziun Lantschar sin questa pagina

Obtegna ina clav API
Tripo Maletg a 3D #3d#image-to-3d#3d-generation#low-poly

Imag ina a 3D cun PBR, topologia quad, quatter nivels da qualitad da textur e tscherna da la versiun da textur

Tripo · 3D

Tes emprim resultat vegn qua

Construis ina dumonda sutvart e l'exequescha cun tia clav API. Outputs vegnan copiads en nossa memorisaziun, conservads per adina u 7 dis gratuitamain.

Construir ina dumonda

Ils controls vegnan generads dal schema dal model. Il code e ​​il pretsch s'actualiseschan durant che ti als midas.

•obligatori image_url
Trametta in datoteca u

URL dal maletg d'input utilisà per crear in model 3D.

texture_quality standard standard

Configuraziun da la qualitad da las texturas.

Avanzà texture_version · export_orientation · face_limit · model_seed · texture_seed · delight · auto_size · export_uv · quad · enable_safety_checker
texture_version

Versiun utilisada per il modelar da texturas. Per la qualitad rapida, tscherner v3.5-20260815; autras versiuns na vegnan betg sustegnidas per questa qualitad.

export_orientation

Configuraziun da l'axa en avant per l'export dal model, sche specificada.

Limita superiura da las surfatschas dal mesh, cun ina limita separada da 25,000 per la topologia quad.

Seed utilisà per render reproducibla la generaziun da geometria.

Seed utilisà per render reproducibla la generaziun da texturas.

POST /run/tripo3d/p2/image-to-3d?wait=20 calculaziun → $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"

Executar questa dumonda

Tia clav resta en quest browser: ella vegn tramessa mo al Doitong API e memorisada (localStorage) mo sch'ella scheccas Tiar a memoria. Obtegnair ina clav API

Davart Tripo P2 Image to 3D

Transforma ina singula imagina da `image_url` en in model 3D cun fin a 50,000 faces (25,000 per meshes quad). La qualitad da textur po esser fast, standard, detailed u extreme; `texture_version` tscherna il model da textur. Autras opziuns pertutgan chartas PBR, delighting, export UV, auto-sizing e l'axa anteriura d'export (`export_orientation`). Seeds separads controllan geometria e texturas.

Parameters

Invia u il num canonic u il num nativ, betg omaduas. Nums canonics

NumTip StandardPermess Descripziun
image_urlobligatori image
Tipurl · image
URL dal maletg d'input utilisà per crear in model 3D.
face_limitopziunal
Tipinteger | null
48 – 50 000
Limita superiura da las surfatschas dal mesh, cun ina limita separada da 25,000 per la topologia quad.
textureopziunal
Tipboolean
Standardtrue
Controlla sche il model survegn texturas generadas.
pbropziunal
Tipboolean
Standardtrue
Controlla la generaziun da las mapas da material PBR. Activar PBR activa er las texturas.
model_seedopziunal
Tipinteger | null
Seed utilisà per render reproducibla la generaziun da geometria.
texture_seedopziunal
Tipinteger | null
Seed utilisà per render reproducibla la generaziun da texturas.
texture_qualityopziunal
Tipenum
Standardstandard
faststandarddetailedextreme
Configuraziun da la qualitad da las texturas.
texture_versionopziunal
Tipenum
v3.5-20260815v3.0-20250812v2.5-20250123
Versiun utilisada per il modelar da texturas. Per la qualitad rapida, tscherner v3.5-20260815; autras versiuns na vegnan betg sustegnidas per questa qualitad.
delightopziunal
Tipboolean
Standardtrue
Eliminaziun da l'illuminaziun integrada avant la texturaziun cun v3.5-20260815.
auto_sizeopziunal
Tipboolean
Standardfalse
Scala automatica per dar al model dimensiuns realas mesiradas en meters.
export_uvopziunal
Tipboolean
Standardtrue
Controlla sch'il model survegn coordinatas UV generadas.
export_orientationopziunal
Tipenum
+x-x-y+y
Configuraziun da l'axa en avant per l'export dal model, sche specificada.
quadopziunal
Tipboolean
Standardfalse
Topologia dal mesh cun quadrats empè da trianguls.
enable_safety_checkeropziunal
Tipboolean
Standardtrue
La controlla po vegnir schluccada cun definir false, premess che l'appelant saja autorisà.
obligatori Num canonic, er acceptà

Ils parameters da datotecas acceptan ina URL publica https://, ina URI data: fin a 10 MB u il file_url d'ina chargiada. Datotecas

Output

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"
  }
}
Tias datotecas, tia decisiunMintga outputs[].url è ina copia en nossa memorisaziun: conservada per adina (pajà per GB-mes) u 7 dis gratuitamain, tenor la configuraziun dal conto u ?storage=.
La medema structura per mintga modeltype, url, content_type, width, height e duration, tant per maletgs sco per video e audio. output è l'object da resultat dal model sez.
Champs da l'output
model_mesh
object {url, content_type, file_name, file_size}Datoteca GLB u FBX che cuntegna il model 3D generà, cun il format determinà da quai che Tripo producescha.
model_urls
object {glb, fbx, base_model, pbr_model}URLs che mussan sin versiuns alternativas dal model 3D.
rendered_image
object {url, content_type, file_name, file_size} | nullPrevisualisaziun renderisada che mussa il model 3D generà.
task_id
string | nullID da task Tripo reutilisabel che identifitgescha il model generà per rig u rig-check, permettend quellas operaziuns senza in'ulteriura chargiada dal model.

Dapli models: Maletg a 3D

Per agents AI: questa pagina sco Markdown è disponibla sut https://doitong.com/rm/developers/models/tripo3d/p2/image-to-3d.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt