Naar inhoud springen

Meshy V7 Multi Image to 3D

Integreren

Model-ID meshy/v7/multi-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/meshy/v7/multi-image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "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: $ 1,20 1.200 API-tegoed · ≈ ₽ 129,10 je bestanden worden vóór de uitvoering gemeten Op deze pagina uitvoeren

API-sleutel ophalen
Meshy Afbeelding naar 3D #stylized#transform

Bouwt één 3D-model uit 1 tot 4 weergaven van hetzelfde object, met polygon- en topologiebeheer

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

Afbeeldingsset voor 3D-creatie, met .jpg, .jpeg, .png en AVIF/HEIF met automatische conversie. Lever 1 tot 4 weergaven aan die één object vanuit verschillende hoeken tonen; items na de eerste 4 worden niet gebruikt.

geometry_resolution

Resolutie van de geometrie; 4k is niet beschikbaar voor generatie uit meerdere afbeeldingen.

Geavanceerd texture_prompt · texture_image_url · topology · symmetry_mode · pose_mode · target_polycount · rigging_height_meters · animation_action_id · should_remesh · enable_pbr · is_a_t_pose · enable_safety_checker
0 / 600

Textureringsinstructies als tekstprompt, waarvoor should_texture true moet zijn.

Sleep een bestand hierheen of

Textureringsinstructies als 2D-afbeelding, waarvoor should_texture true moet zijn.

topology standaard triangle

Keuze van modeltopologie tussen Triangle voor geometrische details en Quad voor een glad oppervlak.

symmetry_mode standaard auto

Symmetrie-instelling die tijdens het genereren van het model wordt toegepast.

pose_mode standaard

Laat de tekenreeks leeg om geen pose voor het gegenereerde model op te geven, of vraag een A-pose aan met 'a-pose' of een T-pose met 't-pose'.

standaard 30000

Gewenst aantal polygonen voor het uitvoermodel.

standaard 1.7

Geef een geschatte karakterhoogte in meter op wanneer enable_rigging true is; anders heeft deze waarde geen effect.

standaard 92

ID van een Meshy-animatiepreset uit de bibliotheek, met beschikbare acties op https://docs.meshy.ai/en/api/animation-library. Validatie en gebruik gelden alleen wanneer enable_animation true is: waarden buiten [0, 696] worden afgewezen met een 422 en "Idle" komt overeen met `0`.

POST /run/meshy/v7/multi-image-to-3d?wait=20 prijsopgave → $ 1,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/meshy/v7/multi-image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "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 Meshy V7 Multi Image to 3D

Reconstrueert één object uit `image_urls`, dat één tot vier foto's vanuit verschillende hoeken accepteert. Stel `topology` in op quad of triangle en `target_polycount` op 100 tot 300000, en kies standard of 2k als `geometry_resolution`. Texturering is optioneel via `should_texture`, met beschikbare PBR-kanalen, posemodus, rigging en animatie. De uitvoer bevat een GLB en andere formaten.

Parameters

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

