Zum Inhalt springen

Meshy V7 Text to 3D

Integrieren

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"

Dateien wie das Beispiel: 1,20 $ 1.200 API-Credits Deine Dateien werden vor der Ausführung gemessen Auf dieser Seite ausführen

API-Schlüssel abrufen
Meshy Text zu 3D #stylized#transform

Text-zu-3D mit Meshy 7: Vorschau- oder Vollmodus, 2k-Geometrie sowie Optionen für PBR, Rigging und Animation

Meshy · 3D

Dein erstes Ergebnis erscheint hier

Erstelle unten eine Anfrage und führe sie mit deinem API-Schlüssel aus. Ausgaben werden in unseren Speicher kopiert und dauerhaft oder 7 Tage kostenlos aufbewahrt.

Anfrage erstellen

Die Steuerelemente werden aus dem Modellschema generiert. Code und Preis werden aktualisiert, während du sie änderst.

•erforderlich 88 / 600

Beschreibung des als 3D-Modell darzustellenden Objekts, auf 600 Zeichen begrenzt.

mode Standard full

Generierungsmodus: 'preview' gibt Geometrie ohne Texturen aus, während 'full' durch Kombination von preview und refine ein texturiertes Modell erzeugt.

geometry_resolution

Auflösung der Mesh-Geometrie; die unterstützten Meshy-7-Optionen sind standard und 2k.

Erweitert 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

Steuert die Texturierung im 'full'-Modus mit einem zusätzlichen Text-Prompt; andere Modi verwenden ihn nicht.

Datei ablegen oder

2D-Referenzbild für die Texterzeugung, nur im 'full'-Modus angewendet.

model_type Standard standard

3D-Mesh-Modus: Wähle 'lowpoly' für ein auf sauberere Polygone optimiertes Low-Poly-Ergebnis; in diesem Modus ignoriert Meshy topology, target_polycount und should_remesh. Für ein herkömmliches Ergebnis mit vielen Details wähle 'standard', oder wähle 'smart-topology', um Meshy-T2 während des Geometrieschritts (preview) zu verwenden und von Anfang an separat erzeugte, saubere Teile zu erhalten.

topology Standard triangle

Auswahl der Modelltopologie zwischen Triangle für geometrische Details und Quad für eine glatte Oberfläche.

symmetry_mode Standard auto

Während der Modellerzeugung angewendete Symmetrieeinstellung.

pose_mode Standard

Lass den String leer, um keine Pose für das generierte Modell anzugeben, oder fordere mit 'a-pose' eine A-Pose beziehungsweise mit 't-pose' eine T-Pose an.

Standard 30000

Zielanzahl der Polygone, bei model_type 'smart-topology' auf 15,000 begrenzt. Wird das Ziel in diesem Modus weggelassen, wird Meshys niedrigerer Standardwert von 4,000 verwendet.

Standard 1.7

Gib eine geschätzte Körpergröße des Charakters in Metern an, wenn enable_rigging true ist; andernfalls hat dieser Wert keine Wirkung.

Standard 92

ID des Animations-Presets aus der Meshy-Bibliothek; verfügbare Aktionen sind unter https://docs.meshy.ai/en/api/animation-library aufgeführt. Validierung und Verwendung gelten nur, wenn enable_animation true ist: Werte außerhalb von [0, 696] werden mit 422 abgelehnt, und "Idle" entspricht `0`.

Verwende diesen Seed zusammen mit einem unveränderten Prompt, um ein früheres Ergebnis in der Regel zu reproduzieren.

POST /run/meshy/v7/text-to-3d?wait=20 Preis → 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"

Diese Anfrage ausführen

Dein Schlüssel bleibt in diesem Browser: Er wird nur an die Doitong API gesendet und nur gespeichert (localStorage), wenn du „Merken“ aktivierst. API-Schlüssel abrufen

Über Meshy V7 Text to 3D

Generiert ein 3D-Modell aus einem `prompt` mit bis zu 600 Zeichen, optional mit `enable_prompt_expansion`. `mode` gibt entweder untexturierte Geometrie oder ein texturiertes Modell zurück. Wählen Sie über `model_type` standard, lowpoly oder smart-topology, setzen Sie `target_polycount` auf einen Wert von 100 bis 300000 und wählen Sie standard oder 2k als `geometry_resolution`. Für humanoide Charaktere können Rigging und Animationsvoreinstellungen hinzugefügt werden.

Parameter

NameTyp StandardZulässig Beschreibung
prompterforderlich
Typstring
≤ 600 Zeichen
Beschreibung des als 3D-Modell darzustellenden Objekts, auf 600 Zeichen begrenzt.
modeoptional
Typenum
Standardfull
previewfull
Generierungsmodus: 'preview' gibt Geometrie ohne Texturen aus, während 'full' durch Kombination von preview und refine ein texturiertes Modell erzeugt.
seedoptional
Typinteger | null
Verwende diesen Seed zusammen mit einem unveränderten Prompt, um ein früheres Ergebnis in der Regel zu reproduzieren.
model_typeoptional
Typenum
Standardstandard
standardlowpolysmart-topology
3D-Mesh-Modus: Wähle 'lowpoly' für ein auf sauberere Polygone optimiertes Low-Poly-Ergebnis; in diesem Modus ignoriert Meshy topology, target_polycount und should_remesh. Für ein herkömmliches Ergebnis mit vielen Details wähle 'standard', oder wähle 'smart-topology', um Meshy-T2 während des Geometrieschritts (preview) zu verwenden und von Anfang an separat erzeugte, saubere Teile zu erhalten.
topologyoptional
Typenum
Standardtriangle
quadtriangle
Auswahl der Modelltopologie zwischen Triangle für geometrische Details und Quad für eine glatte Oberfläche.
target_polycountoptional
Typinteger
Standard30000
100 – 300.000
Zielanzahl der Polygone, bei model_type 'smart-topology' auf 15,000 begrenzt. Wird das Ziel in diesem Modus weggelassen, wird Meshys niedrigerer Standardwert von 4,000 verwendet.
should_remeshoptional
Typboolean
Standardtrue
Überspringe das Remeshing und erhalte das rohe Dreiecksmesh, indem du false setzt; andernfalls wird die Remesh-Phase aktiviert.
symmetry_modeoptional
Typenum
Standardauto
offautoon
Während der Modellerzeugung angewendete Symmetrieeinstellung.
enable_pbroptional
Typboolean
Standardfalse
Steuert die Erzeugung von metallischen, Rauheits- und Normalen-PBR-Maps zusammen mit der Basisfarbe.
is_a_t_poseoptional
Typboolean
Standardfalse
Schalter für die T-Pose-Erzeugung, aktiviert durch true; zugunsten von pose_mode veraltet.
pose_modeoptional
Typenum
Standard
a-poset-pose
Lass den String leer, um keine Pose für das generierte Modell anzugeben, oder fordere mit 'a-pose' eine A-Pose beziehungsweise mit 't-pose' eine T-Pose an.
enable_prompt_expansionoptional
Typboolean
Standardfalse
Erlaubt einem großen Sprachmodell, den Prompt um Details zu erweitern. Diese Erweiterung lässt die Bedeutung des Prompts unverändert.
texture_promptoptional
Typstring | null
≤ 600 Zeichen
Steuert die Texturierung im 'full'-Modus mit einem zusätzlichen Text-Prompt; andere Modi verwenden ihn nicht.
texture_image_urloptional
Typurl · image
2D-Referenzbild für die Texterzeugung, nur im 'full'-Modus angewendet.
enable_riggingoptional
Typboolean
Standardfalse
Automatisches Humanoiden-Rigging, besonders geeignet für humanoide Modelle mit klar unterscheidbaren Gliedmaßen. Bei Aktivierung wird das generierte Modell geriggt und mit grundlegenden Geh- und Laufanimationen versehen.
rigging_height_metersoptional
Typnumber
Standard1.7
> 0
Gib eine geschätzte Körpergröße des Charakters in Metern an, wenn enable_rigging true ist; andernfalls hat dieser Wert keine Wirkung.
enable_animationoptional
Typboolean
Standardfalse
Gibt an, ob das geriggte Modell eine voreingestellte Animation erhält; dafür muss enable_rigging true sein.
animation_action_idoptional
Typinteger
Standard92
ID des Animations-Presets aus der Meshy-Bibliothek; verfügbare Aktionen sind unter https://docs.meshy.ai/en/api/animation-library aufgeführt. Validierung und Verwendung gelten nur, wenn enable_animation true ist: Werte außerhalb von [0, 696] werden mit 422 abgelehnt, und "Idle" entspricht `0`.
enable_safety_checkeroptional
Typboolean
Standardtrue
Schalter für die Sicherheitsprüfung vor der Verarbeitung: true macht eine Sicherheitsprüfung der Eingabe zur Voraussetzung für die Verarbeitung.
geometry_resolutionoptional
Typenum
standard2k
Auflösung der Mesh-Geometrie; die unterstützten Meshy-7-Optionen sind standard und 2k.
ultra_modeoptional
Typboolean
Standardfalse
Veraltete Option, ersetzt durch geometry_resolution, das bei Angabe beider Optionen Vorrang hat; verwende stattdessen geometry_resolution='2k'.
erforderlich

Dateiparameter akzeptieren eine öffentliche https://-URL, eine data:-URI bis 10 MB oder die file_url eines Uploads. Dateien

Ausgabe

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"
  }
}
Deine Dateien, deine EntscheidungJede outputs[].url ist eine Kopie in unserem Speicher: dauerhaft aufbewahrt (Abrechnung pro GB-Monat) oder 7 Tage kostenlos – je nach Kontoeinstellung oder ?storage=.
Gleiche Struktur bei jedem Modelltype, url, content_type, width, height und duration – für Bilder, Video und Audio gleichermaßen. output ist das Ergebnisobjekt des Modells.
Ausgabefelder
animation_glb
object {url, content_type, file_name, file_size} | nullAnimationsergebnis mit dem 3D-Modell als GLB; die Antwort lässt dieses Ergebnis weg, wenn enable_animation nicht true ist.
animation_fbx
object {url, content_type, file_name, file_size} | nullAnimationsergebnis mit dem 3D-Modell als FBX; die Antwort lässt dieses Ergebnis weg, wenn enable_animation nicht true ist.
model_glb
object {url, content_type, file_name, file_size}GLB-Datei mit dem generierten 3D-Objekt.
thumbnail
object {url, content_type, file_name, file_size} | nullMiniaturansicht als Vorschau des generierten Modells.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Links zum 3D-Modell in verschiedenen Formaten.
texture_urls
array of object {base_color, metallic, normal, roughness}Als Array von Objekten dargestellte Texturdateien.
seed
integer | nullWährend der Generierung verwendeter Seed-Wert.
prompt
stringFür die Generierung übergebener Text-Prompt.
actual_prompt
string | nullBei aktivierter Prompt-Erweiterung tatsächlich auf die Generierung angewendeter Prompt.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullRigging-Ergebnis als GLB-Charakterdatei; fehlt in der Antwort, wenn enable_rigging nicht true ist.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullRigging-Ergebnis als FBX-Charakterdatei; fehlt in der Antwort, wenn enable_rigging nicht true ist.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullGrundlegende Geh- und Laufanimationen, nur enthalten, wenn enable_rigging true ist.
rig_task_id
string | nullBezeichner der Rigging-Aufgabe; nur enthalten, wenn enable_rigging true ist.

Weitere Modelle: Text zu 3D

Für KI-Agenten: Diese Seite ist als Markdown verfügbar unter https://doitong.com/de/developers/models/meshy/v7/text-to-3d.md. Alle Modelle und Anleitungen: https://doitong.com/developers/llms.txt