Naar inhoud springen

Meshy V7 Image to 3D

Integreren

Model-ID meshy/v7/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/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: $ 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

Zet één afbeelding om in een 3D-mesh met 2k-geometrieoptie, optionele PBR, rigging en animatie

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

Lever de bronafbeelding voor 3D-creatie aan via URL of base64-data-URI, met .jpg, .jpeg, .png, AVIF of HEIF. AVIF- en HEIF-invoer wordt automatisch geconverteerd.

geometry_resolution

Resolutie van de meshgeometrie; de ondersteunde Meshy-7-opties zijn standard en 2k.

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

Tekstinstructies die textuurgeneratie aansturen.

Sleep een bestand hierheen of

2D-referentieafbeelding die textuurgeneratie aanstuurt.

model_type standaard standard

3D-meshmodus: kies 'lowpoly' voor een low-polyresultaat dat is geoptimaliseerd voor strakkere polygonen; in deze modus negeert Meshy topology, target_polycount en should_remesh. Kies 'standard' voor een conventioneel resultaat met veel details, of 'smart-topology' om Meshy-T2 te gebruiken en vanaf het begin afzonderlijk gegenereerde, schone onderdelen te verkrijgen.

topology standaard triangle

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

symmetry_mode standaard auto

Kies of modelgeneratie symmetrie afdwingt met On, deze weglaat met Off of automatisch beslist met Auto.

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

Doel voor het aantal polygonen, begrensd op 15,000 wanneer model_type 'smart-topology' is. Als je het doel in die modus weglaat, wordt Meshy's lagere standaardwaarde van 4,000 gebruikt.

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/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/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 Meshy V7 Image to 3D

Maakt een 3D-model uit één afbeelding in `image_url` (JPG, PNG, AVIF of HEIF). `model_type` selecteert standard, lowpoly of smart-topology en `target_polycount` accepteert 100 tot 300000. `geometry_resolution` biedt standard of 2k. Texturering kan worden uitgeschakeld met `should_texture`; PBR-kanalen, een posemodus, humanoïde rigging en een animatievoorinstelling zijn optioneel.

Parameters

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

NaamType StandaardToegestaan Beschrijving
image_urlverplicht image
Typeurl · image
Lever de bronafbeelding voor 3D-creatie aan via URL of base64-data-URI, met .jpg, .jpeg, .png, AVIF of HEIF. AVIF- en HEIF-invoer wordt automatisch geconverteerd.
model_typeoptioneel
Typeenum
Standaardstandard
standardlowpolysmart-topology
3D-meshmodus: kies 'lowpoly' voor een low-polyresultaat dat is geoptimaliseerd voor strakkere polygonen; in deze modus negeert Meshy topology, target_polycount en should_remesh. Kies 'standard' voor een conventioneel resultaat met veel details, of 'smart-topology' om Meshy-T2 te gebruiken en vanaf het begin afzonderlijk gegenereerde, schone onderdelen te verkrijgen.
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
Doel voor het aantal polygonen, begrensd op 15,000 wanneer model_type 'smart-topology' is. Als je het doel in die modus weglaat, wordt Meshy's lagere standaardwaarde van 4,000 gebruikt.
symmetry_modeoptioneel
Typeenum
Standaardauto
offautoon
Kies of modelgeneratie symmetrie afdwingt met On, deze weglaat met Off of automatisch beslist met Auto.
should_remeshoptioneel
Typeboolean
Standaardtrue
Schakelt de remeshingfase in of uit.
should_textureoptioneel
Typeboolean
Standaardtrue
Schakelt textuurgeneratie in of uit.
enable_pbroptioneel
Typeboolean
Standaardfalse
Voegt naast de basiskleur PBR-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
Tekstinstructies die textuurgeneratie aansturen.
texture_image_urloptioneel
Typeurl · image
2D-referentieafbeelding die textuurgeneratie aanstuurt.
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 meshgeometrie; de ondersteunde Meshy-7-opties zijn standard en 2k.
ultra_modeoptioneel
Typeboolean
Standaardfalse
Verouderde optie, vervangen door geometry_resolution, die wint als beide zijn aangeleverd; gebruik in plaats daarvan geometry_resolution='2k'.
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/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_url": "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}Objecten met textuurbestanden in een array, gestructureerd volgens de Meshy API.
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/image-to-3d.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt