Flera bilder till 3D API

Flera bilder till 3D API är en funktion som låter dig integrera Meshys Flera bilder till 3D-funktioner i din egen applikation. I det här avsnittet hittar du all information du behöver för att komma igång med detta API.

POST/openapi/v1/multi-image-to-3d

Skapa en Flera bilder till 3D-uppgift

Denna endpoint låter dig skapa en ny Flera bilder till 3D-uppgift. Se Uppgiftsobjektet för Flera bilder till 3D för att se vilka egenskaper som ingår i Flera bilder till 3D-uppgiftsobjektet.

Parametrar

Endast en av input_task_id eller image_urls är obligatorisk. Om båda anges har input_task_id prioritet.

Name
input_task_id
Type
string
Obligatorisk
Description
ID:t för en avslutad bildgenereringsuppgift vars utdata (1–4 bilder) ska användas som indata. Denna uppgift måste vara en av följande: Text till bild, Bild till bild, Text till bild Flervy, eller Bild till bild Flervy. Dessutom måste den ha körts via API:et och ha statusen SUCCEEDED.

Name
image_urls
Type
array
Obligatorisk
Description
Ange 1 till 4 bilder som Meshy ska använda för att skapa modellen. Vi stöder för närvarande formaten .jpg, .jpeg och .png. Alla bilder bör visa samma objekt från olika vinklar för bästa resultat.
Det finns två sätt att ange varje bild:
- Offentligt tillgänglig URL: En URL som är åtkomlig från det offentliga internet.
- Data URI: En base64-kodad Data URI av bilden. Exempel på en Data URI: data:image/jpeg;base64,<your base64-encoded image data>.
För meshy-7 (eller latest) används den första bilden som primär (front) vy. Ordningen på de återstående bilderna spelar ingen roll.

Name
ai_model
Type
string
standard latest
Description
ID för den modell som ska användas. Tillgängliga värden: meshy-5, meshy-6, meshy-7, latest (Meshy 7).
Name
ultra_mode
Type
boolean
standard false
Description
Aktiverar Ultra-generering för geometri med högre kvalitet och finare ytdetaljer.
Stöds endast när ai_model är meshy-7 (eller latest).
Name
should_texture
Type
boolean
standard true
Description
Avgör om texturer genereras. Om värdet sätts till false hoppas texturfasen över, vilket ger ett nät utan texturer.

Gäller endast när should_texture = true

Name
enable_pbr
Type
boolean
standard false
Description
Generera PBR-mappar (metallic, roughness, normal) utöver basfärgen. En emissionsmapp inkluderas också när ai_model är meshy-6, förutom vid texture_resolution: 8k. meshy-7 och latest genererar inte en emissionsmapp.
Name
texture_resolution
Type
string
standard 2k
Description
Upplösning för basfärgstextur. Antingen 2k (2048×2048), 4k (4096×4096) eller 8k (8192×8192). Högre upplösningar fångar mer ytdetalj.
4k och 8k kräver ai_model meshy-6, meshy-7 eller latest. Vid 8k genereras ingen emissionsmapp.
Name
hd_texture
Type
boolean
⚠ föråldrad
standard false
Description
Använd texture_resolution istället — motsvarar texture_resolution: "4k". När båda anges har texture_resolution prioritet.
Name
texture_prompt
Type
string
Description
Ange en textprompt för att styra texturprocessen. Max 800 tecken.
Name
texture_image_url
Type
string
Description
Ange en 2d-bild för att styra texturprocessen. Vi stöder för närvarande formaten .jpg, .jpeg och .png.
Det finns två sätt att ange bilden:
- Offentligt tillgänglig URL: En URL som är åtkomlig från det offentliga internet
- Data URI: En base64-kodad Data URI av bilden. Exempel på en Data URI: data:image/jpeg;base64,<your base64-encoded image data>
Bildtexturering fungerar eventuellt inte optimalt om det finns betydande geometriska skillnader mellan den ursprungliga assetet och den uppladdade bilden. Endast en av texture_image_url eller texture_prompt kan användas för att styra texturprocessen. Om båda parametrarna anges kommer texture_prompt som standard att användas för att texturera modellen.
Name
texture_image_urls
Type
string[]
Description
Ange 1 till 4 bilder som visar samma objekt från olika vinklar för att styra texturering. Den första bilden är den primära (front) vyn; ordningen på de återstående vyerna (vänster, bak, höger) spelar ingen roll.
Varje element accepterar samma format som texture_image_url (en offentligt tillgänglig URL eller en base64 Data URI, .jpg/.jpeg/.png).
Dessa bilder styr endast texturen och är oberoende av image_urls — de två listorna kan innehålla olika bilder och olika antal bilder.
Kräver ai_model meshy-7 eller latest. Kan inte kombineras med texture_image_url eller texture_prompt.

