Zum Inhalt springen

Meshy V7 Multi Image to 3D

Integrieren

Modell-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.com/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.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 Bild zu 3D #stylized#transform

Erstellt aus 1 bis 4 Ansichten desselben Objekts ein 3D-Modell mit Steuerungen für Polygonanzahl und Topologie

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 image_urls
Datei ablegen oder

Bildsatz für die 3D-Erstellung, unterstützt .jpg, .jpeg und .png sowie AVIF/HEIF mit automatischer Konvertierung. Übermittle 1 bis 4 Ansichten eines einzelnen Objekts aus verschiedenen Winkeln; Einträge nach den ersten 4 werden nicht verwendet.

geometry_resolution

Auflösung der Geometrie; 4k ist bei der Generierung aus mehreren Bildern nicht verfügbar.

Erweitert 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

Texturierungsanleitung als Text-Prompt; should_texture muss true sein.

Datei ablegen oder

Texturierungsanleitung als 2D-Bild; should_texture muss true sein.

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

Gewünschte Polygonanzahl für das Ausgabemodell.

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

POST /run/meshy/v7/multi-image-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/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.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 Multi Image to 3D

Rekonstruiert aus `image_urls` ein einzelnes Objekt; dabei werden ein bis vier Bilder aus verschiedenen Winkeln akzeptiert. Setzen Sie `topology` auf quad oder triangle und `target_polycount` auf einen Wert von 100 bis 300000, und wählen Sie standard oder 2k als `geometry_resolution`. Die Texturierung ist über `should_texture` optional; PBR-Karten, Posenmodus, Rigging und Animation sind verfügbar. Die Ausgabe enthält ein GLB und weitere Formate.

Parameter

Sende entweder den kanonischen Namen oder den nativen Namen, nicht beide. Kanonische Namen

NameTyp StandardZulässig Beschreibung
image_urlserforderlich images
Typurl[] · image
Bildsatz für die 3D-Erstellung, unterstützt .jpg, .jpeg und .png sowie AVIF/HEIF mit automatischer Konvertierung. Übermittle 1 bis 4 Ansichten eines einzelnen Objekts aus verschiedenen Winkeln; Einträge nach den ersten 4 werden nicht verwendet.
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
Gewünschte Polygonanzahl für das Ausgabemodell.
symmetry_modeoptional
Typenum
Standardauto
offautoon
Während der Modellerzeugung angewendete Symmetrieeinstellung.
should_remeshoptional
Typboolean
Standardtrue
Gibt an, ob die Remesh-Phase ausgeführt wird. false erzeugt ein Dreiecksmesh; topology und target_polycount werden anschließend ignoriert.
should_textureoptional
Typboolean
Standardtrue
Aktiviert oder deaktiviert die Texterzeugung.
enable_pbroptional
Typboolean
Standardfalse
Zusätzlicher PBR-Ausgabeschalter, nur verfügbar, wenn should_texture auf true gesetzt ist; fügt metallische, Rauheits- und Normalen-Maps neben der Basisfarbe hinzu.
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.
texture_promptoptional
Typstring | null
≤ 600 Zeichen
Texturierungsanleitung als Text-Prompt; should_texture muss true sein.
texture_image_urloptional
Typurl · image
Texturierungsanleitung als 2D-Bild; should_texture muss true sein.
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 Geometrie; 4k ist bei der Generierung aus mehreren Bildern nicht verfügbar.
erforderlich Kanonischer Name, ebenfalls akzeptiert

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/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.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 | nullGenerierungs-Seed, sofern verfügbar.
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: Bild zu 3D

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