3D
Meshy 6 · Image to 3D Muunnelmat: 2
alkaen 0,80 $
800 API-krediittiä · ≈ 86,06 ₽
Meshy 6 · Text to 3D
Integroi
Mallin tunniste
meshy/v6/text-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/text-to-3d?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}'
# 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/text-to-3d?wait=20", {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}),
});
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 = {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
}
# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/meshy/v6/text-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/text-to-3d",
"input": {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}
}Kutsu mallia Meshy 6 · Text to 3D (meshy/v6/text-to-3d) Doitong API:n kautta. Dokumentaatio agenteille: https://doitong.com/fi/developers/models/meshy/v6/text-to-3d.md
POST https://api.doitong.ru/v1/run/meshy/v6/text-to-3d?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json
{
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}
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/text-to-3d samalla rungolla palauttaa tarkan hinnan ennen suorittamista.Tämä pyyntö: 0,80 $ 800 API-krediittiä · ≈ 86,06 ₽ 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/text-to-3d?wait=20
hinta → 0,80 $
# 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/text-to-3d?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}'
# 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/text-to-3d?wait=20", {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}),
});
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 = {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
}
# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/meshy/v6/text-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/text-to-3d",
"input": {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
},
"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 · Text to 3D
Rakentaa 3D-mallin enintään 600 merkin tekstimuotoisesta `prompt`-kehotteesta. `mode` valitsee teksturoimattoman geometrian (`preview`) tai teksturoidun tuloksen (`full`). `model_type` voi olla standard, lowpoly tai smart-topology, ja `target_polycount` vaihtelee välillä 100–300000; smart topology -tilan enimmäisarvo on 15000. Malliin voi myös lisätä PBR-kartat, asennon, humanoidin luustotuksen ja animaatioesiasetuksen.
Parametrit
NimiTyyppi
OletusSallitut
Kuvaus
promptpakollinen
Tyyppistring
≤ 600 merkkiä
3D-mallina esitettävän objektin kuvaus, enintään 600 merkkiä.
modevalinnainen
Tyyppienum
Oletusfull
previewfull
Generointitila: 'preview' tuottaa geometrian ilman tekstuureja, kun taas 'full' tuottaa teksturoidun mallin yhdistämällä preview- ja refine-vaiheet.
seedvalinnainen
Tyyppiinteger | null
Käytä tätä siementä muuttumattoman kehotteen kanssa yleensä aiemman tuloksen toistamiseen.
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 'smart-topology', jolloin Meshy-T2:ta käytetään geometrian (preview) vaiheessa ja puhtaat osat tuotetaan 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.
should_remeshvalinnainen
Tyyppiboolean
Oletustrue
Ohita uudelleenverkotus ja vastaanota raaka kolmioverkko asettamalla arvoksi false; muuten uudelleenverkotusvaihe otetaan käyttöön.
symmetry_modevalinnainen
Tyyppienum
Oletusauto
offautoon
Mallin generoinnin aikana käytettävä symmetria-asetus.
enable_pbrvalinnainen
Tyyppiboolean
Oletusfalse
Määrittää, generoidaanko 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'.
enable_prompt_expansionvalinnainen
Tyyppiboolean
Oletusfalse
Sallii suuren kielimallin täydentää kehotetta yksityiskohdilla. Laajennuksen käyttöönotto ei muuta kehotteen merkitystä.
texture_promptvalinnainen
Tyyppistring | null
≤ 600 merkkiä
Ohjaa teksturointia ylimääräisellä tekstikehotteella 'full'-tilassa; muut tilat eivät käytä sitä.
texture_image_urlvalinnainen
Tyyppiurl · image
Tekstuurien generointiin käytettävä 2D-viitekuva, jota käytetään vain 'full'-tilassa.
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
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/text-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": 800,
"usd": "0.80",
"charged": 800,
"refunded": 0
},
"input": {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
},
"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,
"prompt": "A rustic, antique wooden treasure chest with a curved, domed lid, constructed from weathered, dark brown planks exhibiting prominent wood grain and subtle distress. It's heavily reinforced with broad, dark grey, oxidized metal bands secured by numerous circular rivets. Ornate, dark iron decorative elements featuring swirling foliate patterns and dragon motifs adorn the corners and lid. A prominent, circular, intricately carved metal lock plate with a central keyhole dominates the front, flanked by two large, dark metallic pull rings.",
"actual_prompt": "string",
"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}Tekstuuritiedostot objektitaulukkona.
- seed
- integer | nullGeneroinnissa käytettävä siemenarvo.
- prompt
- stringGenerointiin annettu tekstikehote.
- actual_prompt
- string | nullGenerointiin tosiasiassa käytetty kehote, kun kehotteen laajennus oli käytössä.
- 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: Tekstistä 3D:ksi
Tekoälyagenteille: tämän sivun Markdown-muoto on osoitteessa https://doitong.com/fi/developers/models/meshy/v6/text-to-3d.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt