Siirry sisältöön

Meshy V7 Image to 3D

Integroi

Mallin tunniste meshy/v7/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/v7/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"

Esimerkin kaltaiset tiedostot: 1,20 $ 1 200 API-krediittiä · ≈ 129,10 ₽ tiedostosi mitataan ennen suorittamista Suorita tällä sivulla

Hanki API-avain
Meshy Kuvasta 3D:ksi #stylized#transform

Muuntaa yhden kuvan 3D-malliksi ja tarjoaa 2k-geometriavaihtoehdon sekä valinnaiset PBR-, luustotus- ja animaatioasetukset

Meshy · 3D

Ensimmäinen tuloksesi tulee tähän

Muodosta pyyntö alla ja suorita se API-avaimellasi. Tulosteet kopioidaan tallennustilaamme, jossa ne säilytetään ikuisesti tai 7 päivää ilmaiseksi.

Muodosta pyyntö

Säätimet luodaan mallin skeemasta. Koodi ja hinta päivittyvät, kun muutat arvoja.

•pakollinen image_url
Pudota tiedosto tai

Anna 3D-luontia varten lähdekuva URL-osoitteena tai base64-data-URI-osoitteena; tuettuja ovat .jpg, .jpeg, .png, AVIF ja HEIF. AVIF- ja HEIF-syötteet muunnetaan automaattisesti.

geometry_resolution

Verkon geometrian resoluutio; tuetut Meshy-7-vaihtoehdot ovat standard ja 2k.

Lisäasetukset 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 · ultra_mode
0 / 600

Tekstiohjeet, jotka ohjaavat tekstuurien generointia.

Pudota tiedosto tai

Tekstuurien generointia ohjaava 2D-viitekuva.

model_type oletus standard

3D-verkon tila: valitse 'lowpoly' puhtaampiin polygoneihin optimoitua low-poly-tulosta varten; tässä tilassa Meshy ohittaa topologian, target_polycount-arvon ja should_remesh-arvon. Tavanomaiseen tarkkaan tulokseen valitse 'standard' tai valitse 'smart-topology', jolloin Meshy-T2 tuottaa puhtaat osat alusta alkaen erikseen.

topology oletus triangle

Mallin topologiavalinta: Triangle geometriseen yksityiskohtaisuuteen tai Quad pinnan tasaisuuteen.

symmetry_mode oletus auto

Valitse, pakotetaanko mallin generoinnissa symmetria tilalla On, jätetäänkö se pois tilalla Off vai päätetäänkö automaattisesti tilalla Auto.

pose_mode oletus

Jätä merkkijono tyhjäksi, jos et halua määrittää generoidun mallin asentoa, tai pyydä A-asentoa arvolla 'a-pose' tai T-asentoa arvolla 't-pose'.

oletus 30000

Polygonimäärän tavoite, joka rajoitetaan arvoon 15,000, kun model_type on 'smart-topology'. Jos tavoite jätetään tässä tilassa pois, Meshyn pienempi oletus on 4,000.

oletus 1.7

Anna hahmon arvioitu korkeus metreinä, kun enable_rigging on true; muuten arvolla ei ole vaikutusta.

oletus 92

Meshy-kirjaston animaation esiasetustunnus; käytettävissä olevat toiminnot on lueteltu osoitteessa https://docs.meshy.ai/en/api/animation-library. Kelpoisuuden tarkistus ja käyttö koskevat vain tilannetta, jossa enable_animation on true: alueen [0, 696] ulkopuoliset arvot hylätään vastauksella 422, ja "Idle" vastaa arvoa `0`.

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

Suorita tämä pyyntö

Avaimesi säilyy tässä selaimessa: se lähetetään vain Doitong APIlle ja tallennetaan localStorageen vain, jos valitset Muista. Hanki API-avain

Tietoja: Meshy V7 Image to 3D

