Naar inhoud springen

Hunyuan 3D Rapid Image to 3D

Integreren

Model-ID hunyuan-3d/v3.1/rapid/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/rapid/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: $ 0,225 225 API-tegoed · ≈ ₽ 24,18 Op deze pagina uitvoeren

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

Snelle conversie van afbeelding naar 3D, waarbij één afbeelding van de voorkant wordt gebruikt, met optionele PBR of een ongetextureerde mesh

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

Lever een afbeelding van de voorzijde aan via een URL; een eenvoudige achtergrond met één object dat meer dan 50% van het frame bedekt, wordt aanbevolen. Gebruik JPG, PNG of WEBP met een resolutie tussen 128 en 5000px en een bestandsgroottelimiet van 8 MB; voor base64-codering wordt 6 MB of minder aanbevolen.

Geavanceerd enable_geometry
POST /run/hunyuan-3d/v3.1/rapid/image-to-3d?wait=20 prijsopgave → $ 0,225
# 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/rapid/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 Rapid Image to 3D

Maakt een 3D-model op basis van één afbeelding van het vooraanzicht (`input_image_url`, 128 tot 5000 px, maximaal 8MB, JPG, PNG of WEBP). Werkt het best met een eenvoudige achtergrond en één object dat meer dan de helft van het frame vult. `enable_pbr` voegt texturen voor metaalachtigheid, ruwheid en normalen toe, terwijl `enable_geometry` een wit model zonder textuur als GLB retourneert. De uitvoer omvat het model, URL's per formaat, een textuur, een MTL-bestand en een miniatuur.

Parameters

NaamType StandaardToegestaan Beschrijving
input_image_urlverplicht
Typeurl · image
Lever een afbeelding van de voorzijde aan via een URL; een eenvoudige achtergrond met één object dat meer dan 50% van het frame bedekt, wordt aanbevolen. Gebruik JPG, PNG of WEBP met een resolutie tussen 128 en 5000px en een bestandsgroottelimiet van 8 MB; voor base64-codering wordt 6 MB of minder aanbevolen.
enable_pbroptioneel
Typeboolean
Standaardfalse
Schakelaar voor PBR-generatie, inactief wanneer enable_geometry True is. Anders voegt inschakeling metallische, ruwheids- en normaaltexturen toe aan de gegenereerde materialen.
enable_geometryoptioneel
Typeboolean
Standaardfalse
Schakelaar voor generatie uitsluitend van geometrie, die OBJ-ondersteuning uitschakelt, de uitvoer standaard op GLB instelt en enable_pbr negeert wanneer ingeschakeld. Het resulterende model is wit en heeft geen texturen.
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/rapid/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": 225,
    "usd": "0.225",
    "charged": 225,
    "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
    },
    "material_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
    },
    "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
      }
    }
  },
  "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} | nullBestand met het gegenereerde 3D-model, met GLB wanneer beschikbaar en anders OBJ.
material_mtl
object {url, content_type, file_name, file_size} | nullMTL-bestand met materialen voor het OBJ-model.
texture
object {url, content_type, file_name, file_size} | nullAfbeelding met de textuur van het 3D-model.
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.

Meer modellen: Afbeelding naar 3D

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