Pāriet uz saturu

Meshy V7 Image to 3D

Integrēt

Modeļa id meshy/v7/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.com/v1/run/meshy/v7/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Faili, piemēram, paraugā: 1,20 $ 1200 API kredītu jūsu faili tiek izmērīti pirms izpildes Izpildīt šajā lapā

Iegūt API atslēgu
Meshy Attēls uz 3D #stylized#transform

Viena attēla pārveide par 3D režģi ar 2k ģeometrijas iespēju, izvēles PBR, skeletu un animāciju

Meshy · 3D

Šeit būs jūsu pirmais rezultāts

Izveidojiet pieprasījumu tālāk un izpildiet to ar savu API atslēgu. Izvades tiek kopētas mūsu krātuvē un glabātas mūžīgi vai 7 dienas bez maksas.

Izveidot pieprasījumu

Vadīklas tiek ģenerētas no modeļa shēmas. Kods un cena tiek atjaunināti, kad tos maināt.

•obligāts image_url
Nometiet failu vai

Norādiet 3D izveides avota attēlu, izmantojot URL vai base64 datu URI; atbalstīti .jpg, .jpeg, .png, AVIF vai HEIF. AVIF un HEIF ievades tiek automātiski konvertētas.

geometry_resolution

Tīkla ģeometrijas izšķirtspēja; atbalstītās Meshy-7 opcijas ir standard un 2k.

Papildu texture_prompt · texture_image_url · model_type · topology · symmetry_mode · pose_mode · target_polycount · rigging_height_meters · animation_action_id · should_remesh · enable_pbr · is_a_t_pose · enable_safety_checker · ultra_mode
0 / 600

Teksta norādes, kas vada tekstūras ģenerēšanu.

Nometiet failu vai

2D atsauces attēls, kas vada tekstūras ģenerēšanu.

model_type noklusējums standard

3D tīkla režīms: izvēlieties 'lowpoly', lai iegūtu zemās izšķirtspējas tīklu ar tīrākiem daudzstūriem; šajā režīmā Meshy ignorē topology, target_polycount un should_remesh. Parastam augstas detalizācijas rezultātam izvēlieties 'standard', bet 'smart-topology' izmanto Meshy-T2 un iegūst tīras daļas, kas jau sākotnēji ģenerētas atsevišķi.

topology noklusējums triangle

Modeļa topoloģijas izvēle starp Triangle ģeometriskām detaļām un Quad virsmas gludumam.

symmetry_mode noklusējums auto

Izvēlieties, vai modeļa ģenerēšana piespiež simetriju ar On, to neizmanto ar Off vai nosaka automātiski ar Auto.

pose_mode noklusējums

Atstājiet virkni tukšu, lai nenorādītu ģenerētā modeļa pozu, vai pieprasiet A-pozīciju ar 'a-pose' vai T-pozīciju ar 't-pose'.

noklusējums 30000

Daudzstūru skaita mērķis; ja model_type ir 'smart-topology', tas nepārsniedz 15,000. Ja šajā režīmā mērķis nav norādīts, tiek izmantots Meshy zemākais noklusējums — 4,000.

noklusējums 1.7

Norādiet aptuveno tēla augstumu metros, ja enable_rigging ir true; pretējā gadījumā šai vērtībai nav ietekmes.

noklusējums 92

Meshy bibliotēkas animācijas iepriekš iestatītais ID; pieejamās darbības uzskaitītas vietnē https://docs.meshy.ai/en/api/animation-library. Validācija un lietošana attiecas tikai tad, ja enable_animation ir true: vērtības ārpus [0, 696] tiek noraidītas ar 422, un "Idle" atbilst `0`.

POST /run/meshy/v7/image-to-3d?wait=20 cena → 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/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Palaist šo pieprasījumu

Jūsu atslēga paliek šajā pārlūkprogrammā: tā tiek nosūtīta tikai uz Doitong API un saglabāta (localStorage) tikai tad, ja atzīmējat Atcerēties. Iegūt API atslēgu

