Pereiti prie turinio

Meshy 6 · Image to 3D

Integruoti

Modelio id meshy/v6/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.ru/v1/run/meshy/v6/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

Gauti API raktą
Meshy Vaizdas į 3D #image-to-3d

Meshy 6 vaizdo vertimas į 3D su permodeliavimu, PBR žemėlapiais, pasirinktiniu humanoidiniu skeletavimu ir animacija

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_url
Įmeskite failą arba

Pateikite šaltinio vaizdą 3D kūrimui URL arba base64 duomenų URI formatu, naudodami .jpg, .jpeg, .png, AVIF arba HEIF. AVIF ir HEIF įvestys automatiškai konvertuojamos.

Išplėstiniai texture_prompt · texture_image_url · model_type · 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

Teksto instrukcijos, nukreipiančios tekstūrų generavimą.

Įmeskite failą arba

2D atraminis vaizdas, nukreipiantis tekstūrų generavimą.

model_type numatytoji standard

3D tinklelio režimas: pasirinkite 'lowpoly', jei reikia mažo poligonų skaičiaus rezultato, optimizuoto tvarkingesniems poligonams; šiame režime Meshy nepaiso topology, target_polycount ir should_remesh. Įprastam detaliam rezultatui pasirinkite 'standard', o 'smart-topology' – jei norite naudoti Meshy-T2 ir nuo pradžių gauti atskirai sugeneruotas tvarkingas dalis.

topology numatytoji triangle

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

symmetry_mode numatytoji auto

Pasirinkite, ar modelio generavimas priverstinai taiko simetriją su On, jos netaiko su Off, ar parenka automatiškai su Auto.

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

Tikslinis poligonų skaičius, apribotas iki 15,000, kai model_type yra 'smart-topology'. Šiame režime nenurodžius tikslo pasirenkamas mažesnis Meshy numatytasis dydis – 4,000.

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/v6/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.ru/v1/run/meshy/v6/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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.ru/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 6 · Image to 3D

Sukuria 3D modelį iš vieno vaizdo (`image_url`). `model_type` gali būti standard, lowpoly arba smart-topology, topologija – triangle arba quad, o `target_polycount` – nuo 100 iki 300000 (smart topology atveju daugiausia 15,000). Parinktys apima tekstūravimą, PBR žemėlapius, simetriją, A arba T pozą ir humanoidinį skeletavimą su animacijos išankstiniu nustatymu. Išvestyje pateikiami GLB ir FBX failai.

Parametrai

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

PavadinimasTipas Numatytoji reikšmėLeidžiama Aprašas
image_urlprivaloma image
Tipasurl · image
Pateikite šaltinio vaizdą 3D kūrimui URL arba base64 duomenų URI formatu, naudodami .jpg, .jpeg, .png, AVIF arba HEIF. AVIF ir HEIF įvestys automatiškai konvertuojamos.
model_typeneprivalomas
Tipasenum
Numatytoji reikšmėstandard
standardlowpolysmart-topology
3D tinklelio režimas: pasirinkite 'lowpoly', jei reikia mažo poligonų skaičiaus rezultato, optimizuoto tvarkingesniems poligonams; šiame režime Meshy nepaiso topology, target_polycount ir should_remesh. Įprastam detaliam rezultatui pasirinkite 'standard', o 'smart-topology' – jei norite naudoti Meshy-T2 ir nuo pradžių gauti atskirai sugeneruotas tvarkingas dalis.
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
Tikslinis poligonų skaičius, apribotas iki 15,000, kai model_type yra 'smart-topology'. Šiame režime nenurodžius tikslo pasirenkamas mažesnis Meshy numatytasis dydis – 4,000.
symmetry_modeneprivalomas
Tipasenum
Numatytoji reikšmėauto
offautoon
Pasirinkite, ar modelio generavimas priverstinai taiko simetriją su On, jos netaiko su Off, ar parenka automatiškai su Auto.
should_remeshneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Įjungia arba išjungia pakartotinio tinklelio kūrimo etapą.
should_textureneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Įjungia arba išjungia tekstūrų generavimą.
enable_pbrneprivalomas
Tipasboolean
Numatytoji reikšmėfalse
Kartu su pagrindine spalva prideda metalinio blizgesio, šiurkštumo ir normalės PBR ž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ų
Teksto instrukcijos, nukreipiančios tekstūrų generavimą.
texture_image_urlneprivalomas
Tipasurl · image
2D atraminis vaizdas, nukreipiantis tekstūrų generavimą.
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ą.
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/v6/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_url": "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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ų failų objektų masyvas, kurio struktūra atitinka Meshy API.
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/v6/image-to-3d.md. Visi modeliai ir vadovai: https://doitong.com/developers/llms.txt