Name
should_remesh
Type
boolean
standard false (meshy-6), true (others)
Description
Styr om remesh-fasen ska aktiveras. För bästa modellkvalitet rekommenderar vi att sätta should_remesh till false.

Gäller endast när should_remesh = true

Name
topology
Type
string
standard triangle
Description
Ange topologin för den genererade modellen.
Tillgängliga värden:
- quad: Generera ett nät med övervägande quads.
- triangle: Generera ett decimerat triangelnät.
Name
target_polycount
Type
integer
standard 30,000
Description
Ange målantalet polygoner i den genererade modellen. Det faktiska antalet polygoner kan avvika från målet beroende på geometrins komplexitet.
Det giltiga värdeintervallet varierar beroende på användarnivå:
- 100 till 300 000 (inklusive)
Name
decimation_mode
Type
integer
Description
Aktivera adaptiv decimering genom att ange en polycount-nivå. När detta är satt ignoreras target_polycount.
Tillgängliga värden:
- 1: Adaptiv — ultra polygonantal.
- 2: Adaptiv — högt polygonantal.
- 3: Adaptiv — medium polygonantal.
- 4: Adaptiv — lågt polygonantal.
Name
save_pre_remeshed_model
Type
boolean
standard false
Description
När detta sätts till true lagrar Meshy också en extra GLB-fil innan remesh-fasen slutförs.

Name
symmetry_mode
Type
string
⚠ föråldrad
standard auto
Description
Föråldrad. Denna parameter påverkar inte längre utdatan.
Fältet symmetry_mode styr symmetribeteendet under modellgenereringsprocessen.
De giltiga värdena är:
- off: Inaktiverar symmetri.
- auto: Bestämmer och tillämpar automatiskt symmetri baserat på indatageometrin.
- on: Tvingar fram symmetri under generering.
Name
pose_mode
Type
string
standard ""
Description
Ange pose-mode för den genererade modellen.
Tillgängliga värden:
- a-pose: Generera modellen i en A-pose.
- t-pose: Generera modellen i en T-pose.
- "" (tom sträng): Ingen specifik pose tillämpas.
Name
is_a_t_pose
Type
boolean
⚠ föråldrad
standard false
Description
Använd pose_mode istället. Om modellen ska genereras i en A/T-pose.
Name
image_enhancement
Type
boolean
standard true
Description
Optimerar indatabilderna för bättre resultat. Sätt till false för att bevara indatabildernas exakta utseende utan någon stilbearbetning.
Stöds endast när ai_model är meshy-6, meshy-7 eller latest.
Name
remove_lighting
Type
boolean
standard true
Description
Tar bort highlights och skuggor från basfärgstexturen, vilket ger ett renare resultat som fungerar bättre med anpassade ljussättningar.
Stöds endast när ai_model är meshy-6, meshy-7 eller latest.
Name
moderation
Type
boolean
standard false
Description
När detta sätts till true granskas indatainnehållet automatiskt för potentiellt skadligt innehåll. Om skadligt innehåll upptäcks kommer uppgiften inte att gå vidare till generering.
Varje bild från image_urls och texten från texture_prompt kommer att granskas.
Name
target_formats
Type
string[]
Description
Anger vilka 3D-filformat som ska inkluderas i utdatan. Endast de begärda formaten kommer att genereras och returneras, vilket kan minska uppgiftens slutförandetid.
Tillgängliga värden: glb, obj, fbx, stl, usdz, 3mf
Om detta utelämnas genereras alla format förutom 3mf. 3mf inkluderas endast när det uttryckligen anges.
Name
auto_size
Type
boolean
standard false
Description
När detta sätts till true använder tjänsten AI-syn för att automatiskt uppskatta objektets verkliga höjd och ändra storlek på modellen därefter. Origo kommer som standard att vara bottom om inte origin_at uttryckligen anges.
Name
alpha_thumbnail
Type
boolean
standard false
Description
När detta sätts till true renderar uppgiften dessutom en version av förhandsgranskningen med transparent bakgrund (RGBA) och returnerar den som alpha_thumbnail_url i GET-svaret. Det befintliga fältet thumbnail_url förblir oförändrat.
Name
multi_view_thumbnails
Type
boolean
standard false
Description
När detta sätts till true renderar uppgiften dessutom fyra kardinalvyer som miniatyrer (front, höger, bak, vänster) och returnerar dem under thumbnail_urls i GET-svaret. Det befintliga fältet thumbnail_url är oförändrat och fortsätter att peka på framvyn, så befintliga klienter påverkas inte.
Lägger till ungefär 3 sekunder till uppgiftens svarstid.