Luo 3D-mallin yhdestä `image_url`-kentän kuvasta (JPG, PNG, AVIF tai HEIF). `model_type` valitsee arvon standard, lowpoly tai smart-topology, ja `target_polycount` hyväksyy arvot 100–300000. `geometry_resolution` tarjoaa vaihtoehdot standard ja 2k. Teksturoinnin voi poistaa käytöstä `should_texture`-asetuksella, ja PBR-kartat, pose-tila, humanoidin luustotus ja animaatioesiasetus ovat valinnaisia.

Parametrit

Lähetä joko kanoninen nimi tai natiivi nimi, älä molempia. Kanoniset nimet

NimiTyyppi OletusSallitut Kuvaus
image_urlpakollinen image
Tyyppiurl · image
Anna 3D-luontia varten lähdekuva URL-osoitteena tai base64-data-URI-osoitteena; tuettuja ovat .jpg, .jpeg, .png, AVIF ja HEIF. AVIF- ja HEIF-syötteet muunnetaan automaattisesti.
model_typevalinnainen
Tyyppienum
Oletusstandard
standardlowpolysmart-topology
3D-verkon tila: valitse 'lowpoly' puhtaampiin polygoneihin optimoitua low-poly-tulosta varten; tässä tilassa Meshy ohittaa topologian, target_polycount-arvon ja should_remesh-arvon. Tavanomaiseen tarkkaan tulokseen valitse 'standard' tai valitse 'smart-topology', jolloin Meshy-T2 tuottaa puhtaat osat alusta alkaen erikseen.
topologyvalinnainen
Tyyppienum
Oletustriangle
quadtriangle
Mallin topologiavalinta: Triangle geometriseen yksityiskohtaisuuteen tai Quad pinnan tasaisuuteen.
target_polycountvalinnainen
Tyyppiinteger
Oletus30000
100 – 300 000
Polygonimäärän tavoite, joka rajoitetaan arvoon 15,000, kun model_type on 'smart-topology'. Jos tavoite jätetään tässä tilassa pois, Meshyn pienempi oletus on 4,000.
symmetry_modevalinnainen
Tyyppienum
Oletusauto
offautoon
Valitse, pakotetaanko mallin generoinnissa symmetria tilalla On, jätetäänkö se pois tilalla Off vai päätetäänkö automaattisesti tilalla Auto.
should_remeshvalinnainen
Tyyppiboolean
Oletustrue
Ottaa uudelleenverkotuksen käyttöön tai poistaa sen käytöstä.
should_texturevalinnainen
Tyyppiboolean
Oletustrue
Ottaa tekstuurien generoinnin käyttöön tai poistaa sen käytöstä.
enable_pbrvalinnainen
Tyyppiboolean
Oletusfalse
Lisää perusvärin ohella metallisuus-, karheus- ja normaalit PBR-kartat.
is_a_t_posevalinnainen
Tyyppiboolean
Oletusfalse
true-arvolla aktivoitava T-asennon generointikytkin; vanhentunut pose_mode-asetuksen hyväksi.
pose_modevalinnainen
Tyyppienum
Oletus
a-poset-pose
Jätä merkkijono tyhjäksi, jos et halua määrittää generoidun mallin asentoa, tai pyydä A-asentoa arvolla 'a-pose' tai T-asentoa arvolla 't-pose'.
texture_promptvalinnainen
Tyyppistring | null
≤ 600 merkkiä
Tekstiohjeet, jotka ohjaavat tekstuurien generointia.
texture_image_urlvalinnainen
Tyyppiurl · image
Tekstuurien generointia ohjaava 2D-viitekuva.
enable_riggingvalinnainen
Tyyppiboolean
Oletusfalse
Automaattinen humanoidin riggaus, joka toimii parhaiten malleilla, joiden raajat erottuvat selkeästi. Käyttöönotto rigaa generoidun mallin ja toimittaa perusanimaatiot kävelyä ja juoksua varten.
rigging_height_metersvalinnainen
Tyyppinumber
Oletus1.7
> 0
Anna hahmon arvioitu korkeus metreinä, kun enable_rigging on true; muuten arvolla ei ole vaikutusta.
enable_animationvalinnainen
Tyyppiboolean
Oletusfalse
Määrittää, saako rigattu malli esiasetetun animaation; tämä edellyttää, että enable_rigging on true.
animation_action_idvalinnainen
Tyyppiinteger
Oletus92
Meshy-kirjaston animaation esiasetustunnus; käytettävissä olevat toiminnot on lueteltu osoitteessa https://docs.meshy.ai/en/api/animation-library. Kelpoisuuden tarkistus ja käyttö koskevat vain tilannetta, jossa enable_animation on true: alueen [0, 696] ulkopuoliset arvot hylätään vastauksella 422, ja "Idle" vastaa arvoa `0`.
enable_safety_checkervalinnainen
Tyyppiboolean
Oletustrue
Esikäsittelyn turvatarkistuksen kytkin: true tekee syötteen turvatarkistuksesta käsittelyn edellytyksen.
geometry_resolutionvalinnainen
Tyyppienum
standard2k
Verkon geometrian resoluutio; tuetut Meshy-7-vaihtoehdot ovat standard ja 2k.
ultra_modevalinnainen
Tyyppiboolean
Oletusfalse
Vanhentunut asetus, jonka geometry_resolution korvaa, jos molemmat annetaan; käytä sen sijaan geometry_resolution='2k'.
pakollinen Kanoninen nimi, myös hyväksytty

