Op den Inhalt sprangen

Meshy V7 Text to 3D

Integréieren

Modell-ID meshy/v7/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.com/v1/run/meshy/v7/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Dateie wéi am Beispill: 1,20 $ 1.200 API-Kreditter Är Dateie gi virun der Ausféierung gemooss Op dëser Säit ausféieren

API-Schlëssel kréien
Meshy Text zu 3D #stylized#transform

Text-zu-3D mat Meshy 7: Preview- oder Vollmodus, 2k-Geometrie, PBR-, Rigging- an Animatiounsoptiounen

Meshy · 3D

Äin éischt Resultat kënnt hei hin

Baut hei drënner eng Ufro a féiert se mat Ärem API-Schlëssel aus. Output gëtt an eis Späicherung kopéiert, fir ëmmer oder 7 Deeg gratis gespäichert.

Eng Ufro erstellen

D'Kontrolle ginn aus dem Modellschema generéiert. De Code an de Präis aktualiséiere sech, wann s du se ännerst.

•obligatoresch 88 / 600

Beschreiwung vum Objet, deen als 3D-Modell duergestallt soll ginn, limitéiert op 600 Zeechen.

mode Standard full

Generatiounsmodus: 'preview' liwwert Geometrie ouni Texturen, wärend 'full' e texturéierte Modell duerch d'Kombinatioun vu preview a refine liwwert.

geometry_resolution

Opléisung vun der Mesh-Geometrie; déi ënnerstëtzt Meshy-7-Optioune sinn standard an 2k.

Erweidert texture_prompt · texture_image_url · 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_safety_checker · ultra_mode
0 / 600

Texturéierung mat engem zousätzleche Text-Prompt am 'full'-Modus; aner Modi benotzen en net.

Fichier erofzéien, oder

2D-Referenzbild fir d'Texturgeneratioun, nëmmen am 'full'-Modus applizéiert.

model_type Standard standard

3D-Mesh-Modus: wielt 'lowpoly' fir e Low-Poly-Resultat mat méi propperen Polygonen; an dësem Modus ignoréiert Meshy topology, target_polycount a should_remesh. Fir e konventionellt héich detailléiert Resultat wielt 'standard', oder 'smart-topology' fir Meshy-T2 wärend dem Geometrieschrëtt (preview) ze benotzen an direkt separat generéiert propper Deeler ze kréien.

topology Standard triangle

Auswiel vun der Modelltopologie tëscht Triangle fir geometreschen Detail an Quad fir glat Uewerflächen.

symmetry_mode Standard auto

Symmetrie-Astellung, déi bei der Modellgeneratioun applizéiert gëtt.

pose_mode Standard

Loosst de String eidel, fir d'Pose vum generéierte Modell net unzeginn, oder frot eng A-Pose mat 'a-pose' respektiv eng T-Pose mat 't-pose' un.

Standard 30000

Zilzuel vu Polygonen, begrenzt op 15,000 wann model_type 'smart-topology' ass. Wann d'Zil an dësem Modus ewechgelooss gëtt, gëtt Meshy säin nidderege Standard vun 4,000 benotzt.

Standard 1.7

Gitt eng geschätzte Charakterhéicht a Meter un, wann enable_rigging true ass; soss huet dëse Wäert keen Effekt.

Standard 92

ID vun enger Animatioun aus der Meshy-Bibliothéik; verfügbar Aktiounen stinn op https://docs.meshy.ai/en/api/animation-library. Validatioun a Gebrauch gëllen nëmme wann enable_animation true ass: Wäerter ausserhalb [0, 696] ginn mat engem 422 zeréckgewisen, an "Idle" entsprécht `0`.

Benotzt dës Seed zesumme mat engem onverännerten Prompt, fir normalerweis e fréiert Resultat ze reproduzéieren.

POST /run/meshy/v7/text-to-3d?wait=20 Präis → 1,20 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/meshy/v7/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Dës Ufro ausféieren

Äre Schlëssel bleift an dësem Browser: e gëtt nëmmen un d'Doitong API geschéckt an nëmme gespäichert (localStorage), wann s du „Erënneren“ aktivéiers. En API-Schlëssel kréien

Iwwer Meshy V7 Text to 3D

Generéiert en 3D-Modell aus engem `prompt` vu bis zu 600 Zeechen, mat optionaler `enable_prompt_expansion`. `mode` gëtt entweder ontexturéiert Geometrie oder e texturéierte Modell zeréck. Wielt standard, lowpoly oder smart-topology iwwer `model_type`, setzt `target_polycount` vun 100 bis 300000 a wielt standard oder 2k `geometry_resolution`. Rigging an Animatiounspresets kënnen humanoide Charakteren dobäigesat ginn.

Parameteren

NummTyp StandardErlaabt Beschreiwung
promptobligatoresch
Typstring
≤ 600 Zeechen
Beschreiwung vum Objet, deen als 3D-Modell duergestallt soll ginn, limitéiert op 600 Zeechen.
modeoptional
Typenum
Standardfull
previewfull
Generatiounsmodus: 'preview' liwwert Geometrie ouni Texturen, wärend 'full' e texturéierte Modell duerch d'Kombinatioun vu preview a refine liwwert.
seedoptional
Typinteger | null
Benotzt dës Seed zesumme mat engem onverännerten Prompt, fir normalerweis e fréiert Resultat ze reproduzéieren.
model_typeoptional
Typenum
Standardstandard
standardlowpolysmart-topology
3D-Mesh-Modus: wielt 'lowpoly' fir e Low-Poly-Resultat mat méi propperen Polygonen; an dësem Modus ignoréiert Meshy topology, target_polycount a should_remesh. Fir e konventionellt héich detailléiert Resultat wielt 'standard', oder 'smart-topology' fir Meshy-T2 wärend dem Geometrieschrëtt (preview) ze benotzen an direkt separat generéiert propper Deeler ze kréien.
topologyoptional
Typenum
Standardtriangle
quadtriangle
Auswiel vun der Modelltopologie tëscht Triangle fir geometreschen Detail an Quad fir glat Uewerflächen.
target_polycountoptional
Typinteger
Standard30000
100 – 300.000
Zilzuel vu Polygonen, begrenzt op 15,000 wann model_type 'smart-topology' ass. Wann d'Zil an dësem Modus ewechgelooss gëtt, gëtt Meshy säin nidderege Standard vun 4,000 benotzt.
should_remeshoptional
Typboolean
Standardtrue
Iwwerspréngt Remeshing a kritt de rohe trianguläre Mesh, andeems dëst op false gesat gëtt; soss gëtt d'Remesh-Phase aktivéiert.
symmetry_modeoptional
Typenum
Standardauto
offautoon
Symmetrie-Astellung, déi bei der Modellgeneratioun applizéiert gëtt.
enable_pbroptional
Typboolean
Standardfalse
Bestëmmt, ob metallesch, rau an normal PBR-Maps nieft der Basisfaarf generéiert ginn.
is_a_t_poseoptional
Typboolean
Standardfalse
T-Pose-Generatiounsschalter, aktivéiert mat true; ofgeschaaft zugonschte vu pose_mode.
pose_modeoptional
Typenum
Standard
a-poset-pose
Loosst de String eidel, fir d'Pose vum generéierte Modell net unzeginn, oder frot eng A-Pose mat 'a-pose' respektiv eng T-Pose mat 't-pose' un.
enable_prompt_expansionoptional
Typboolean
Standardfalse
Erlaabt engem Large Language Modell, de Prompt mat Detailer unzereecheren. Dës Erweiderung léisst d'Bedeitung vum Prompt onverännert.
texture_promptoptional
Typstring | null
≤ 600 Zeechen
Texturéierung mat engem zousätzleche Text-Prompt am 'full'-Modus; aner Modi benotzen en net.
texture_image_urloptional
Typurl · image
2D-Referenzbild fir d'Texturgeneratioun, nëmmen am 'full'-Modus applizéiert.
enable_riggingoptional
Typboolean
Standardfalse
Automatescht humanoidt Rigging, am effektivste fir humanoid Modeller mat kloer ënnerscheedbare Glidder. D'Aktivéierung riggt de generéierte Modell a liwwert Basis-Animatioune fir Goe a Lafen.
rigging_height_metersoptional
Typnumber
Standard1.7
> 0
Gitt eng geschätzte Charakterhéicht a Meter un, wann enable_rigging true ass; soss huet dëse Wäert keen Effekt.
enable_animationoptional
Typboolean
Standardfalse
Ob de geriggte Modell eng Preset-Animatioun kritt; dofir muss enable_rigging true sinn.
animation_action_idoptional
Typinteger
Standard92
ID vun enger Animatioun aus der Meshy-Bibliothéik; verfügbar Aktiounen stinn op https://docs.meshy.ai/en/api/animation-library. Validatioun a Gebrauch gëllen nëmme wann enable_animation true ass: Wäerter ausserhalb [0, 696] ginn mat engem 422 zeréckgewisen, an "Idle" entsprécht `0`.
enable_safety_checkeroptional
Typboolean
Standardtrue
Sécherheetskontroll virun der Veraarbechtung: true mécht eng Input-Sécherheetskontroll zur Viraussetzung fir d'Veraarbechtung.
geometry_resolutionoptional
Typenum
standard2k
Opléisung vun der Mesh-Geometrie; déi ënnerstëtzt Meshy-7-Optioune sinn standard an 2k.
ultra_modeoptional
Typboolean
Standardfalse
Ofgeschaaft Optioun, ersat duerch geometry_resolution, wat gewënnt, wann allebéid geliwwert ginn; benotzt amplaz geometry_resolution='2k'.
obligatoresch

