Naar inhoud springen

Tripo H3.1 Image to 3D

Integreren

Model-ID 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"

Bestanden zoals het voorbeeld: $ 0,30 300 API-tegoed · ≈ ₽ 32,27 je bestanden worden vóór de uitvoering gemeten Op deze pagina uitvoeren

API-sleutel ophalen
Tripo Afbeelding naar 3D #3d#image-to-3d#3d-generation#tripo

3D-generatie uit één afbeelding met PBR-materialen, quad-meshes en controle over het aantal vlakken

Tripo · 3D

Je eerste resultaat komt hier

Bouw hieronder een request en voer die uit met je API-sleutel. Uitvoer wordt naar onze opslag gekopieerd en voor altijd of 7 dagen gratis bewaard.

Een aanvraag samenstellen

Besturingselementen worden gegenereerd op basis van het modelschema. De code en de prijs worden bijgewerkt terwijl je ze wijzigt.

•verplicht image_url
Sleep een bestand hierheen of

URL van de invoerafbeelding voor het maken van een 3D-model.

texture_quality standaard standard

Textuurkwaliteitsinstelling; met 'detailed' wordt de textuurresolutie verhoogd.

geometry_quality standaard standard

Kwaliteitsinstelling voor de geometrie.

Geavanceerd texture_alignment · orientation · face_limit · model_seed · texture_seed · auto_size · enable_safety_checker
texture_alignment standaard original_image

Referentie voor textuuruitlijning: gebruik 'geometry' voor de gegenereerde geometrie of 'original_image' voor de invoerafbeelding.

orientation standaard default

Oriëntatie van het model; 'align_image' roteert het automatisch zodat het overeenkomt met de invoerafbeelding.

Expliciet doel voor het aantal vlakken bij meshgeneratie, dat de adaptieve selectie van het model overschrijft wanneer het wordt opgegeven.

Seed waarmee geometriegeneratie reproduceerbaar wordt gemaakt.

Seed waarmee textuurgeneratie reproduceerbaar wordt gemaakt.

POST /run/tripo3d/h3.1/image-to-3d?wait=20 prijsopgave → $ 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"

Deze request uitvoeren

Je sleutel blijft in deze browser: hij wordt alleen naar de Doitong API verzonden en alleen in localStorage opgeslagen als je Onthouden aanvinkt. API-sleutel ophalen

Over Tripo H3.1 Image to 3D

Bouwt een 3D-model op basis van één afbeelding op `image_url`. Opties zijn onder meer `face_limit` (1.000 tot 2.000.000), `texture`, `pbr`, standaard of gedetailleerde `texture_quality` en `geometry_quality`, `quad`-topologie, `auto_size` en `orientation`. Het resultaat bevat een voorbeeldweergave en een taak-ID voor latere rigging.

Parameters

Stuur de canonieke naam of de oorspronkelijke naam, niet beide. Canonieke namen

NaamType StandaardToegestaan Beschrijving
image_urlverplicht image
Typeurl · image
URL van de invoerafbeelding voor het maken van een 3D-model.
face_limitoptioneel
Typeinteger | null
1.000 – 2.000.000
Expliciet doel voor het aantal vlakken bij meshgeneratie, dat de adaptieve selectie van het model overschrijft wanneer het wordt opgegeven.
textureoptioneel
Typeboolean
Standaardtrue
Bepaalt of het model gegenereerde texturen ontvangt.
pbroptioneel
Typeboolean
Standaardtrue
Schakel PBR-materialen (Physically Based Rendering) in; hiermee wordt bij true ook textuurgeneratie ingeschakeld.
model_seedoptioneel
Typeinteger | null
Seed waarmee geometriegeneratie reproduceerbaar wordt gemaakt.
texture_seedoptioneel
Typeinteger | null
Seed waarmee textuurgeneratie reproduceerbaar wordt gemaakt.
texture_qualityoptioneel
Typeenum
Standaardstandard
standarddetailed
Textuurkwaliteitsinstelling; met 'detailed' wordt de textuurresolutie verhoogd.
geometry_qualityoptioneel
Typeenum
Standaardstandard
standarddetailed
Kwaliteitsinstelling voor de geometrie.
texture_alignmentoptioneel
Typeenum
Standaardoriginal_image
original_imagegeometry
Referentie voor textuuruitlijning: gebruik 'geometry' voor de gegenereerde geometrie of 'original_image' voor de invoerafbeelding.
auto_sizeoptioneel
Typeboolean
Standaardfalse
Automatische schaalverdeling om het model echte afmetingen in meters te geven.
orientationoptioneel
Typeenum
Standaarddefault
defaultalign_image
Oriëntatie van het model; 'align_image' roteert het automatisch zodat het overeenkomt met de invoerafbeelding.
quadoptioneel
Typeboolean
Standaardfalse
Kies tussen driehoekige vlakken en quads met 4 zijden door quad-topologie in te schakelen. Voor quad-resultaten wordt een FBX-bestand geretourneerd wanneer Tripo de gegevens als FBX-bytes aanlevert.
enable_safety_checkeroptioneel
Typeboolean
Standaardtrue
Screening kan worden versoepeld door false in te stellen, mits de aanroeper is geautoriseerd.
verplicht Canonieke naam, ook geaccepteerd

Bestandsparameters accepteren een openbare https:// URL, een data: URI tot 10 MB of de file_url van een upload. Bestanden

Uitvoer

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"
  }
}
Jouw bestanden, jouw keuzeElke outputs[].url is een kopie in onze opslag: voor altijd bewaard (betaald per GB-maand) of 7 dagen gratis, volgens je accountinstelling of ?storage=.
Dezelfde structuur voor elk modeltype, url, content_type, width, height en duration, voor afbeeldingen, video en audio. output is het eigen resultaatobject van het model.
Velden van de uitvoer
model_mesh
object {url, content_type, file_name, file_size}GLB- of FBX-bestand met het gegenereerde 3D-model; de indeling wordt bepaald door wat Tripo produceert.
model_urls
object {glb, fbx, base_model, pbr_model}URL's die naar alternatieve versies van het 3D-model verwijzen.
rendered_image
object {url, content_type, file_name, file_size} | nullGerenderde preview met het gegenereerde 3D-model.
task_id
string | nullHerbruikbare Tripo-taak-ID die het gegenereerde model identificeert voor rig of rig-check, zodat deze bewerkingen zonder nieuwe modelupload kunnen worden uitgevoerd.

Meer modellen: Afbeelding naar 3D

Voor AI-agents: deze pagina als Markdown staat op https://doitong.com/nl/developers/models/tripo3d/h3.1/image-to-3d.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt