Naar inhoud springen

Hunyuan 3D Pro Image to 3D

Integreren

Model-ID hunyuan-3d/v3.1/pro/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/hunyuan-3d/v3.1/pro/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_url": "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,375 375 API-tegoed · ≈ ₽ 40,24 je bestanden worden vóór de uitvoering gemeten Op deze pagina uitvoeren

API-sleutel ophalen
Tencent Afbeelding naar 3D #3d#hunyuan#image-to-3d

Bouwt een 3D-model uit een afbeelding van de voorkant plus optionele extra aanzichten, met regeling voor aantal vlakken en PBR

Tencent · 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
Sleep een bestand hierheen of

URL van een JPG-, PNG- of WEBP-afbeelding van de voorzijde, met een resolutie van 128 tot 5000px en een grootte van maximaal 8 MB. Gebruik bij voorkeur een eenvoudige achtergrond en één object dat meer dan 50% van het frame vult.

Sleep een bestand hierheen of

URL van een afbeelding van de achter- of achterkant, optioneel; JPG/PNG wordt aanbevolen.

Sleep een bestand hierheen of

URL van een afbeelding van de linkerzijde, optioneel; JPG/PNG wordt aanbevolen.

Sleep een bestand hierheen of

URL van een afbeelding van de rechterzijde, optioneel; JPG/PNG wordt aanbevolen.

Sleep een bestand hierheen of

URL van een afbeelding van bovenaf, optioneel en alleen beschikbaar in v3.1; JPG/PNG wordt aanbevolen.

Sleep een bestand hierheen of

URL van een optionele afbeelding van onderaf, alleen ondersteund in v3.1. JPG/PNG wordt aanbevolen.

Sleep een bestand hierheen of

Optionele afbeeldings-URL, alleen beschikbaar in v3.1, bij voorkeur in JPG/PNG-indeling. De afbeelding toont een hoek van 45 graden vanaf linksvoor.

Sleep een bestand hierheen of

Optionele afbeeldings-URL, alleen beschikbaar in v3.1, bij voorkeur in JPG/PNG-indeling. De afbeelding toont een hoek van 45 graden vanaf rechtsvoor.

standaard 500000

Gewenst aantal polygoonvlakken, van 40,000 tot 1,500,000. Standaard 500,000.

Geavanceerd generate_type
generate_type standaard Normal

Kies tussen een model met textuur en Normal en een wit model zonder textuur, uitsluitend geometrie, met Geometry. In v3.1 kunnen LowPoly/Sketch niet worden geselecteerd.

POST /run/hunyuan-3d/v3.1/pro/image-to-3d?wait=20 prijsopgave → $ 0,375
# 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/hunyuan-3d/v3.1/pro/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_url": "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 Hunyuan 3D Pro Image to 3D

Maakt een 3D-model uit de verplichte vooraanzichtafbeelding `input_image_url`. Optionele afbeeldingen van achter-, linker-, rechter-, boven- en onderaanzicht en twee aanzichten van 45 graden kunnen extra detail toevoegen. `generate_type` selecteert een getextureerd model of een wit model met alleen geometrie, `enable_pbr` voegt PBR-materialen toe en `face_count` varieert van 40,000 tot 1,500,000. Retourneert een GLB, URL's naar andere formaten en een thumbnail.

Parameters

NaamType StandaardToegestaan Beschrijving
input_image_urlverplicht
Typeurl · image
URL van een JPG-, PNG- of WEBP-afbeelding van de voorzijde, met een resolutie van 128 tot 5000px en een grootte van maximaal 8 MB. Gebruik bij voorkeur een eenvoudige achtergrond en één object dat meer dan 50% van het frame vult.
back_image_urloptioneel
Typeurl · image
URL van een afbeelding van de achter- of achterkant, optioneel; JPG/PNG wordt aanbevolen.
left_image_urloptioneel
Typeurl · image
URL van een afbeelding van de linkerzijde, optioneel; JPG/PNG wordt aanbevolen.
right_image_urloptioneel
Typeurl · image
URL van een afbeelding van de rechterzijde, optioneel; JPG/PNG wordt aanbevolen.
top_image_urloptioneel
Typeurl · image
URL van een afbeelding van bovenaf, optioneel en alleen beschikbaar in v3.1; JPG/PNG wordt aanbevolen.
bottom_image_urloptioneel
Typeurl · image
URL van een optionele afbeelding van onderaf, alleen ondersteund in v3.1. JPG/PNG wordt aanbevolen.
left_front_image_urloptioneel
Typeurl · image
Optionele afbeeldings-URL, alleen beschikbaar in v3.1, bij voorkeur in JPG/PNG-indeling. De afbeelding toont een hoek van 45 graden vanaf linksvoor.
right_front_image_urloptioneel
Typeurl · image
Optionele afbeeldings-URL, alleen beschikbaar in v3.1, bij voorkeur in JPG/PNG-indeling. De afbeelding toont een hoek van 45 graden vanaf rechtsvoor.
generate_typeoptioneel
Typeenum
StandaardNormal
NormalGeometry
Kies tussen een model met textuur en Normal en een wit model zonder textuur, uitsluitend geometrie, met Geometry. In v3.1 kunnen LowPoly/Sketch niet worden geselecteerd.
enable_pbroptioneel
Typeboolean
Standaardfalse
Schakelaar voor PBR-generatie, inactief wanneer generate_type Geometry is. Anders voegt inschakeling metallische, ruwheids- en normaaltexturen toe aan de gegenereerde materialen.
face_countoptioneel
Typeinteger
Standaard500000
40.000 – 1.500.000
Gewenst aantal polygoonvlakken, van 40,000 tot 1,500,000. Standaard 500,000.
verplicht

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": "hunyuan-3d/v3.1/pro/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": 375,
    "usd": "0.375",
    "charged": 375,
    "refunded": 0
  },
  "input": {
    "input_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_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
    },
    "thumbnail": {
      "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
      },
      "obj": {
        "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
      },
      "mtl": {
        "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
      },
      "texture": {
        "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
      },
      "usdz": {
        "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
      }
    },
    "seed": 42
  },
  "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_glb
object {url, content_type, file_name, file_size}GLB-bestand met het gegenereerde 3D-object.
thumbnail
object {url, content_type, file_name, file_size} | nullMiniatuur met een voorbeeld van het gegenereerde model.
model_urls
object {glb, fbx, obj, mtl, texture, usdz}Links naar het 3D-model in verschillende indelingen.
seed
integer | nullSeedwaarde die tijdens de generatie wordt gebruikt.

Meer modellen: Afbeelding naar 3D

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