Tiedostoparametrit hyväksyvät julkisen https://-URL:n, enintään 10 MB:n data:-URI:n tai lähetyksen file_url-arvon. Tiedostot

Tulos

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/v7/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"
  }
}
Tiedostosi, valintasiJokainen outputs[].url on kopio tallennustilassamme: säilytetään ikuisesti (maksetaan gigatavu-kuukauden mukaan) tai 7 päivää ilmaiseksi tiliasetuksesi tai ?storage= perusteella.
Sama rakenne kaikissa malleissatype, url, content_type, width, height ja duration kuville, videolle ja äänelle. output on mallin oma tulosobjekti.
Tuloksen kentät
animation_glb
object {url, content_type, file_name, file_size} | nullAnimaatiotulos, joka sisältää 3D-mallin GLB-muodossa; vastaus ei sisällä tulosta, ellei enable_animation ole true.
animation_fbx
object {url, content_type, file_name, file_size} | nullAnimaatiotulos, joka sisältää 3D-mallin FBX-muodossa; vastaus ei sisällä tulosta, ellei enable_animation ole true.
model_glb
object {url, content_type, file_name, file_size}Generoidun 3D-objektin sisältävä GLB-tiedosto.
thumbnail
object {url, content_type, file_name, file_size} | nullGeneroidun mallin esikatselun näyttävä pikkukuva.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Linkit 3D-malliin eri muodoissa.
texture_urls
array of object {base_color, metallic, normal, roughness}Meshy API:n mukaisesti rakennetun taulukon tekstuuritiedosto-objektit.
seed
integer | nullGenerointisiemen, jos saatavilla.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullGLB-hahmotiedostona toimitettava riggaustulos; puuttuu vastauksesta, ellei enable_rigging ole true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullFBX-hahmotiedostona toimitettava riggaustulos; puuttuu vastauksesta, ellei enable_rigging ole true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullPerus- ja juoksuanimaatiot, jotka sisällytetään vain, jos enable_rigging on true.
rig_task_id
string | nullRiggaustehtävän tunniste; sisällytetään vain, jos enable_rigging on true.

Lisää malleja: Kuvasta 3D:ksi

Tekoälyagenteille: tämän sivun Markdown-muoto on osoitteessa https://doitong.com/fi/developers/models/meshy/v7/image-to-3d.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt