Saltar al cuntegna

Tripo H3.1 Image to 3D

Integrar

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

Datotecas sco l'exempel: $0,30 300 credits API · ≈ ₽32,27 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#tripo

Generaziun 3D d'ina singula imagina cun materials PBR, meshes quad e controll dal dumber da faces

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 la textura; «detailed» augmenta la resoluziun da la textura.

geometry_quality standard standard

Configuraziun da la qualitad da la geometria.

Avanzà texture_alignment · orientation · face_limit · model_seed · texture_seed · auto_size · enable_safety_checker
texture_alignment standard original_image

Referenza per l'allineament da la textura: utilisar «geometry» per la geometria generada u «original_image» per l'input maletg.

orientation standard default

Orientaziun dal model; «align_image» al rotescha automaticamain per l'adattar a l'input maletg.

Finamira explicita dal dumber da fatschas per la generaziun da la rait, che surscriva la selecziun adaptiva dal dumber dal model sch'ella vegn furnida.

Seed utilisà per render reproducibla la generaziun da geometria.

Seed utilisà per render reproducibla la generaziun da texturas.

POST /run/tripo3d/h3.1/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/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"

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 H3.1 Image to 3D

Construescha in model 3D dad in maletg a `image_url`. Las opziuns includan `face_limit` (1,000 fin a 2,000,000), `texture`, `pbr`, qualitad da `texture_quality` e `geometry_quality` standard u detagliada, topologia `quad`, `auto_size` ed `orientation`. Il resultat cuntegna in renderisar da prevista ed in ID da la incumbensa per rigging posteriur.

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
1 000 – 2 000 000
Finamira explicita dal dumber da fatschas per la generaziun da la rait, che surscriva la selecziun adaptiva dal dumber dal model sch'ella vegn furnida.
textureopziunal
Tipboolean
Standardtrue
Controlla sche il model survegn texturas generadas.
pbropziunal
Tipboolean
Standardtrue
Activar materials PBR (Physically Based Rendering), quai che activa era la generaziun da texturas sche true.
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
standarddetailed
Configuraziun da la qualitad da la textura; «detailed» augmenta la resoluziun da la textura.
geometry_qualityopziunal
Tipenum
Standardstandard
standarddetailed
Configuraziun da la qualitad da la geometria.
texture_alignmentopziunal
Tipenum
Standardoriginal_image
original_imagegeometry
Referenza per l'allineament da la textura: utilisar «geometry» per la geometria generada u «original_image» per l'input maletg.
auto_sizeopziunal
Tipboolean
Standardfalse
Scala automatica per dar al model dimensiuns realas mesiradas en meters.
orientationopziunal
Tipenum
Standarddefault
defaultalign_image
Orientaziun dal model; «align_image» al rotescha automaticamain per l'adattar a l'input maletg.
quadopziunal
Tipboolean
Standardfalse
Tscherner tranter surfatschas triangularas e quadrats cun 4 varts activond la topologia quad. Per resultats quad vegn restituida ina datoteca FBX, sch'in Tripo furnescha las datas sco bytes FBX.
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/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"
  }
}
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/h3.1/image-to-3d.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt