Gå til indhold

Meshy V7 Text to 3D

Integrer

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

Filer som eksemplet: 1,20 $ 1.200 API-kreditter dine filer måles før kørslen Kør den på denne side

Hent API-nøgle
Meshy Tekst til 3D #stylized#transform

Tekst-til-3D med Meshy 7: forhåndsvisnings- eller fuld tilstand, 2k-geometri samt muligheder for PBR, rigging og animation

Meshy · 3D

Dit første resultat kommer her

Opret en anmodning nedenfor, og kør den med din API-nøgle. Output kopieres til vores lagring, gemt for altid eller 7 dage gratis.

Opret en anmodning

Kontrollerne genereres fra modellens skema. Koden og prisen opdateres, når du ændrer dem.

•påkrævet 88 / 600

Beskrivelse af objektet, der skal repræsenteres som en 3D-model, begrænset til 600 tegn.

mode standard full

Genereringstilstand: 'preview' giver geometri uden teksturer, mens 'full' giver en tekstureret model ved at kombinere preview og refine.

geometry_resolution

Mesh-geometriens opløsning; de understøttede Meshy-7-indstillinger er standard og 2k.

Avanceret texture_prompt · texture_image_url · 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_safety_checker · ultra_mode
0 / 600

Teksturer med en ekstra tekstprompt i 'full'-tilstand; andre tilstande bruger den ikke.

Slip en fil, eller

2D-referencebillede til teksturgenerering, kun anvendt i 'full'-tilstand.

model_type standard standard

3D-mesh-tilstand: vælg 'lowpoly' for et low-poly-resultat optimeret til renere polygoner; i denne tilstand ignorerer Meshy topology, target_polycount og should_remesh. Vælg 'standard' for et konventionelt resultat med mange detaljer, eller 'smart-topology' for at bruge Meshy-T2 under geometri- (preview-)trinnet og få rene dele, der genereres separat fra starten.

topology standard triangle

Valg af modeltopologi mellem Triangle for geometriske detaljer og Quad for glattere overflader.

symmetry_mode standard auto

Symmetriindstilling, der anvendes under generering af modellen.

pose_mode standard

Lad strengen være tom for ikke at angive den genererede models positur, eller anmod om en A-pose med 'a-pose' eller en T-pose med 't-pose'.

standard 30000

Mål for polygonantal, begrænset til 15,000 når model_type er 'smart-topology'. Hvis målet udelades i denne tilstand, vælges Meshys lavere standardværdi på 4,000.

standard 1.7

Angiv en estimeret karakterhøjde i meter, når enable_rigging er true; ellers har denne værdi ingen effekt.

standard 92

ID for Meshy-bibliotekets animationspreset med tilgængelige handlinger angivet på https://docs.meshy.ai/en/api/animation-library. Validering og brug gælder kun, når enable_animation er true: værdier uden for [0, 696] afvises med en 422, og "Idle" svarer til `0`.

Genbrug denne seed sammen med en uændret prompt for normalt at genskabe et tidligere resultat.

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

Kør denne anmodning

Din nøgle forbliver i denne browser: Den sendes kun til Doitong API og gemmes kun i localStorage, hvis du markerer Husk. Hent en API-nøgle

Om Meshy V7 Text to 3D

Genererer en 3D-model fra en `prompt` på op til 600 tegn med valgfri `enable_prompt_expansion`. `mode` returnerer enten utekstureret geometri eller en tekstureret model. Vælg standard, lowpoly eller smart-topology via `model_type`, angiv `target_polycount` fra 100 til 300000, og vælg standard eller 2k `geometry_resolution`. Rigging og animationsforudindstillinger kan tilføjes for humanoide figurer.

Parametre