Gäller endast när auto_size = true

Name
origin_at
Type
string
standard bottom
Description
Origots position när auto_size är aktiverat. Tillgängliga värden: bottom, center.

Returnerar

Egenskapen result i svaret innehåller uppgifts-id:t för den nyskapade Flera bilder till 3D-uppgiften.

Felläge

Name
400 - Bad Request
Description
Begäran var inte godtagbar. Vanliga orsaker:
- Saknad parameter: Antingen image_urls eller input_task_id måste anges.
- Ogiltig indatauppgift: input_task_id måste referera till en SUCCEEDED Text till bild-, Bild till bild- eller flervy-varianttuppgift.
- Ogiltigt antal bilder: image_urls måste innehålla mellan 1 och 4 bilder, och texture_image_urls mellan 1 och 4.
- Ogiltigt bildformat: En eller flera bilder i image_urls har format som inte stöds.
- Konflikterande texturindata: texture_image_urls kan inte kombineras med texture_image_url eller texture_prompt, och kräver should_texture: true.
- Modell stöds inte för flervy-textur: texture_image_urls kräver ai_model meshy-7 eller latest.
- Oåtkomlig URL: En eller flera element i image_urls eller texture_image_urls kunde inte hämtas.
Name
401 - Unauthorized
Description
Autentiseringen misslyckades. Kontrollera din API-nyckel.
Name
402 - Payment Required
Description
Otillräckliga credits för att utföra denna uppgift.
Name
429 - Too Many Requests
Description
Du har överskridit din hastighetsgräns.

Request

POST

/openapi/v1/multi-image-to-3d

# Simple request
curl https://api.meshy.ai/openapi/v1/multi-image-to-3d \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_urls": [
      "<your publicly accessible image url or base64-encoded data URI>",
      "<your second publicly accessible image url or base64-encoded data URI>"
    ]
  }'

# With PBR texturing and GLB format
curl https://api.meshy.ai/openapi/v1/multi-image-to-3d \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_urls": [
      "<your publicly accessible image url or base64-encoded data URI>",
      "<your second publicly accessible image url or base64-encoded data URI>"
    ],
    "should_texture": true,
    "enable_pbr": true,
    "target_formats": ["glb"]
  }'

Response

{
  "result": "018a210d-8ba4-705c-b111-1f1776f7f578"
}

GET/openapi/v1/multi-image-to-3d/:id

Hämta en Flera bilder till 3D-uppgift

Detta endpoint tillåter dig att hämta en Flera bilder till 3D-uppgift med ett giltigt uppgifts-id. Se The Multi-Image to 3D Task Object för att se vilka egenskaper som ingår i Flera bilder till 3D-uppgiftsobjektet.

Parametrar

Name
id
Type
path
Description
Unik identifierare för Flera bilder till 3D-uppgiften som ska hämtas.

Returnerar

Svaret innehåller Flera bilder till 3D-uppgiftsobjektet. Kontrollera The Multi-Image to 3D Task Object avsnittet för detaljer.

Request

GET

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578

curl https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "multi-image-to-3d",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
    "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
    "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
    "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
    "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
    "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX",
      "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 30
}

DELETE/openapi/v1/multi-image-to-3d/:id

Ta bort en Flera bilder till 3D-uppgift

Denna endpoint tar permanent bort en Flera bilder till 3D-uppgift, inklusive alla associerade modeller och data. Denna åtgärd är oåterkallelig.

Sökvägsparametrar

Name
id
Type
path
Description
ID för den Flera bilder till 3D-uppgift som ska tas bort.

Returnerar

Returnerar 200 OK vid framgång.

Request

DELETE

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// Returns 200 Ok on success.

GET/openapi/v1/multi-image-to-3d

Lista Flera bilder till 3D-uppgifter

Detta endpoint tillåter dig att hämta en lista över Flera bilder till 3D-uppgifter.

Parametrar

Valfria attribut

Name
page_num
Type
integer
Description
Sidnummer för paginering. Börjar och standard är 1.
Name
page_size
Type
integer
Description
Sidstorleksbegränsning. Standard är 10 objekt. Max tillåtet är 50 objekt.
Name
sort_by
Type
string
Description
Fält att sortera efter. Tillgängliga värden:
- +created_at: Sortera efter skapandetid i stigande ordning.
- -created_at: Sortera efter skapandetid i fallande ordning.

