Saltar al cuntegna

Tripo H3.1 Text to 3D

Integrar

ID dal model tripo3d/h3.1/text-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/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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,20 200 credits API · ≈ ₽21,52 tias datotecas vegnan mesiradas avant l'execuziun Lantschar sin questa pagina

Obtegna ina clav API
Tripo Text a 3D #3d#text-to-3d#3d-generation#tripo

Generatur da mesh 3D text-to-3D cun prompt negativ, nivels separads per qualitad da geometria e textura, e in limit fitg aut da fatschas

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 88 / 1024

Descripziun textuala da l'object 3D giavischà, limitada a 1024 caracters.

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à negative_prompt · face_limit · model_seed · image_seed · texture_seed · auto_size · enable_safety_checker
0 / 1024

Descripziun da las caracteristicas che duain vegnir exclusas dal model generà.

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à durant la fasa text-to-image.

Seed utilisà per render reproducibla la generaziun da texturas.

POST /run/tripo3d/h3.1/text-to-3d?wait=20 calculaziun → $0,20
# 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/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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 Text to 3D

Construiescha in model 3D d'ina descripziun da text da maximalmain 1024 caracters, cun in `negative_prompt` opzional per caracteristicas d'evitar. `face_limit` accepta 1,000 to 2,000,000 faces. `geometry_quality` e `texture_quality` pon esser standard u detailed. Opziuns includan materials PBR, topologia quad, scalaziun automatica a la grondezza reala e seeds separads per geometria, il pass text-to-image e textur.

Parameters

NumTip StandardPermess Descripziun
promptobligatori
Tipstring
≤ 1 024 caracters
Descripziun textuala da l'object 3D giavischà, limitada a 1024 caracters.
negative_promptopziunal
Tipstring | null
≤ 1 024 caracters
Descripziun da las caracteristicas che duain vegnir exclusas dal model generà.
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.
image_seedopziunal
Tipinteger | null
Seed utilisà durant la fasa text-to-image.
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.
auto_sizeopziunal
Tipboolean
Standardfalse
Scala automatica per dar al model dimensiuns realas mesiradas en meters.
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

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/h3.1/text-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": 200,
    "usd": "0.20",
    "charged": 200,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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: Text a 3D

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