NavnType StandardTilladt Beskrivelse
promptpåkrævet
Typestring
≤ 600 tegn
Beskrivelse af objektet, der skal repræsenteres som en 3D-model, begrænset til 600 tegn.
modevalgfri
Typeenum
Standardfull
previewfull
Genereringstilstand: 'preview' giver geometri uden teksturer, mens 'full' giver en tekstureret model ved at kombinere preview og refine.
seedvalgfri
Typeinteger | null
Genbrug denne seed sammen med en uændret prompt for normalt at genskabe et tidligere resultat.
model_typevalgfri
Typeenum
Standardstandard
standardlowpolysmart-topology
3D-mesh-tilstand: vælg 'lowpoly' for et low-poly-resultat optimeret til renere polygoner; i denne tilstand ignorerer Meshy topology, target_polycount og should_remesh. Vælg 'standard' for et konventionelt resultat med mange detaljer, eller 'smart-topology' for at bruge Meshy-T2 under geometri- (preview-)trinnet og få rene dele, der genereres separat fra starten.
topologyvalgfri
Typeenum
Standardtriangle
quadtriangle
Valg af modeltopologi mellem Triangle for geometriske detaljer og Quad for glattere overflader.
target_polycountvalgfri
Typeinteger
Standard30000
100 – 300.000
Mål for polygonantal, begrænset til 15,000 når model_type er 'smart-topology'. Hvis målet udelades i denne tilstand, vælges Meshys lavere standardværdi på 4,000.
should_remeshvalgfri
Typeboolean
Standardtrue
Spring remeshing over, og modtag det rå trekantsmesh ved at sætte dette til false; ellers aktiveres remesh-fasen.
symmetry_modevalgfri
Typeenum
Standardauto
offautoon
Symmetriindstilling, der anvendes under generering af modellen.
enable_pbrvalgfri
Typeboolean
Standardfalse
Styrer generering af metallic-, roughness- og normal-PBR-maps sammen med basefarven.
is_a_t_posevalgfri
Typeboolean
Standardfalse
Kontaktgenerering aktiveret af true; forældet til fordel for pose_mode.
pose_modevalgfri
Typeenum
Standard
a-poset-pose
Lad strengen være tom for ikke at angive den genererede models positur, eller anmod om en A-pose med 'a-pose' eller en T-pose med 't-pose'.
enable_prompt_expansionvalgfri
Typeboolean
Standardfalse
Tillad en stor sprogmodel at berige prompten med detaljer. Denne udvidelse ændrer ikke promptens betydning.
texture_promptvalgfri
Typestring | null
≤ 600 tegn
Teksturer med en ekstra tekstprompt i 'full'-tilstand; andre tilstande bruger den ikke.
texture_image_urlvalgfri
Typeurl · image
2D-referencebillede til teksturgenerering, kun anvendt i 'full'-tilstand.
enable_riggingvalgfri
Typeboolean
Standardfalse
Automatisk humanoid rigging, mest effektivt for humanoide modeller, hvis lemmer tydeligt kan skelnes. Aktivering rigger den genererede model og leverer grundlæggende gang- og løbeanimationer.
rigging_height_metersvalgfri
Typenumber
Standard1.7
> 0
Angiv en estimeret karakterhøjde i meter, når enable_rigging er true; ellers har denne værdi ingen effekt.
enable_animationvalgfri
Typeboolean
Standardfalse
Om den riggede model får en forudindstillet animation, hvilket kræver, at enable_rigging er true.
animation_action_idvalgfri
Typeinteger
Standard92
ID for Meshy-bibliotekets animationspreset med tilgængelige handlinger angivet på https://docs.meshy.ai/en/api/animation-library. Validering og brug gælder kun, når enable_animation er true: værdier uden for [0, 696] afvises med en 422, og "Idle" svarer til `0`.
enable_safety_checkervalgfri
Typeboolean
Standardtrue
Sikkerhedskontrol før behandling: true gør en sikkerhedskontrol af input til en forudsætning for behandlingen.
geometry_resolutionvalgfri
Typeenum
standard2k
Mesh-geometriens opløsning; de understøttede Meshy-7-indstillinger er standard og 2k.
ultra_modevalgfri
Typeboolean
Standardfalse
Forældet indstilling erstattet af geometry_resolution, som vinder, hvis begge angives; brug geometry_resolution='2k' i stedet.
påkrævet

Filparametre accepterer en offentlig https://-URL, en data:-URI på op til 10 MB eller file_url fra en upload. Filer

Output

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"
  }
}
Dine filer, dit valgHver outputs[].url er en kopi på vores lagring: gemt for altid (betales pr. GB-måned) eller 7 dage gratis, afhængigt af din kontoindstilling eller ?storage=.
Samme struktur for alle modellertype, url, content_type, width, height og duration for billeder, video og lyd. output er modellens eget resultatobjekt.
Outputfelter
animation_glb
object {url, content_type, file_name, file_size} | nullAnimationsresultat med 3D-modellen som GLB; svaret udelader dette resultat, medmindre enable_animation er true.
animation_fbx
object {url, content_type, file_name, file_size} | nullAnimationsresultat med 3D-modellen som FBX; svaret udelader dette resultat, medmindre enable_animation er true.
model_glb
object {url, content_type, file_name, file_size}GLB-fil med det genererede 3D-objekt.
thumbnail
object {url, content_type, file_name, file_size} | nullMiniature, der viser en forhåndsvisning af den genererede model.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Links til 3D-modellen i forskellige formater.
texture_urls
array of object {base_color, metallic, normal, roughness}Teksturfiler repræsenteret som et array af objekter.
seed
integer | nullSeed-værdi, der bruges under genereringen.
prompt
stringTekstprompt angivet til generering.
actual_prompt
string | nullPrompt, der faktisk blev anvendt til generering, da promptudvidelse var aktiveret.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullRiggingresultat leveret som en GLB-karakterfil; mangler i svaret, medmindre enable_rigging er true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullRiggingresultat leveret som en FBX-karakterfil; mangler i svaret, medmindre enable_rigging er true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullGrundlæggende gang- og løbeanimationer, kun inkluderet hvis enable_rigging er true.
rig_task_id
string | nullIdentifikator for rigging-opgaven; kun inkluderet hvis enable_rigging er true.

Flere modeller: Tekst til 3D

Til AI-agenter: Denne side som Markdown findes på https://doitong.com/da/developers/models/meshy/v7/text-to-3d.md. Alle modeller og vejledninger: https://doitong.com/developers/llms.txt