3D
Meshy 6 · Text to 3D Muunnelmat: 2
0,80 $
800 API-krediittiä · ≈ 86,06 ₽
Meshy 6 · Image to 3D
Integroi
Mallin tunniste
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"const API = "https://api.doitong.ru/v1";
const headers = {
"Authorization": "Bearer " + process.env.DOITONG_API_KEY,
"Content-Type": "application/json",
};
// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/meshy/v6/image-to-3d?wait=20", {
method: "POST",
headers,
body: JSON.stringify({
"image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
}),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);
// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");import os
import requests
API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}
payload = {
"image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
}
# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/meshy/v6/image-to-3d", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])
# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/fi/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.ru/v1/mcp \
--header "Authorization: Bearer $DOITONG_API_KEY"
# 2. Your agent calls the "run" tool with:
{
"model_id": "meshy/v6/image-to-3d",
"input": {
"image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
}
}Kutsu mallia Meshy 6 · Image to 3D (meshy/v6/image-to-3d) Doitong API:n kautta. Dokumentaatio agenteille: https://doitong.com/fi/developers/models/meshy/v6/image-to-3d.md
POST https://api.doitong.ru/v1/run/meshy/v6/image-to-3d?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json
{
"image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
}
Jos vastauksen tila on "queued" tai "running", kysy GET https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20 uudelleen, kunnes tila on "succeeded"; tiedostot ovat kohteessa outputs[].url. POST https://api.doitong.ru/v1/quote/meshy/v6/image-to-3d samalla rungolla palauttaa tarkan hinnan ennen suorittamista.Esimerkin kaltaiset tiedostot: 1,20 $ 1 200 API-krediittiä · ≈ 129,10 ₽ tiedostosi mitataan ennen suorittamista Suorita tällä sivulla
Uusi API-avaimesi. Se näytetään vain nyt, ja se on jo koodissa ja alla olevassa API-avainkentässä. Pidä se salassa: älä koskaan lisää sitä selaimessa suoritettavaan koodiin.
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.
POST
/run/meshy/v6/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/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"const API = "https://api.doitong.ru/v1";
const headers = {
"Authorization": "Bearer " + process.env.DOITONG_API_KEY,
"Content-Type": "application/json",
};
// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/meshy/v6/image-to-3d?wait=20", {
method: "POST",
headers,
body: JSON.stringify({
"image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
}),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);
// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");import os
import requests
API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}
payload = {
"image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
}
# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/meshy/v6/image-to-3d", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])
# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"]){
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "run",
"arguments": {
"model_id": "meshy/v6/image-to-3d",
"input": {
"image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
},
"wait_seconds": 20
}
}
}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 6 · Image to 3D
Rakentaa 3D-mallin yhdestä kuvasta (`image_url`). `model_type` on standard, lowpoly tai smart-topology, topologia on triangle tai quad, ja `target_polycount` on välillä 100–300000 (smart topology -tilassa enintään 15,000). Asetuksiin kuuluvat teksturointi, PBR-kartat, symmetria, A- tai T-asento sekä humanoidin luustotus animaatioesiasetuksella. Tuloksiin kuuluvat GLB- ja FBX-tiedostot.
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.
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/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"
}
}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.
Muut Meshy 6-muunnelmat
Lisää malleja: Kuvasta 3D:ksi
Tekoälyagenteille: tämän sivun Markdown-muoto on osoitteessa https://doitong.com/fi/developers/models/meshy/v6/image-to-3d.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt