Pereiti prie turinio

Meshy V7 Multi Image to 3D

Integruoti

Modelio 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"

Failai kaip pavyzdyje: 1,20 $ 1 200 API kreditų jūsų failai išmatuojami prieš paleidimą Paleisti šiame puslapyje

Gauti API raktą
Meshy Vaizdas į 3D #stylized#transform

Sukuria vieną 3D modelį iš 1–4 to paties objekto vaizdų, su poligonų ir topologijos valdikliais

Meshy · 3D

Čia bus pirmasis jūsų rezultatas

Sukurkite užklausą toliau ir paleiskite ją naudodami savo API raktą. Išvestys nukopijuojamos į mūsų saugyklą ir saugomos neribotą laiką arba 7 dienos nemokamai.

Sukurti užklausą

Valdikliai sugeneruojami pagal modelio schemą. Keisdami juos atnaujinsite kodą ir kainą.

•privaloma image_urls
Įmeskite failą arba

3D kūrimui skirtas vaizdų rinkinys: priimami .jpg, .jpeg, .png ir AVIF/HEIF su automatiniu konvertavimu. Pateikite nuo 1 iki 4 vieno objekto vaizdų iš skirtingų kampų; po pirmųjų 4 pateikti elementai nenaudojami.

geometry_resolution

Geometrijos raiška; 4k negalima generuojant iš kelių vaizdų.

Išplėstiniai 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

Tekstūrų gairės, pateiktos kaip tekstinis raginys; should_texture turi būti true.

Įmeskite failą arba

Tekstūrų gairės, pateiktos kaip 2D vaizdas; should_texture turi būti true.

topology numatytoji triangle

Modelio topologijos pasirinkimas: Triangle suteikia geometrinių detalių, o Quad – paviršiaus glotnumo.

symmetry_mode numatytoji auto

Generuojant modelį taikomas simetrijos nustatymas.

pose_mode numatytoji

Palikite eilutę tuščią, jei nenorite nurodyti sugeneruoto modelio pozos, arba prašykite A pozos naudodami 'a-pose', o T pozos – 't-pose'.

numatytoji 30000

Norimas išvesties modelio poligonų skaičius.

numatytoji 1.7

Pateikite numatomą veikėjo ūgį metrais, kai enable_rigging yra true; kitu atveju ši reikšmė neturi poveikio.

numatytoji 92

Meshy bibliotekos animacijos išankstinio nustatymo ID; galimi veiksmai pateikti adresu https://docs.meshy.ai/en/api/animation-library. Tikrinimas ir naudojimas taikomi tik kai enable_animation yra true: reikšmės už [0, 696] ribų atmetamos su 422, o "Idle" atitinka `0`.

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

Vykdyti šią užklausą

Jūsų raktas lieka šioje naršyklėje: jis siunčiamas tik į Doitong API ir išsaugomas (localStorage) tik pažymėjus Prisiminti. Gauti API raktą

Apie Meshy V7 Multi Image to 3D

Atkuria vieną objektą iš `image_urls`, kuriuose pateikiamos nuo vienos iki keturių jo nuotraukų iš skirtingų kampų. Nustatykite `topology` į quad arba triangle, `target_polycount` nuo 100 iki 300000 ir pasirinkite standard arba 2k `geometry_resolution`. Tekstūravimas pasirinktinis per `should_texture`; taip pat galimi PBR žemėlapiai, pozos režimas, skeletavimas ir animacija. Išvestyje pateikiamas GLB ir kiti formatai.

Parametrai

Siųskite arba kanoninį, arba savąjį pavadinimą, bet ne abu. Kanoniniai pavadinimai

PavadinimasTipas Numatytoji reikšmėLeidžiama Aprašas
image_urlsprivaloma images
Tipasurl[] · image
3D kūrimui skirtas vaizdų rinkinys: priimami .jpg, .jpeg, .png ir AVIF/HEIF su automatiniu konvertavimu. Pateikite nuo 1 iki 4 vieno objekto vaizdų iš skirtingų kampų; po pirmųjų 4 pateikti elementai nenaudojami.
topologyneprivalomas
Tipasenum
Numatytoji reikšmėtriangle
quadtriangle
Modelio topologijos pasirinkimas: Triangle suteikia geometrinių detalių, o Quad – paviršiaus glotnumo.
target_polycountneprivalomas
Tipasinteger
Numatytoji reikšmė30000
100 – 300 000
Norimas išvesties modelio poligonų skaičius.
symmetry_modeneprivalomas
Tipasenum
Numatytoji reikšmėauto
offautoon
Generuojant modelį taikomas simetrijos nustatymas.
should_remeshneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Nurodo, ar vykdyti pakartotinio tinklelio kūrimo etapą. Nustačius false gaunamas trikampis tinklelis; tuomet topology ir target_polycount nepaisomi.
should_textureneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Įjungia arba išjungia tekstūrų generavimą.
enable_pbrneprivalomas
Tipasboolean
Numatytoji reikšmėfalse
Papildoma PBR išvesties parinktis, galima tik kai should_texture nustatyta į true; kartu su pagrindine spalva prideda metalinio blizgesio, šiurkštumo ir normalės žemėlapius.
is_a_t_poseneprivalomas
Tipasboolean
Numatytoji reikšmėfalse
T pozos generavimo jungiklis, įjungiamas true; pasenęs ir pakeistas pose_mode.
pose_modeneprivalomas
Tipasenum
Numatytoji reikšmė
a-poset-pose
Palikite eilutę tuščią, jei nenorite nurodyti sugeneruoto modelio pozos, arba prašykite A pozos naudodami 'a-pose', o T pozos – 't-pose'.
texture_promptneprivalomas
Tipasstring | null
≤ 600 simbolių
Tekstūrų gairės, pateiktos kaip tekstinis raginys; should_texture turi būti true.
texture_image_urlneprivalomas
Tipasurl · image
Tekstūrų gairės, pateiktos kaip 2D vaizdas; should_texture turi būti true.
enable_riggingneprivalomas
Tipasboolean
Numatytoji reikšmėfalse
Automatinis humanoidų rigging, veiksmingiausias humanoidiniams modeliams su aiškiai atskiriamomis galūnėmis. Jį įjungus sugeneruotam modeliui pritaikomas rigging ir pateikiamos pagrindinės ėjimo bei bėgimo animacijos.
rigging_height_metersneprivalomas
Tipasnumber
Numatytoji reikšmė1.7
> 0
Pateikite numatomą veikėjo ūgį metrais, kai enable_rigging yra true; kitu atveju ši reikšmė neturi poveikio.
enable_animationneprivalomas
Tipasboolean
Numatytoji reikšmėfalse
Nurodo, ar animuotam modeliui suteikiama išankstinė animacija; tam enable_rigging turi būti true.
animation_action_idneprivalomas
Tipasinteger
Numatytoji reikšmė92
Meshy bibliotekos animacijos išankstinio nustatymo ID; galimi veiksmai pateikti adresu https://docs.meshy.ai/en/api/animation-library. Tikrinimas ir naudojimas taikomi tik kai enable_animation yra true: reikšmės už [0, 696] ribų atmetamos su 422, o "Idle" atitinka `0`.
enable_safety_checkerneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Išankstinio saugos tikrinimo jungiklis: true reiškia, kad prieš apdorojimą būtina patikrinti įvesties saugą.
geometry_resolutionneprivalomas
Tipasenum
standard2k
Geometrijos raiška; 4k negalima generuojant iš kelių vaizdų.
privaloma Kanoninis pavadinimas, taip pat priimamas

Failų parametrams reikia viešo https:// URL, ne didesnio nei 10 MB data: URI arba įkelto failo file_url. Failai

Išvestis

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"
  }
}
Jūsų failai — jūsų pasirinkimasKiekvienas outputs[].url yra kopija mūsų saugykloje: saugoma neribotą laiką (mokama už GB per mėnesį) arba 7 dienos nemokamai, pagal paskyros nustatymą arba ?storage=.
Ta pati struktūra kiekviename modelyjetype, url, content_type, width, height ir duration taikomi vaizdams, vaizdo įrašams ir garsui. output yra paties modelio rezultatų objektas.
Išvesties laukai
animation_glb
object {url, content_type, file_name, file_size} | nullAnimacijos rezultatas su 3D modeliu GLB formatu; atsakyme jis nepateikiamas, jei enable_animation nėra true.
animation_fbx
object {url, content_type, file_name, file_size} | nullAnimacijos rezultatas su 3D modeliu FBX formatu; atsakyme jis nepateikiamas, jei enable_animation nėra true.
model_glb
object {url, content_type, file_name, file_size}GLB failas su sugeneruotu 3D objektu.
thumbnail
object {url, content_type, file_name, file_size} | nullMiniatiūra, kurioje rodoma sugeneruoto modelio peržiūra.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Nuorodos į įvairių formatų 3D modelį.
texture_urls
array of object {base_color, metallic, normal, roughness}Tekstūrų failai, pateikiami kaip objektų masyvas.
seed
integer | nullGeneravimo pradžia, jei prieinama.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullRigging rezultatas, pateikiamas kaip GLB veikėjo failas; atsakyme jo nėra, jei enable_rigging nėra true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullRigging rezultatas, pateikiamas kaip FBX veikėjo failas; atsakyme jo nėra, jei enable_rigging nėra true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullPagrindinės ėjimo ir bėgimo animacijos, įtraukiamos tik kai enable_rigging yra true.
rig_task_id
string | nullRigging užduoties identifikatorius; įtraukiamas tik kai enable_rigging yra true.

Daugiau modelių: Vaizdas į 3D

AI agentams: šis puslapis Markdown formatu pateikiamas adresu https://doitong.com/lt/developers/models/meshy/v7/multi-image-to-3d.md. Visi modeliai ir vadovai: https://doitong.com/developers/llms.txt