NaamType StandaardToegestaan Beschrijving
image_urlsverplicht images
Typeurl[] · image
Afbeeldingsset voor 3D-creatie, met .jpg, .jpeg, .png en AVIF/HEIF met automatische conversie. Lever 1 tot 4 weergaven aan die één object vanuit verschillende hoeken tonen; items na de eerste 4 worden niet gebruikt.
topologyoptioneel
Typeenum
Standaardtriangle
quadtriangle
Keuze van modeltopologie tussen Triangle voor geometrische details en Quad voor een glad oppervlak.
target_polycountoptioneel
Typeinteger
Standaard30000
100 – 300.000
Gewenst aantal polygonen voor het uitvoermodel.
symmetry_modeoptioneel
Typeenum
Standaardauto
offautoon
Symmetrie-instelling die tijdens het genereren van het model wordt toegepast.
should_remeshoptioneel
Typeboolean
Standaardtrue
Of de remeshfase moet worden uitgevoerd. Als je dit op false instelt, wordt een driehoekige mesh geproduceerd; topology en target_polycount worden dan genegeerd.
should_textureoptioneel
Typeboolean
Standaardtrue
Schakelt textuurgeneratie in of uit.
enable_pbroptioneel
Typeboolean
Standaardfalse
Extra PBR-uitvoerschakelaar, alleen beschikbaar wanneer should_texture op true staat; voegt naast de basiskleur kaarten voor metallic, roughness en normal toe.
is_a_t_poseoptioneel
Typeboolean
Standaardfalse
Schakelaar voor T-posegeneratie, geactiveerd door true; vervangen door pose_mode.
pose_modeoptioneel
Typeenum
Standaard
a-poset-pose
Laat de tekenreeks leeg om geen pose voor het gegenereerde model op te geven, of vraag een A-pose aan met 'a-pose' of een T-pose met 't-pose'.
texture_promptoptioneel
Typestring | null
≤ 600 tekens
Textureringsinstructies als tekstprompt, waarvoor should_texture true moet zijn.
texture_image_urloptioneel
Typeurl · image
Textureringsinstructies als 2D-afbeelding, waarvoor should_texture true moet zijn.
enable_riggingoptioneel
Typeboolean
Standaardfalse
Automatische humanoïde rigging, het effectiefst voor humanoïde modellen waarvan de ledematen duidelijk te onderscheiden zijn. Inschakelen voorziet het gegenereerde model van rigging en levert basisanimaties voor lopen en rennen.
rigging_height_metersoptioneel
Typenumber
Standaard1.7
> 0
Geef een geschatte karakterhoogte in meter op wanneer enable_rigging true is; anders heeft deze waarde geen effect.
enable_animationoptioneel
Typeboolean
Standaardfalse
Of het gerigde model een vooraf ingestelde animatie krijgt; hiervoor moet enable_rigging true zijn.
animation_action_idoptioneel
Typeinteger
Standaard92
ID van een Meshy-animatiepreset uit de bibliotheek, met beschikbare acties op https://docs.meshy.ai/en/api/animation-library. Validatie en gebruik gelden alleen wanneer enable_animation true is: waarden buiten [0, 696] worden afgewezen met een 422 en "Idle" komt overeen met `0`.
enable_safety_checkeroptioneel
Typeboolean
Standaardtrue
Schakelaar voor de veiligheidscontrole vóór verwerking: true maakt een veiligheidscontrole van de invoer verplicht vóór verwerking.
geometry_resolutionoptioneel
Typeenum
standard2k
Resolutie van de geometrie; 4k is niet beschikbaar voor generatie uit meerdere afbeeldingen.
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": "meshy/v7/multi-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": 1200,
    "usd": "1.20",
    "charged": 1200,
    "refunded": 0
  },
  "input": {
    "image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  },
  "output": {
    "animation_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
    },
    "animation_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
    },
    "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
      },
      "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
      },
      "blend": {
        "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
      },
      "stl": {
        "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_urls": [
      {
        "base_color": {
          "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
        },
        "metallic": {
          "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
        },
        "normal": {
          "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
        },
        "roughness": {
          "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,
    "rigged_character_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
    },
    "rigged_character_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
    },
    "basic_animations": {
      "walking_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
      },
      "walking_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
      },
      "walking_armature_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
      },
      "running_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
      },
      "running_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
      },
      "running_armature_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
      }
    },
    "rig_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
animation_glb
object {url, content_type, file_name, file_size} | nullAnimatieresultaat met het 3D-model als GLB; de response laat dit resultaat weg tenzij enable_animation true is.
animation_fbx
object {url, content_type, file_name, file_size} | nullAnimatieresultaat met het 3D-model als FBX; de response laat dit resultaat weg tenzij enable_animation true is.
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, usdz, blend, stl}Links naar het 3D-model in verschillende indelingen.
texture_urls
array of object {base_color, metallic, normal, roughness}Textuurbestanden weergegeven als array met objecten.
seed
integer | nullGeneratieseed, indien beschikbaar.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullRiggingresultaat als GLB-karakterbestand; ontbreekt in de response tenzij enable_rigging true is.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullRiggingresultaat als FBX-karakterbestand; ontbreekt in de response tenzij enable_rigging true is.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullBasisanimaties voor lopen en rennen, alleen opgenomen als enable_rigging true is.
rig_task_id
string | nullIdentifier voor de riggingtaak; alleen opgenomen als enable_rigging true is.

Meer modellen: Afbeelding naar 3D

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