Returnerar

Returnerar en paginerad lista över The Multi-Image to 3D Task Objects.

Request

GET

/openapi/v1/multi-image-to-3d

curl https://api.meshy.ai/openapi/v1/multi-image-to-3d?page_size=10 \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "multi-image-to-3d",
    "model_urls": {
      "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
      "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
      "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
      "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
      "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
    "thumbnail_urls": {
      "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
      "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
      "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
      "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
    },
    "texture_prompt": "",
    "progress": 100,
    "started_at": 1692771667037,
    "created_at": 1692771650657,
    "expires_at": 1692771679037,
    "finished_at": 1692771669037,
    "status": "SUCCEEDED",
    "texture_urls": [
      {
        "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
        "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
        "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
        "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX",
        "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
      }
    ],
    "preceding_tasks": 0,
    "task_error": {

      "message": ""

    },

    "consumed_credits": 30
  }
]

GET/openapi/v1/multi-image-to-3d/:id/stream

Strömma en Flera bilder till 3D-uppgift

Detta endpoint strömmar realtidsuppdateringar för en Flera bilder till 3D-uppgift med hjälp av Server-Sent Events (SSE).

Parametrar

Name
id
Type
path
Description
Unikt identifierare för Flera bilder till 3D-uppgiften att strömma.

Returnerar

Returnerar en ström av Flera bilder till 3D-uppgiftsobjekt som Server-Sent Events.

För PENDING eller IN_PROGRESS uppgifter kommer svarströmmen endast att inkludera nödvändiga progress och status fält.

Request

GET

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578/stream

curl -N https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Error event example
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Message event examples illustrate task progress.
// For PENDING or IN_PROGRESS tasks, the response stream will not include all fields.
event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "multi-image-to-3d",
  "model_urls": {
  "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
  "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
  "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
  "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
  "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
  "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
  "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
  "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
  "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
  "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX",
      "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 30
}

The Multi-Image to 3D Task Object

Multi-Image to 3D Task-objektet är en arbetsenhet som Meshy håller reda på för att generera en 3D-modell från flera bilder (mellan 1 och 4 inklusive). Bilderna bör vara av samma objekt, gärna från olika vyer eller vinklar. Objektet har följande egenskaper:

Egenskaper

Name
id
Type
string
Description
Unik identifierare för uppgiften. Även om vi använder en k-sorterbar UUID för uppgifts-id som implementationsdetalj bör du inte göra några antaganden om formatet på id:t.
Name
type
Type
string
Description
Typ av Multi-Image to 3D-uppgift. Värdet är multi-image-to-3d.
Name
model_urls
Type
object
Description
Nedladdningsbar URL till den texturerade 3D-modellfilen som genereras av Meshy. Egenskapen för ett format utelämnas om formatet inte genererats, istället för att returnera en tom sträng.
- Name
  glb
  Type
  string
  Description
  Nedladdningsbar URL till GLB-filen.
- Name
  fbx
  Type
  string
  Description
  Nedladdningsbar URL till FBX-filen.
- Name
  obj
  Type
  string
  Description
  Nedladdningsbar URL till OBJ-filen.
- Name
  usdz
  Type
  string
  Description
  Nedladdningsbar URL till USDZ-filen.
- Name
  mtl
  Type
  string
  Description
  Nedladdningsbar URL till MTL-filen, som returneras tillsammans med OBJ-exporter när texturer finns.
- Name
  stl
  Type
  string
  Description
  Nedladdningsbar URL till STL-filen.
- Name
  3mf
  Type
  string
  Description
  Nedladdningsbar URL till 3MF-filen. Finns endast med när 3mf begärdes via target_formats.
- Name
  pre_remeshed_glb
  Type
  string
  Description
  Nedladdningsbar URL till den ursprungliga GLB-utdatan innan reptopologisering (remesh).
  Finns endast tillgänglig när uppgiften skapades med både should_remesh: true och save_pre_remeshed_model: true.
Name
thumbnail_url
Type
string
Description
Nedladdningsbar URL till miniatyrbilden av modellfilen. Motsvarar thumbnail_urls.front när den finns, och behålls för bakåtkompatibilitet.
Name
alpha_thumbnail_url
Type
string
Description
Nedladdningsbar URL till en version av thumbnail_url med transparent bakgrund (RGBA). Finns endast med när uppgiften skapades med alpha_thumbnail: true och den transparenta förhandsvisningen renderades framgångsrikt; annars utelämnas detta fält.
Name
thumbnail_urls
Type
object
Description
Nedladdningsbara URL:er för fyra kardinalvisningsminatyrer av den genererade 3D-modellen. Varje värde är en signerad URL till en 512×512 PNG-bild renderad med samma material och belysning som thumbnail_url. Praktiskt för att förhandsgranska modellen från flera vinklar i batch-pipelines utan att ladda ner GLB-filen.
Finns endast med när uppgiften skapades med multi_view_thumbnails: true och har nått SUCCEEDED. Äldre uppgifter och uppgifter som skapats utan detta val inkluderar inte detta fält.
- Name
  front
  Type
  string
  Description
  Vy från framsidan, 0° rotation kring den vertikala axeln (motsvarar thumbnail_url).
- Name
  right
  Type
  string
  Description
  Vy från höger, 90° rotation.
- Name
  back
  Type
  string
  Description
  Vy från baksidan, 180° rotation.
- Name
  left
  Type
  string
  Description
  Vy från vänster, 270° rotation.
Name
texture_prompt
Type
string
Description
Textprompten som användes för att styra textureringsprocessen.
Name
texture_image_urls
Type
string[]
Description
Nedladdningsbara URL:er till de texturreferensbilder som användes för att skapa uppgiften, i den ordning de tillhandahölls. Finns endast med när uppgiften skapades med texture_image_urls.
Name
ultra_mode
Type
boolean
Description
Återger ultra_mode-värdet som uppgiften skapades med. Finns endast med för meshy-7-uppgifter (eller latest) som explicit angav ultra_mode; utelämnas annars.
Name
progress
Type
integer
Description
Uppgiftens förlopp. Om uppgiften inte har startats ännu är denna egenskap 0. Så snart uppgiften har lyckats blir den 100.
Name
started_at
Type
timestamp
Description
Tidsstämpel för när uppgiften startades, i millisekunder. Om uppgiften inte har startats ännu är denna egenskap 0.
En tidsstämpel representerar antalet millisekunder som har förflutit sedan 1 januari 1970 UTC, i enlighet med standarden RFC 3339. Till exempel representeras fredagen den 1 september 2023 12:00:00 PM GMT som 1693569600000. Detta gäller för alla tidsstämplar i Meshy API.
Name
created_at
Type
timestamp
Description
Tidsstämpel för när uppgiften skapades, i millisekunder.
Name
expires_at
Type
timestamp
Description
Tidsstämpel för när uppgiftens resultat upphör att gälla, i millisekunder.
Name
finished_at
Type
timestamp
Description
Tidsstämpel för när uppgiften slutfördes, i millisekunder. Om uppgiften inte är slutförd ännu är denna egenskap 0.
Name
status
Type
string
Description
Uppgiftens status. Möjliga värden är ett av PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.
Name
texture_urls
Type
array
Description
En array av textur-URL-objekt som genereras från uppgiften. Normalt innehåller denna endast ett textur-URL-objekt. Varje textur-URL har följande egenskaper:
- Name
  base_color
  Type
  string
  Description
  Nedladdningsbar URL till bildens grundfärgskarta (base color map).
- Name
  metallic
  Type
  string
  Description
  Nedladdningsbar URL till metallic-kartans bild.
  Om uppgiften skapas med enable_pbr: false utelämnas denna egenskap.
- Name
  normal
  Type
  string
  Description
  Nedladdningsbar URL till normalmappens bild.
  Om uppgiften skapas med enable_pbr: false utelämnas denna egenskap.
- Name
  roughness
  Type
  string
  Description
  Nedladdningsbar URL till roughness-kartans bild.
  Om uppgiften skapas med enable_pbr: false utelämnas denna egenskap.
- Name
  emission
  Type
  string
  Description
  Nedladdningsbar URL till emission-kartans bild.
  Om uppgiften skapas med enable_pbr: false, eller om ai_model är meshy-5, utelämnas denna egenskap.
Name
preceding_tasks
Type
integer
Description
Antalet föregående uppgifter.
Värdet på detta fält är endast meningsfullt om uppgiftens status är PENDING.
Name
task_error
Type
object
Description
Feldetaljer för misslyckade uppgifter. Se Fel för den fullständiga referensen till task_error-objektet.
Name
consumed_credits
Type
integer
Description
Antalet credits som förbrukats av denna uppgift. Finns med när uppgiftens status är PENDING, IN_PROGRESS eller SUCCEEDED. Returnerar 0 för FAILED-uppgifter (credits återbetalas vid misslyckande).

Example Multi-Image to 3D Task Object

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "multi-image-to-3d",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
    "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
    "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
    "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
    "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
    "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX",
      "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 30,
}