Saltar al cuntegna

Tripo3D · Image to 3D

Integrar

ID dal model tripo3d/tripo/v2.5/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/tripo/v2.5/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"

Datotecas sco l'exempel: $0,30 300 credits API · ≈ ₽32,19 tias datotecas vegnan mesiradas avant l'execuziun Lantschar sin questa pagina

Obtegna ina clav API
Tripo Maletg a 3D #image-to-3d#stylized

Image-to-3D (v2.5) cun preselecziuns da stil, texturaziun HD, output quad ed opziuns d'alignament

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 utilisà per generar il model.

texture standard standard

Configuraziun da la textura dal model: «standard» è il standard, «no» disactivescha las texturas e «HD» producescha texturas ad auta definiziun.

Configuraziun dal stil; laschar betg specificà per mantegnair l'apparientscha e'l stil original.

Avanzà texture_alignment · orientation · face_limit · seed · texture_seed · pbr · auto_size
texture_alignment standard original_image

Configuraziun da prioritad per l'allineament da las texturas d'in model 3D, cun original_image sco standard sch'ins na furnescha betg in'autra valur.

orientation standard default

Orientaziun dal model, definida inizialmain sco `default`. Tscherna `align_image` per rotar automaticamain il model ed al alinear cun il maletg original.

Limita dal dumber da surfatschas en l'output, tschernida adattivamain sch'ins na furnescha betg ina limita explicita.

Seed entir che controlla la generaziun da geometria; reutilisarlo producescha models identics. Sch'omess, vegn tschernì in valur casuala.

Seed da la generaziun da texturas, furnì sco entir u tschernì casualmain sch'omess. Valurs identicas dal seed reproduceschan las texturas; per midar las texturas d'in model, variar texture_seed e mantegnair constant il seed dal model.

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

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 Tripo3D · Image to 3D

Generescha in model 3D dad in sulet `image_url`. `texture` po esser no, standard u HD, cun output PBR facultativ. Ina preselecziun `style`, sco clay, steampunk, gold u ancient bronze, po midar il stil dal resultat. Autras controllas èn `face_limit`, `quad` (endrizza FBX), `auto_size`, `texture_alignment` ed `orientation` per alinear il model cun il maletg.

Parameters

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

NumTip StandardPermess Descripziun
seedopziunal
Tipinteger | null
Seed entir che controlla la generaziun da geometria; reutilisarlo producescha models identics. Sch'omess, vegn tschernì in valur casuala.
face_limitopziunal
Tipinteger | null
Limita dal dumber da surfatschas en l'output, tschernida adattivamain sch'ins na furnescha betg ina limita explicita.
pbropziunal
Tipboolean | null
Standardfalse
Activader PBR: False producescha in model senza PBR, entant che True surscriva la configuraziun da la textura e la tracta sco True. PBR è activà per standard.
textureopziunal
Tipenum
Standardstandard
nostandardHD
Configuraziun da la textura dal model: «standard» è il standard, «no» disactivescha las texturas e «HD» producescha texturas ad auta definiziun.
texture_seedopziunal
Tipinteger | null
Seed da la generaziun da texturas, furnì sco entir u tschernì casualmain sch'omess. Valurs identicas dal seed reproduceschan las texturas; per midar las texturas d'in model, variar texture_seed e mantegnair constant il seed dal model.
auto_sizeopziunal
Tipboolean | null
Standardfalse
Activader per dimensiuns realas, disactivà per standard (False), che adatta automaticamain las dimensiuns dal model cun meters.
styleopziunal
Tipenum
person:person2cartoonobject:clayobject:steampunkanimal:venomobject:barbieobject:christmasgoldancient_bronze
Configuraziun dal stil; laschar betg specificà per mantegnair l'apparientscha e'l stil original.
quadopziunal
Tipboolean | null
Standardfalse
Il modus quad forza l'output FBX sch'el è activà. Cun quad=True e senza face_limit specificà, è face_limit per standard 10000.
texture_alignmentopziunal
Tipenum
Standardoriginal_image
original_imagegeometry
Configuraziun da prioritad per l'allineament da las texturas d'in model 3D, cun original_image sco standard sch'ins na furnescha betg in'autra valur.
orientationopziunal
Tipenum
Standarddefault
defaultalign_image
Orientaziun dal model, definida inizialmain sco `default`. Tscherna `align_image` per rotar automaticamain il model ed al alinear cun il maletg original.
image_urlobligatori image
Tipurl · image
URL dal maletg utilisà per generar il model.
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/tripo/v2.5/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": {
    "task_id": "string",
    "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
    },
    "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
    }
  },
  "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"
  }
}
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
task_id
stringIdentificader dal task per generar il model 3D.
model_mesh
object {url, content_type, file_name, file_size} | nullOutput dal model.
base_model
object {url, content_type, file_name, file_size} | nullOutput dal model da basa.
pbr_model
object {url, content_type, file_name, file_size} | nullOutput dal model PBR.
rendered_image
object {url, content_type, file_name, file_size} | nullMaletg che mussa ina previsualisaziun dal model.

Dapli models: Maletg a 3D

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