Preskoči na vsebino

Meshy 6 · Image to 3D

Integracija

ID modela 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"

Datoteke, kot je primer: 1,20 $ 1200 API kreditov · ≈ 129,10 ₽ vaše datoteke se izmerijo pred zagonom Zaženi na tej strani

Pridobi ključ API
Meshy Slika v 3D #image-to-3d

Meshy 6 za pretvorbo slike v 3D z vnovičnim izrisom mreže, PBR-zemljevidi ter neobveznim humanoidnim skeletom in animacijo

Meshy · 3D

Tukaj bo vaš prvi rezultat

Spodaj sestavite zahtevo in jo zaženite s svojim ključem API. Izhodi se kopirajo v našo shrambo, kjer se hranijo za vedno ali 7 dni brezplačno.

Ustvari zahtevo

Kontrolniki se ustvarijo iz sheme modela. Koda in cena se posodobita, ko ju spreminjate.

•obvezno image_url
Spustite datoteko ali

Izvorno sliko za ustvarjanje 3D-predmeta podajte kot URL ali podatkovni URI base64; podprti so .jpg, .jpeg, .png, AVIF in HEIF. Samodejna pretvorba obdela vhode AVIF in HEIF.

Napredno 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

Besedilna navodila za generiranje tekstur.

Spustite datoteko ali

2D-referenčna slika za usmerjanje generiranja tekstur.

model_type privzeto standard

Način 3D-mreže: izberite 'lowpoly' za rezultat z malo poligoni, optimiziran za čistejše poligone; v tem načinu Meshy prezre topology, target_polycount in should_remesh. Za običajen rezultat z veliko podrobnostmi izberite 'standard' ali 'smart-topology' za uporabo Meshy-T2 in čiste dele, ustvarjene ločeno že od začetka.

topology privzeto triangle

Izbira topologije modela med Triangle za geometrijske podrobnosti in Quad za gladkost površine.

symmetry_mode privzeto auto

Izberite, ali generiranje modela vsili simetrijo z On, jo izpusti z Off ali odloči samodejno z Auto.

pose_mode privzeto

Pustite niz prazen, če ne želite določiti poze ustvarjenega modela, ali zahtevajte pozo A z 'a-pose' oziroma pozo T s 't-pose'.

privzeto 30000

Ciljno število poligonov, omejeno na 15,000, ko je model_type 'smart-topology'. Če cilj v tem načinu izpustite, se izbere Meshyjeva nižja privzeta vrednost 4,000.

privzeto 1.7

Podajte ocenjeno višino značaja v metrih, ko je enable_rigging true; sicer ta vrednost nima učinka.

privzeto 92

ID prednastavitve animacije knjižnice Meshy; razpoložljiva dejanja so navedena na https://docs.meshy.ai/en/api/animation-library. Preverjanje in uporaba veljata samo, če je enable_animation true: vrednosti zunaj [0, 696] se zavrnejo z 422, "Idle" pa ustreza `0`.

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

Zaženi to zahtevo

Vaš ključ ostane v tem brskalniku: pošlje se samo v Doitong API in shrani v localStorage samo, če označite možnost Zapomni si. Pridobi ključ API

O modelu Meshy 6 · Image to 3D

Iz ene slike (`image_url`) ustvari 3D-model. `model_type` je standard, lowpoly ali smart-topology, topologija je trikotna ali štirikotna, `target_polycount` pa od 100 do 300000 (smart topology največ 15,000). Možnosti vključujejo teksturiranje, PBR-zemljevide, simetrijo, pozo A ali T ter humanoidni skelet s prednastavitvijo animacije. Izhod vključuje datoteki GLB in FBX.

Parametri

Pošlji kanonično ali izvorno ime, ne obeh. Kanonična imena

