Naar inhoud springen

Meshy 6 · Text to 3D

Integreren

Model-ID meshy/v6/text-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/v6/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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,80 800 API-tegoed · ≈ ₽ 86,06 Op deze pagina uitvoeren

API-sleutel ophalen
Meshy Tekst naar 3D #text-to-3d

Text-naar-3D-meshgenerator met preview- of getextureerde modi, 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 88 / 600

Beschrijving van het object dat als 3D-model moet worden weergegeven, beperkt tot 600 tekens.

Geavanceerd texture_prompt · texture_image_url · mode · model_type · topology · symmetry_mode · pose_mode · target_polycount · rigging_height_meters · animation_action_id · seed · should_remesh · enable_pbr · is_a_t_pose · enable_prompt_expansion · enable_rigging · enable_animation · enable_safety_checker
0 / 600

Stuur texturering aan met een extra tekstprompt in de modus 'full'; andere modi gebruiken deze niet.

Sleep een bestand hierheen of

2D-referentieafbeelding voor textuurgeneratie, alleen toegepast in de modus 'full'.

mode standaard full

Generatiemodus: 'preview' levert geometrie zonder texturen, terwijl 'full' een getextureerd model levert door preview en refine te combineren.

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 tijdens de geometrie- (preview-)stap 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

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

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`.

Gebruik deze seed samen met een ongewijzigde prompt om doorgaans een eerder resultaat opnieuw te produceren.

POST /run/meshy/v6/text-to-3d?wait=20 prijsopgave → $ 0,80
# 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/v6/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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 6 · Text to 3D

Bouwt een 3D-model uit een tekstuele `prompt` van maximaal 600 tekens. `mode` kiest ongetextureerde geometrie (`preview`) of een getextureerd resultaat (`full`). `model_type` kan standard, lowpoly of smart-topology zijn en `target_polycount` loopt van 100 tot 300000, met smart topology begrensd op 15000. Er kunnen ook PBR-kanalen, een pose, humanoïde rigging en een animatievoorinstelling worden toegevoegd.

Parameters

NaamType StandaardToegestaan Beschrijving
promptverplicht
Typestring
≤ 600 tekens
Beschrijving van het object dat als 3D-model moet worden weergegeven, beperkt tot 600 tekens.
modeoptioneel
Typeenum
Standaardfull
previewfull
Generatiemodus: 'preview' levert geometrie zonder texturen, terwijl 'full' een getextureerd model levert door preview en refine te combineren.
seedoptioneel
Typeinteger | null
Gebruik deze seed samen met een ongewijzigde prompt om doorgaans een eerder resultaat opnieuw te produceren.
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 tijdens de geometrie- (preview-)stap 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.
should_remeshoptioneel
Typeboolean
Standaardtrue
Sla remeshing over en ontvang de ruwe driehoekige mesh door dit op false in te stellen; anders wordt de remeshfase ingeschakeld.
symmetry_modeoptioneel
Typeenum
Standaardauto
offautoon
Symmetrie-instelling die tijdens het genereren van het model wordt toegepast.
enable_pbroptioneel
Typeboolean
Standaardfalse
Bepaalt of naast de basiskleur PBR-kaarten voor metallic, roughness en normal worden gegenereerd.
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'.
enable_prompt_expansionoptioneel
Typeboolean
Standaardfalse
Laat een large language model de prompt verrijken met details. Deze uitbreiding verandert de betekenis van de prompt niet.
texture_promptoptioneel
Typestring | null
≤ 600 tekens
Stuur texturering aan met een extra tekstprompt in de modus 'full'; andere modi gebruiken deze niet.
texture_image_urloptioneel
Typeurl · image
2D-referentieafbeelding voor textuurgeneratie, alleen toegepast in de modus 'full'.
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.
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": "meshy/v6/text-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": 800,
    "usd": "0.80",
    "charged": 800,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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,
    "prompt": "A rustic, antique wooden treasure chest with a curved, domed lid, constructed from weathered, dark brown planks exhibiting prominent wood grain and subtle distress. It's heavily reinforced with broad, dark grey, oxidized metal bands secured by numerous circular rivets. Ornate, dark iron decorative elements featuring swirling foliate patterns and dragon motifs adorn the corners and lid. A prominent, circular, intricately carved metal lock plate with a central keyhole dominates the front, flanked by two large, dark metallic pull rings.",
    "actual_prompt": "string",
    "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 | nullSeedwaarde die tijdens de generatie wordt gebruikt.
prompt
stringTekstprompt die voor de generatie wordt aangeleverd.
actual_prompt
string | nullPrompt die daadwerkelijk voor de generatie is gebruikt toen promptuitbreiding was ingeschakeld.
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: Tekst naar 3D

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