Hoppa till innehåll

Meshy 6 · Text to 3D

Integrera

Modell-id 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"

Den här begäran: 0,80 $ 800 API-krediter · ≈ 86,06 ₽ Kör den på den här sidan

Hämta API-nyckel
Meshy Text till 3D #text-to-3d

Meshgenerator från text till 3D med förhandsvisnings- eller texturerade lägen samt valfri PBR, riggning och animering

Meshy · 3D

Ditt första resultat visas här

Skapa en begäran nedan och kör den med din API-nyckel. Utdata kopieras till vår lagring och sparas för alltid eller 7 dagar kostnadsfritt.

Skapa en begäran

Kontrollerna genereras från modellschemat. Koden och priset uppdateras när du ändrar dem.

•obligatoriskt 88 / 600

Beskrivning av objektet som ska representeras som en 3D-modell, begränsad till 600 tecken.

Avancerat texture_prompt · texture_image_url · mode · model_type · topology · symmetry_mode · pose_mode · target_polycount · rigging_height_meters · animation_action_id · seed · should_remesh · enable_pbr · is_a_t_pose · enable_prompt_expansion · enable_rigging · enable_animation · enable_safety_checker
0 / 600

Styr textureringen med en extra textprompt i 'full'-läge; andra lägen använder den inte.

Släpp en fil eller

2D-referensbild för texturgenerering, tillämpas endast i 'full'-läge.

mode standard full

Genereringsläge: 'preview' matar ut geometri utan texturer, medan 'full' matar ut en texturerad modell genom att kombinera preview och refine.

model_type standard standard

3D-meshläge: välj 'lowpoly' för ett low-poly-resultat optimerat för renare polygoner; i detta läge ignorerar Meshy topology, target_polycount och should_remesh. Välj 'standard' för ett konventionellt resultat med hög detaljgrad, eller 'smart-topology' för att använda Meshy-T2 under geometristeget (preview) och få rena delar som genereras separat från början.

topology standard triangle

Val av modelltopologi mellan Triangle för geometriska detaljer och Quad för jämnare ytor.

symmetry_mode standard auto

Symmetriinställning som tillämpas när modellen skapas.

pose_mode standard

Lämna strängen tom för att inte ange den skapade modellens pose, eller begär en A-pose med 'a-pose' eller en T-pose med 't-pose'.

standard 30000

Mål för polygonantal, begränsat till 15,000 när model_type är 'smart-topology'. Om målet utelämnas i det läget väljs Meshys lägre standardvärde på 4,000.

standard 1.7

Ange en uppskattad karaktärshöjd i meter när enable_rigging är true; annars har detta värde ingen effekt.

standard 92

ID för animeringsförinställning i Meshys bibliotek, med tillgängliga åtgärder listade på https://docs.meshy.ai/en/api/animation-library. Validering och användning gäller endast när enable_animation är true: värden utanför [0, 696] avvisas med 422, och "Idle" motsvarar `0`.

Återanvänd detta frö tillsammans med en oförändrad prompt för att vanligtvis återskapa ett tidigare resultat.

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

Kör den här begäran

Din nyckel stannar i den här webbläsaren: den skickas endast till Doitong API och sparas endast i localStorage om du markerar Kom ihåg. Hämta en API-nyckel

Om Meshy 6 · Text to 3D

Bygger en 3D-modell från en text-`prompt` på upp till 600 tecken. `mode` väljer ottexturerad geometri (`preview`) eller ett texturerat resultat (`full`). `model_type` kan vara standard, lowpoly eller smart-topology och `target_polycount` sträcker sig från 100 till 300000, med smart topology begränsad till 15000. Den kan även lägga till PBR-kartor, en pose, humanoid riggning och en animationsförinställning.

Parametrar

NamnTyp StandardTillåtna Beskrivning
promptobligatoriskt
Typstring
≤ 600 tecken
Beskrivning av objektet som ska representeras som en 3D-modell, begränsad till 600 tecken.
modevalfritt
Typenum
Standardfull
previewfull
Genereringsläge: 'preview' matar ut geometri utan texturer, medan 'full' matar ut en texturerad modell genom att kombinera preview och refine.
seedvalfritt
Typinteger | null
Återanvänd detta frö tillsammans med en oförändrad prompt för att vanligtvis återskapa ett tidigare resultat.
model_typevalfritt
Typenum
Standardstandard
standardlowpolysmart-topology
3D-meshläge: välj 'lowpoly' för ett low-poly-resultat optimerat för renare polygoner; i detta läge ignorerar Meshy topology, target_polycount och should_remesh. Välj 'standard' för ett konventionellt resultat med hög detaljgrad, eller 'smart-topology' för att använda Meshy-T2 under geometristeget (preview) och få rena delar som genereras separat från början.
topologyvalfritt
Typenum
Standardtriangle
quadtriangle
Val av modelltopologi mellan Triangle för geometriska detaljer och Quad för jämnare ytor.
target_polycountvalfritt
Typinteger
Standard30000
100 – 300 000
Mål för polygonantal, begränsat till 15,000 när model_type är 'smart-topology'. Om målet utelämnas i det läget väljs Meshys lägre standardvärde på 4,000.
should_remeshvalfritt
Typboolean
Standardtrue
Hoppa över ommeshning och ta emot den råa triangulära meshen genom att ange false; aktivera annars ommeshningen.
symmetry_modevalfritt
Typenum
Standardauto
offautoon
Symmetriinställning som tillämpas när modellen skapas.
enable_pbrvalfritt
Typboolean
Standardfalse
Styr generering av metall-, grovhets- och normal-PBR-kartor tillsammans med basfärgen.
is_a_t_posevalfritt
Typboolean
Standardfalse
Växling för T-posegenerering, aktiverad med true; ersatt av pose_mode.
pose_modevalfritt
Typenum
Standard
a-poset-pose
Lämna strängen tom för att inte ange den skapade modellens pose, eller begär en A-pose med 'a-pose' eller en T-pose med 't-pose'.
enable_prompt_expansionvalfritt
Typboolean
Standardfalse
Låt en stor språkmodell berika prompten med detaljer. När denna utökning aktiveras förblir promptens innebörd oförändrad.
texture_promptvalfritt
Typstring | null
≤ 600 tecken
Styr textureringen med en extra textprompt i 'full'-läge; andra lägen använder den inte.
texture_image_urlvalfritt
Typurl · image
2D-referensbild för texturgenerering, tillämpas endast i 'full'-läge.
enable_riggingvalfritt
Typboolean
Standardfalse
Automatisk humanoid riggning, mest effektiv för humanoida modeller vars lemmar tydligt kan särskiljas. Aktivering riggar den skapade modellen och tillhandahåller grundläggande gång- och löpanimeringar.
rigging_height_metersvalfritt
Typnumber
Standard1.7
> 0
Ange en uppskattad karaktärshöjd i meter när enable_rigging är true; annars har detta värde ingen effekt.
enable_animationvalfritt
Typboolean
Standardfalse
Om den riggade modellen får en förinställd animering, vilket kräver att enable_rigging är true.
animation_action_idvalfritt
Typinteger
Standard92
ID för animeringsförinställning i Meshys bibliotek, med tillgängliga åtgärder listade på https://docs.meshy.ai/en/api/animation-library. Validering och användning gäller endast när enable_animation är true: värden utanför [0, 696] avvisas med 422, och "Idle" motsvarar `0`.
enable_safety_checkervalfritt
Typboolean
Standardtrue
Säkerhetskontroll för förbehandling: true gör en säkerhetskontroll av indata till ett krav före bearbetning.
obligatoriskt

Filparametrar tar emot en offentlig https://-URL, en data:-URI på upp till 10 MB eller file_url från en uppladdning. Filer

Resultat

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"
  }
}
Dina filer, ditt valVarje outputs[].url är en kopia i vår lagring: sparad för alltid (debiteras per GB-månad) eller 7 dagar kostnadsfritt, enligt din kontoinställning eller ?storage=.
Samma struktur för varje modelltype, url, content_type, width, height och duration, för bilder, video och ljud. output är modellens eget resultatobjekt.
Resultatets fält
animation_glb
object {url, content_type, file_name, file_size} | nullAnimeringsresultat som innehåller 3D-modellen som GLB; svaret utelämnar detta resultat om enable_animation inte är true.
animation_fbx
object {url, content_type, file_name, file_size} | nullAnimeringsresultat som innehåller 3D-modellen som FBX; svaret utelämnar detta resultat om enable_animation inte är true.
model_glb
object {url, content_type, file_name, file_size}GLB-fil som innehåller det genererade 3D-objektet.
thumbnail
object {url, content_type, file_name, file_size} | nullMiniatyrbild som visar en förhandsvisning av den genererade modellen.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Länkar till 3D-modellen i olika format.
texture_urls
array of object {base_color, metallic, normal, roughness}Texturfiler representerade som en array med objekt.
seed
integer | nullSeed-värde som används under genereringen.
prompt
stringTextprompt som angavs för genereringen.
actual_prompt
string | nullPrompt som faktiskt tillämpades på genereringen när promptexpansion var aktiverad.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullRiggningsresultat som levereras som en GLB-karaktärsfil; saknas i svaret om enable_rigging inte är true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullRiggningsresultat som levereras som en FBX-karaktärsfil; saknas i svaret om enable_rigging inte är true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullGrundläggande gång- och löpanimeringar, inkluderade endast om enable_rigging är true.
rig_task_id
string | nullIdentifierare för riggningsuppgiften; inkluderas endast om enable_rigging är true.

Fler modeller: Text till 3D

För AI-agenter: den här sidan som Markdown finns på https://doitong.com/sv/developers/models/meshy/v6/text-to-3d.md. Alla modeller och guider: https://doitong.com/developers/llms.txt