3D
Meshy V7 Image to 3D Warianty: 4
od 0,80 $
800 kredytów API
Meshy V7 Text to 3D
Integracja
Identyfikator modelu
meshy/v7/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.com/v1/run/meshy/v7/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.com/v1/requests/REQUEST_ID?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY"const API = "https://api.doitong.com/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/v7/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.com/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/v7/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/pl/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.com/v1/mcp \
--header "Authorization: Bearer $DOITONG_API_KEY"
# 2. Your agent calls the "run" tool with:
{
"model_id": "meshy/v7/text-to-3d",
"input": {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}
}Wywołaj model Meshy V7 Text to 3D (meshy/v7/text-to-3d) za pośrednictwem Doitong API. Dokumentacja dla agentów: https://doitong.com/pl/developers/models/meshy/v7/text-to-3d.md
POST https://api.doitong.com/v1/run/meshy/v7/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"
}
Jeśli status odpowiedzi to "queued" lub "running", odpytuj GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20, aż status zmieni się na "succeeded"; pliki znajdują się w outputs[].url. POST https://api.doitong.com/v1/quote/meshy/v7/text-to-3d z tym samym ciałem zwraca dokładną cenę przed uruchomieniem.Pliki takie jak przykład: 1,20 $ 1200 kredytów API Twoje pliki są mierzone przed uruchomieniem Uruchom na tej stronie
Twój nowy klucz API. Jest wyświetlany tylko teraz i znajduje się już w kodzie oraz w polu klucza API poniżej. Zachowaj go w tajemnicy: nigdy nie umieszczaj go w kodzie uruchamianym w przeglądarce.
Meshy · 3D
Tutaj pojawi się pierwszy wynik
Zbuduj poniżej żądanie i uruchom je za pomocą klucza API. Wyniki są kopiowane do naszej przestrzeni dyskowej i przechowywane bezterminowo lub 7 dni bezpłatnie.
Zbuduj żądanie
Elementy sterujące są generowane ze schematu modelu. Kod i cena aktualizują się podczas ich zmiany.
POST
/run/meshy/v7/text-to-3d?wait=20
wycena → 1,20 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/meshy/v7/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.com/v1/requests/REQUEST_ID?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY"const API = "https://api.doitong.com/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/v7/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.com/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/v7/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/v7/text-to-3d",
"input": {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
},
"wait_seconds": 20
}
}
}Uruchom to żądanie
Klucz pozostaje w tej przeglądarce: jest wysyłany tylko do Doitong API i zapisywany (localStorage) tylko po zaznaczeniu opcji Zapamiętaj. Uzyskaj klucz API
Informacje o Meshy V7 Text to 3D
Generuje model 3D na podstawie `prompt` o długości do 600 znaków, z opcjonalnym `enable_prompt_expansion`. `mode` zwraca geometrię bez tekstur albo model z teksturami. Wybierz standard, lowpoly lub smart-topology za pomocą `model_type`, ustaw `target_polycount` od 100 do 300000 oraz wybierz standard lub 2k dla `geometry_resolution`. Do postaci humanoidalnych można dodać rigowanie i presety animacji.
Parametry
NazwaTyp
DomyślneDozwolone
Opis
promptwymagane
Typstring
≤ 600 znaków
Opis obiektu przedstawianego jako model 3D, ograniczony do 600 znaków.
modeopcjonalne
Typenum
Domyślnefull
previewfull
Tryb generowania: 'preview' zwraca geometrię bez tekstur, natomiast 'full' zwraca teksturowany model przez połączenie preview i refine.
seedopcjonalne
Typinteger | null
Użyj ponownie tego seedu wraz z niezmienionym promptem, aby zwykle odtworzyć wcześniejszy wynik.
model_typeopcjonalne
Typenum
Domyślnestandard
standardlowpolysmart-topology
Tryb siatki 3D: wybierz 'lowpoly' dla wyniku low-poly zoptymalizowanego pod kątem czystszych wielokątów; w tym trybie Meshy ignoruje topology, target_polycount i should_remesh. Dla standardowego wyniku o wysokiej szczegółowości wybierz 'standard', a aby użyć Meshy-T2 podczas etapu geometrii (preview) i uzyskać czyste części generowane osobno od początku, wybierz 'smart-topology'.
topologyopcjonalne
Typenum
Domyślnetriangle
quadtriangle
Wybór topologii modelu: Triangle zapewnia szczegółowość geometryczną, a Quad gładkość powierzchni.
target_polycountopcjonalne
Typinteger
Domyślne30000
100 – 300 000
Docelowa liczba wielokątów, ograniczona do 15,000, gdy model_type ma wartość 'smart-topology'. Pominięcie celu w tym trybie wybiera niższą wartość domyślną Meshy wynoszącą 4,000.
should_remeshopcjonalne
Typboolean
Domyślnetrue
Pomiń ponowne tworzenie siatki i odbierz surową siatkę trójkątną, ustawiając tę wartość na false; w przeciwnym razie włącz etap remesh.
symmetry_modeopcjonalne
Typenum
Domyślneauto
offautoon
Ustawienie symetrii stosowane podczas generowania modelu.
enable_pbropcjonalne
Typboolean
Domyślnefalse
Określa, czy wraz z kolorem bazowym generować mapy PBR metaliczności, chropowatości i normalnych.
is_a_t_poseopcjonalne
Typboolean
Domyślnefalse
Przełącznik generowania pozy T, aktywowany przez true; przestarzały na rzecz pose_mode.
pose_modeopcjonalne
Typenum
Domyślne
a-poset-pose
Pozostaw ciąg pusty, aby nie określać pozy wygenerowanego modelu, albo zażądaj pozy A przez 'a-pose' lub pozy T przez 't-pose'.
enable_prompt_expansionopcjonalne
Typboolean
Domyślnefalse
Pozwala dużemu modelowi językowemu wzbogacić prompt o szczegóły. Włączenie tego rozszerzenia nie zmienia znaczenia promptu.
texture_promptopcjonalne
Typstring | null
≤ 600 znaków
Steruje teksturowaniem za pomocą dodatkowego promptu tekstowego w trybie 'full'; inne tryby go nie używają.
texture_image_urlopcjonalne
Typurl · image
Obraz referencyjny 2D do generowania tekstur, stosowany tylko w trybie 'full'.
enable_riggingopcjonalne
Typboolean
Domyślnefalse
Automatyczne rigowanie humanoidalne, najskuteczniejsze dla modeli humanoidalnych, których kończyny są wyraźnie rozróżnialne. Włączenie riguje wygenerowany model i dostarcza podstawowe animacje chodzenia oraz biegu.
rigging_height_metersopcjonalne
Typnumber
Domyślne1.7
> 0
Podaj szacowaną wysokość postaci w metrach, gdy enable_rigging ma wartość true; w przeciwnym razie ta wartość nie ma wpływu.
enable_animationopcjonalne
Typboolean
Domyślnefalse
Określa, czy zrigowany model otrzyma animację presetową, co wymaga wartości true dla enable_rigging.
animation_action_idopcjonalne
Typinteger
Domyślne92
Identyfikator animacji presetowej z biblioteki Meshy; dostępne akcje są wymienione na https://docs.meshy.ai/en/api/animation-library. Walidacja i użycie mają zastosowanie tylko, gdy enable_animation ma wartość true: wartości spoza [0, 696] są odrzucane z błędem 422, a "Idle" odpowiada `0`.
enable_safety_checkeropcjonalne
Typboolean
Domyślnetrue
Przełącznik kontroli bezpieczeństwa podczas przetwarzania wstępnego: true sprawia, że kontrola bezpieczeństwa danych wejściowych jest wymagana przed przetwarzaniem.
geometry_resolutionopcjonalne
Typenum
standard2k
Rozdzielczość geometrii siatki; obsługiwane opcje Meshy-7 to standard i 2k.
ultra_modeopcjonalne
Typboolean
Domyślnefalse
Przestarzała opcja zastąpiona przez geometry_resolution, które ma pierwszeństwo, jeśli podano obie; użyj zamiast niej geometry_resolution='2k'.
wymagane
Parametry plików przyjmują publiczny URL https://, identyfikator URI data: do 10 MB albo file_url przesłanego pliku. Pliki
Wynik
GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
"id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
"object": "request",
"model": "meshy/v7/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": 1200,
"usd": "1.20",
"charged": 1200,
"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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
"cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
}
}Twoje pliki, Twój wybórKażdy outputs[].url to kopia w naszej przestrzeni dyskowej: przechowywana bezterminowo (opłata za GB-miesiąc) lub 7 dni bezpłatnie, zgodnie z ustawieniem konta lub ?storage=.
Taki sam format w każdym modelutype, url, content_type, width, height i duration — tak samo dla obrazów, filmów i dźwięku. output to własny obiekt wyniku modelu.
Pola wyniku
- animation_glb
- object {url, content_type, file_name, file_size} | nullWynik animacji zawierający model 3D jako GLB; odpowiedź pomija ten wynik, jeśli enable_animation nie ma wartości true.
- animation_fbx
- object {url, content_type, file_name, file_size} | nullWynik animacji zawierający model 3D jako FBX; odpowiedź pomija ten wynik, jeśli enable_animation nie ma wartości true.
- model_glb
- object {url, content_type, file_name, file_size}Plik GLB zawierający wygenerowany obiekt 3D.
- thumbnail
- object {url, content_type, file_name, file_size} | nullMiniatura przedstawiająca podgląd wygenerowanego modelu.
- model_urls
- object {glb, fbx, obj, usdz, blend, stl}Odnośniki do modelu 3D w różnych formatach.
- texture_urls
- array of object {base_color, metallic, normal, roughness}Pliki tekstur przedstawione jako tablica obiektów.
- seed
- integer | nullWartość ziarna używana podczas generowania.
- prompt
- stringPrompt tekstowy podany do generowania.
- actual_prompt
- string | nullPrompt faktycznie zastosowany do generowania po włączeniu rozszerzania promptu.
- rigged_character_glb
- object {url, content_type, file_name, file_size} | nullWynik rigowania dostarczony jako plik postaci GLB; nieobecny w odpowiedzi, jeśli enable_rigging nie ma wartości true.
- rigged_character_fbx
- object {url, content_type, file_name, file_size} | nullWynik rigowania dostarczony jako plik postaci FBX; nieobecny w odpowiedzi, jeśli enable_rigging nie ma wartości true.
- basic_animations
- object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullPodstawowe animacje chodzenia i biegu, dołączane tylko, gdy enable_rigging ma wartość true.
- rig_task_id
- string | nullIdentyfikator zadania rigowania; dołączany tylko, gdy enable_rigging ma wartość true.
Inne warianty Meshy v7
Więcej modeli: Tekst na 3D
Dla agentów AI: ta strona w formacie Markdown jest dostępna pod adresem https://doitong.com/pl/developers/models/meshy/v7/text-to-3d.md. Wszystkie modele i przewodniki: https://doitong.com/developers/llms.txt