Par Meshy V7 Image to 3D

Izveido 3D modeli no viena attēla laukā `image_url` (JPG, PNG, AVIF vai HEIF). `model_type` izvēlas standard, lowpoly vai smart-topology, bet `target_polycount` pieņem vērtības no 100 līdz 300000. `geometry_resolution` piedāvā standard vai 2k. Teksturēšanu var izslēgt ar `should_texture`, bet PBR kartes, pozas režīms, humanoīda skelets un animācijas sākotne ir izvēles iespējas.

Parametri

Nosūti vai nu kanonisko nosaukumu, vai vietējo nosaukumu, bet ne abus. Kan啤niskie nosaukumi

NosaukumsTips NoklusējumsAtļauts Apraksts
image_urlobligāts image
Tipsurl · image
Norādiet 3D izveides avota attēlu, izmantojot URL vai base64 datu URI; atbalstīti .jpg, .jpeg, .png, AVIF vai HEIF. AVIF un HEIF ievades tiek automātiski konvertētas.
model_typeneobligāts
Tipsenum
Noklusējumsstandard
standardlowpolysmart-topology
3D tīkla režīms: izvēlieties 'lowpoly', lai iegūtu zemās izšķirtspējas tīklu ar tīrākiem daudzstūriem; šajā režīmā Meshy ignorē topology, target_polycount un should_remesh. Parastam augstas detalizācijas rezultātam izvēlieties 'standard', bet 'smart-topology' izmanto Meshy-T2 un iegūst tīras daļas, kas jau sākotnēji ģenerētas atsevišķi.
topologyneobligāts
Tipsenum
Noklusējumstriangle
quadtriangle
Modeļa topoloģijas izvēle starp Triangle ģeometriskām detaļām un Quad virsmas gludumam.
target_polycountneobligāts
Tipsinteger
Noklusējums30000
100 – 300 000
Daudzstūru skaita mērķis; ja model_type ir 'smart-topology', tas nepārsniedz 15,000. Ja šajā režīmā mērķis nav norādīts, tiek izmantots Meshy zemākais noklusējums — 4,000.
symmetry_modeneobligāts
Tipsenum
Noklusējumsauto
offautoon
Izvēlieties, vai modeļa ģenerēšana piespiež simetriju ar On, to neizmanto ar Off vai nosaka automātiski ar Auto.
should_remeshneobligāts
Tipsboolean
Noklusējumstrue
Iespējo vai atspējo atkārtotas tīkla izveides posmu.
should_textureneobligāts
Tipsboolean
Noklusējumstrue
Iespējo vai atspējo tekstūras ģenerēšanu.
enable_pbrneobligāts
Tipsboolean
Noklusējumsfalse
Pievieno metāliskuma, raupjuma un normāļu PBR kartes līdzās pamatkrāsai.
is_a_t_poseneobligāts
Tipsboolean
Noklusējumsfalse
T-pozīcijas ģenerēšanas slēdzis, ko aktivizē true; novecojis, priekšroka dodama pose_mode.
pose_modeneobligāts
Tipsenum
Noklusējums
a-poset-pose
Atstājiet virkni tukšu, lai nenorādītu ģenerētā modeļa pozu, vai pieprasiet A-pozīciju ar 'a-pose' vai T-pozīciju ar 't-pose'.
texture_promptneobligāts
Tipsstring | null
≤ 600 rakstzīmju
Teksta norādes, kas vada tekstūras ģenerēšanu.
texture_image_urlneobligāts
Tipsurl · image
2D atsauces attēls, kas vada tekstūras ģenerēšanu.
enable_riggingneobligāts
Tipsboolean
Noklusējumsfalse
Automātiska humanoīda skeleta izveide, kas visefektīvāk darbojas humanoīdiem modeļiem ar skaidri atšķiramām ekstremitātēm. Iespējojot šo opciju, ģenerētajam modelim tiek izveidots skelets un nodrošinātas pamata iešanas un skriešanas animācijas.
rigging_height_metersneobligāts
Tipsnumber
Noklusējums1.7
> 0
Norādiet aptuveno tēla augstumu metros, ja enable_rigging ir true; pretējā gadījumā šai vērtībai nav ietekmes.
enable_animationneobligāts
Tipsboolean
Noklusējumsfalse
Vai skeletotajam modelim tiek piešķirta iepriekš iestatīta animācija; tam nepieciešams, lai enable_rigging būtu true.
animation_action_idneobligāts
Tipsinteger
Noklusējums92
Meshy bibliotēkas animācijas iepriekš iestatītais ID; pieejamās darbības uzskaitītas vietnē https://docs.meshy.ai/en/api/animation-library. Validācija un lietošana attiecas tikai tad, ja enable_animation ir true: vērtības ārpus [0, 696] tiek noraidītas ar 422, un "Idle" atbilst `0`.
enable_safety_checkerneobligāts
Tipsboolean
Noklusējumstrue
Priekšapstrādes drošības pārbaudes slēdzis: true padara ievades drošības pārbaudi par priekšnoteikumu apstrādei.
geometry_resolutionneobligāts
Tipsenum
standard2k
Tīkla ģeometrijas izšķirtspēja; atbalstītās Meshy-7 opcijas ir standard un 2k.
ultra_modeneobligāts
Tipsboolean
Noklusējumsfalse
Novecojusi opcija, ko aizstāj geometry_resolution; ja norādītas abas, priekšroka ir geometry_resolution. Izmantojiet geometry_resolution='2k'.
obligāts Kan啤niskais nosaukums, arī pieņemts

Failu parametriem nepieciešams publisks https:// URL, data: URI līdz 10 MB vai augšupielādes file_url. Faili

Izvade

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/v7/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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Jūsu faili, jūsu izvēleKatrs outputs[].url ir kopija mūsu krātuvē: tiek glabāta mūžīgi (maksa par GB mēnesī) vai 7 dienas bez maksas — atbilstoši konta iestatījumam vai ?storage=.
Vienāda struktūra katram modelimtype, url, content_type, width, height un duration gan attēliem, gan video un audio. output ir paša modeļa rezultāta objekts.
Izvades lauki
animation_glb
object {url, content_type, file_name, file_size} | nullAnimācijas rezultāts ar 3D modeli GLB formātā; atbilde šo rezultātu neietver, ja vien enable_animation nav true.
animation_fbx
object {url, content_type, file_name, file_size} | nullAnimācijas rezultāts ar 3D modeli FBX formātā; atbilde šo rezultātu neietver, ja vien enable_animation nav true.
model_glb
object {url, content_type, file_name, file_size}GLB fails ar ģenerēto 3D objektu.
thumbnail
object {url, content_type, file_name, file_size} | nullSīktēls ar ģenerētā modeļa priekšskatījumu.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Saites uz 3D modeli dažādos formātos.
texture_urls
array of object {base_color, metallic, normal, roughness}Tekstūras failu objekti masīvā, kas strukturēti atbilstoši Meshy API.
seed
integer | nullĢenerēšanas sākumstāvoklis, ja pieejams.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullSkeleta izveides rezultāts, kas piegādāts kā GLB tēla fails; atbildē nav iekļauts, ja vien enable_rigging nav true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullSkeleta izveides rezultāts, kas piegādāts kā FBX tēla fails; atbildē nav iekļauts, ja vien enable_rigging nav true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullPamata iešanas un skriešanas animācijas, iekļautas tikai tad, ja enable_rigging ir true.
rig_task_id
string | nullSkeleta izveides uzdevuma identifikators; iekļauts tikai tad, ja enable_rigging ir true.

Vairāk modeļu: Attēls uz 3D

AI aģentiem: šī lapa Markdown formātā ir pieejama https://doitong.com/lv/developers/models/meshy/v7/image-to-3d.md. Visi modeļi un ceļveži: https://doitong.com/developers/llms.txt