ImeVrsta PrivzetoDovoljeno Opis
image_urlobvezno image
Vrstaurl · image
Izvorno sliko za ustvarjanje 3D-predmeta podajte kot URL ali podatkovni URI base64; podprti so .jpg, .jpeg, .png, AVIF in HEIF. Samodejna pretvorba obdela vhode AVIF in HEIF.
model_typeneobvezno
Vrstaenum
Privzetostandard
standardlowpolysmart-topology
Način 3D-mreže: izberite 'lowpoly' za rezultat z malo poligoni, optimiziran za čistejše poligone; v tem načinu Meshy prezre topology, target_polycount in should_remesh. Za običajen rezultat z veliko podrobnostmi izberite 'standard' ali 'smart-topology' za uporabo Meshy-T2 in čiste dele, ustvarjene ločeno že od začetka.
topologyneobvezno
Vrstaenum
Privzetotriangle
quadtriangle
Izbira topologije modela med Triangle za geometrijske podrobnosti in Quad za gladkost površine.
target_polycountneobvezno
Vrstainteger
Privzeto30000
100 – 300.000
Ciljno število poligonov, omejeno na 15,000, ko je model_type 'smart-topology'. Če cilj v tem načinu izpustite, se izbere Meshyjeva nižja privzeta vrednost 4,000.
symmetry_modeneobvezno
Vrstaenum
Privzetoauto
offautoon
Izberite, ali generiranje modela vsili simetrijo z On, jo izpusti z Off ali odloči samodejno z Auto.
should_remeshneobvezno
Vrstaboolean
Privzetotrue
Omogoči ali onemogoči fazo ponovnega mreženja.
should_textureneobvezno
Vrstaboolean
Privzetotrue
Omogoči ali onemogoči generiranje tekstur.
enable_pbrneobvezno
Vrstaboolean
Privzetofalse
Poleg osnovne barve doda PBR-zemljevide kovinskosti, hrapavosti in normal.
is_a_t_poseneobvezno
Vrstaboolean
Privzetofalse
Stikalo za generiranje v pozi T, aktivirano z true; zastarelo v korist pose_mode.
pose_modeneobvezno
Vrstaenum
Privzeto
a-poset-pose
Pustite niz prazen, če ne želite določiti poze ustvarjenega modela, ali zahtevajte pozo A z 'a-pose' oziroma pozo T s 't-pose'.
texture_promptneobvezno
Vrstastring | null
≤ 600 znakov
Besedilna navodila za generiranje tekstur.
texture_image_urlneobvezno
Vrstaurl · image
2D-referenčna slika za usmerjanje generiranja tekstur.
enable_riggingneobvezno
Vrstaboolean
Privzetofalse
Samodejno humanoidno opremljanje, najučinkovitejše pri humanoidnih modelih z jasno razločljivimi okončinami. Če ga omogočite, se ustvarjeni model opremi in dodata se osnovni animaciji hoje in teka.
rigging_height_metersneobvezno
Vrstanumber
Privzeto1.7
> 0
Podajte ocenjeno višino značaja v metrih, ko je enable_rigging true; sicer ta vrednost nima učinka.
enable_animationneobvezno
Vrstaboolean
Privzetofalse
Določa, ali opremljeni model prejme prednastavljeno animacijo; zanjo mora biti enable_rigging true.
animation_action_idneobvezno
Vrstainteger
Privzeto92
ID prednastavitve animacije knjižnice Meshy; razpoložljiva dejanja so navedena na https://docs.meshy.ai/en/api/animation-library. Preverjanje in uporaba veljata samo, če je enable_animation true: vrednosti zunaj [0, 696] se zavrnejo z 422, "Idle" pa ustreza `0`.
enable_safety_checkerneobvezno
Vrstaboolean
Privzetotrue
Stikalo za varnostno preverjanje predobdelave: true pomeni, da je varnostno preverjanje vhoda predpogoj za obdelavo.
obvezno Kanonično ime, prav tako sprejeto

Parametri datotek sprejmejo javni https:// URL, podatkovni URI data: do 10 MB ali file_url naložene datoteke. Datoteke

Izhod

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"
  }
}
Vaše datoteke, vaša izbiraVsak outputs[].url je kopija v naši shrambi: hrani se za vedno (plačilo na GB-mesec) ali 7 dni brezplačno, glede na nastavitev računa ali ?storage=.
Enaka struktura pri vsakem modelutype, url, content_type, width, height in duration za slike, videoposnetke in zvok. output je lasten objekt rezultata modela.
Polja izhoda
animation_glb
object {url, content_type, file_name, file_size} | nullRezultat animacije, ki vsebuje 3D-model kot GLB; odgovor ga izpusti, razen če je enable_animation true.
animation_fbx
object {url, content_type, file_name, file_size} | nullRezultat animacije, ki vsebuje 3D-model kot FBX; odgovor ga izpusti, razen če je enable_animation true.
model_glb
object {url, content_type, file_name, file_size}Datoteka GLB z ustvarjenim 3D-objektom.
thumbnail
object {url, content_type, file_name, file_size} | nullSličica s predogledom ustvarjenega modela.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Povezave do 3D-modela v različnih oblikah.
texture_urls
array of object {base_color, metallic, normal, roughness}Objekti datotek tekstur v polju, strukturiranem skladno z Meshy API.
seed
integer | nullSeme generiranja, če je na voljo.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullRezultat opremljanja, vrnjen kot datoteka značaja GLB; v odgovoru manjka, razen če je enable_rigging true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullRezultat opremljanja, vrnjen kot datoteka značaja FBX; v odgovoru manjka, razen če je enable_rigging true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullOsnovni animaciji hoje in teka, vključeni samo, če je enable_rigging true.
rig_task_id
string | nullIdentifikator opravila opremljanja; vključen samo, če je enable_rigging true.

Več modelov: Slika v 3D

Za agente AI: ta stran je v obliki Markdown na voljo na https://doitong.com/sl/developers/models/meshy/v6/image-to-3d.md. Vsi modeli in vodniki: https://doitong.com/developers/llms.txt