Gå til innhold

Tripo H3.1 Image to 3D

Integrer

Modell-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"

Filer som eksempelet: 0,30 $ 300 API-kreditter · ≈ 32,27 ₽ filene dine måles før kjøring Kjør den på denne siden

Hent API-nøkkel
Tripo Bilde til 3D #3d#image-to-3d#3d-generation#tripo

3D-generering fra ett bilde med PBR-materialer, quad-nett og kontroll over antall flater

Tripo · 3D

Det første resultatet ditt kommer her

Bygg en forespørsel nedenfor og kjør den med API-nøkkelen din. Utdata kopieres til lagringen vår, lagret for alltid eller 7 dager gratis.

Bygg en forespørsel

Kontrollene genereres fra modellskjemaet. Koden og prisen oppdateres når du endrer dem.

•obligatorisk image_url
Slipp en fil, eller

URL til inndatabildet som brukes til å opprette en 3D-modell.

texture_quality standard standard

Innstilling for teksturkvalitet; valg av 'detailed' øker teksturoppløsningen.

geometry_quality standard standard

Kvalitetsinnstilling for geometrien.

Avansert texture_alignment · orientation · face_limit · model_seed · texture_seed · auto_size · enable_safety_checker
texture_alignment standard original_image

Referanse for teksturjustering: bruk 'geometry' for den genererte geometrien eller 'original_image' for inndatabildet.

orientation standard default

Modellens orientering; 'align_image' roterer den automatisk slik at den samsvarer med inndatabildet.

Eksplisitt mål for antall flater ved mesh-generering, som overstyrer modellens adaptive valg av antall når det oppgis.

Seed som brukes til å gjøre geometrigenereringen reproduserbar.

Seed som brukes til å gjøre teksturgenereringen reproduserbar.

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

Kjør denne forespørselen

Nøkkelen din blir i denne nettleseren: Den sendes bare til Doitong API og lagres bare i localStorage hvis du krysser av for Husk. Hent en API-nøkkel

Om Tripo H3.1 Image to 3D

Bygger en 3D-modell fra ett bilde ved `image_url`. Alternativene omfatter `face_limit` (1,000 til 2,000,000), `texture`, `pbr`, standard eller detaljert `texture_quality` og `geometry_quality`, `quad`-topologi, `auto_size` og `orientation`. Resultatet inneholder en forhåndsvisning og en oppgave-ID for senere rigging.

Parametere

Send enten det kanoniske navnet eller det opprinnelige navnet, ikke begge. Kanoniske navn

NavnType StandardTillatt Beskrivelse
image_urlobligatorisk image
Typeurl · image
URL til inndatabildet som brukes til å opprette en 3D-modell.
face_limitvalgfritt
Typeinteger | null
1 000 – 2 000 000
Eksplisitt mål for antall flater ved mesh-generering, som overstyrer modellens adaptive valg av antall når det oppgis.
texturevalgfritt
Typeboolean
Standardtrue
Styrer om modellen mottar genererte teksturer.
pbrvalgfritt
Typeboolean
Standardtrue
Aktiver PBR-materialer (Physically Based Rendering), noe som også aktiverer teksturgenerering når verdien er true.
model_seedvalgfritt
Typeinteger | null
Seed som brukes til å gjøre geometrigenereringen reproduserbar.
texture_seedvalgfritt
Typeinteger | null
Seed som brukes til å gjøre teksturgenereringen reproduserbar.
texture_qualityvalgfritt
Typeenum
Standardstandard
standarddetailed
Innstilling for teksturkvalitet; valg av 'detailed' øker teksturoppløsningen.
geometry_qualityvalgfritt
Typeenum
Standardstandard
standarddetailed
Kvalitetsinnstilling for geometrien.
texture_alignmentvalgfritt
Typeenum
Standardoriginal_image
original_imagegeometry
Referanse for teksturjustering: bruk 'geometry' for den genererte geometrien eller 'original_image' for inndatabildet.
auto_sizevalgfritt
Typeboolean
Standardfalse
Automatisk skalering som gir modellen virkelige dimensjoner målt i meter.
orientationvalgfritt
Typeenum
Standarddefault
defaultalign_image
Modellens orientering; 'align_image' roterer den automatisk slik at den samsvarer med inndatabildet.
quadvalgfritt
Typeboolean
Standardfalse
Velg mellom trekantede flater og firkanter med 4 sider ved å aktivere quad-topologi. For quad-resultater returneres en FBX-fil når Tripo leverer dataene som FBX-byte.
enable_safety_checkervalgfritt
Typeboolean
Standardtrue
Filtreringen kan lempes ved å angi false, forutsatt at den som gjør forespørselen, er autorisert.
obligatorisk Kanonisk navn, også godkjent

Filparametere tar imot en offentlig https:// URL, en data: URI på opptil 10 MB eller file_url fra en opplasting. Filer

Utdata

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"
  }
}
Filene dine, ditt valgHver outputs[].url er en kopi på lagringen vår: lagret for alltid (betalt per GB-måned) eller 7 dager gratis, styrt av kontoinnstillingen din eller ?storage=.
Samme struktur for hver modelltype, url, content_type, width, height og duration, for bilder, video og lyd. output er modellens eget resultatobjekt.
Utdatafelt
model_mesh
object {url, content_type, file_name, file_size}GLB- eller FBX-fil som inneholder den genererte 3D-modellen, med format bestemt av det Tripo produserer.
model_urls
object {glb, fbx, base_model, pbr_model}URL-er som peker til alternative versjoner av 3D-modellen.
rendered_image
object {url, content_type, file_name, file_size} | nullGjengitt forhåndsvisning som viser den genererte 3D-modellen.
task_id
string | nullGjenbrukbar Tripo-oppgave-ID som identifiserer den genererte modellen for rig eller rig-check, slik at disse operasjonene kan utføres uten å laste opp en ny modell.

Flere modeller: Bilde til 3D

For AI-agenter: Denne siden som Markdown finnes på https://doitong.com/no/developers/models/tripo3d/h3.1/image-to-3d.md. Alle modeller og veiledninger: https://doitong.com/developers/llms.txt