Fichierparameter akzeptéieren eng ëffentlech https:// URL, eng data: URI bis zu 10 MB oder de file_url vun engem Upload. Fichieren

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/v7/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": 1200,
    "usd": "1.20",
    "charged": 1200,
    "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Är Fichieren, Är WielAll outputs[].url ass eng Kopie an eiser Späicherung: fir ëmmer gespäichert (bezuelbar pro GB-Mount) oder 7 Deeg gratis, jee no Ärer Kontastellung oder ?storage=.
D'selwecht Struktur bei all Modelltype, url, content_type, width, height an duration, fir Biller, Video an Audio gläichermoossen. output ass dem Modell säin eegent Resultatobjet.
Output-Felder
animation_glb
object {url, content_type, file_name, file_size} | nullAnimatiounsresultat mam 3D-Modell als GLB; d'Respons léisst dëst Resultat ewech, ausser enable_animation ass true.
animation_fbx
object {url, content_type, file_name, file_size} | nullAnimatiounsresultat mam 3D-Modell als FBX; d'Respons léisst dëst Resultat ewech, ausser enable_animation ass true.
model_glb
object {url, content_type, file_name, file_size}GLB-Datei mat dem generéierten 3D-Objet.
thumbnail
object {url, content_type, file_name, file_size} | nullThumbnail mat enger Virschau vum generéierte Modell.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Linken op den 3D-Modell a verschiddene Formater.
texture_urls
array of object {base_color, metallic, normal, roughness}Texturdateien, representéiert als Array vun Objeten.
seed
integer | nullSeed-Wäert, dee während der Generatioun benotzt gëtt.
prompt
stringText-Prompt fir d'Generatioun.
actual_prompt
string | nullPrompt, deen tatsächlech fir d'Generatioun applizéiert gouf, wann d'Prompt-Erweiderung aktivéiert war.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullRigging-Resultat als GLB-Charakterdatei; feelt an der Respons, ausser enable_rigging ass true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullRigging-Resultat als FBX-Charakterdatei; feelt an der Respons, ausser enable_rigging ass true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullBasis-Animatioune fir Goe a Lafen, nëmme matgeléiert wann enable_rigging true ass.
rig_task_id
string | nullIdentifikator vun der Rigging-Aufgab; nëmme matgeléiert wann enable_rigging true ass.

Méi Modeller: Text zu 3D

Fir AI-Agenten: dës Säit als Markdown ass ënner https://doitong.com/lb/developers/models/meshy/v7/text-to-3d.md. All Modeller a Guiden: https://doitong.com/developers/llms.txt