Çoklu Görselden 3D'ye API

Çoklu Görselden 3D'ye API, Meshy'nin Çoklu Görselden 3D'ye yeteneklerini kendi uygulamanıza entegre etmenizi sağlayan bir özelliktir. Bu bölümde, bu API ile başlamanız için gereken tüm bilgileri bulacaksınız.

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

Bir Çoklu görselden 3D'ye Görevi Oluşturma

Bu uç nokta, yeni bir Çoklu görselden 3D'ye görevi oluşturmanızı sağlar. Çoklu görselden 3D'ye görev nesnesiyle birlikte hangi özelliklerin bulunduğunu görmek için Çoklu Görselden 3D'ye Görev Nesnesi bölümüne bakın.

Parametreler

input_task_id veya image_urls'den yalnızca biri gereklidir. Her ikisi de sağlanırsa, input_task_id önceliklidir.

Name
input_task_id
Type
string
Zorunlu
Description
Girdi olarak kullanılacak çıkışı (1-4 görsel) olan, tamamlanmış bir görsel oluşturma görevinin ID'si. Bu görev şu görevlerden biri olmalıdır: Metinden görsele, Görselden görsele, Metinden görsele Çoklu görünüm veya Görselden görsele Çoklu görünüm. Ayrıca, API üzerinden çalıştırılmış olmalı ve SUCCEEDED durumuna sahip olmalıdır.

Name
image_urls
Type
array
Zorunlu
Description
Meshy'nin model oluşturmada kullanması için 1 ile 4 arasında görsel sağlayın. Şu anda .jpg, .jpeg ve .png formatlarını destekliyoruz. En iyi sonuçlar için tüm görseller aynı nesneyi farklı açılardan göstermelidir.
Her görseli sağlamanın iki yolu vardır:
- Herkese açık erişilebilir URL: Genel internetten erişilebilen bir URL.
- Data URI: Görselin base64 ile kodlanmış bir data URI'si. Data URI örneği: data:image/jpeg;base64,<base64 ile kodlanmış görsel verileriniz>.
meshy-7 (veya latest) için ilk görsel birincil (ön) görünüm olarak kullanılır. Kalan görsellerin sırası önemli değildir.

Name
ai_model
Type
string
varsayılan latest
Description
Kullanılacak modelin ID'si. Kullanılabilir değerler: meshy-5, meshy-6, meshy-7, latest (Meshy 7).
Name
ultra_mode
Type
boolean
varsayılan false
Description
Daha ince yüzey detayına sahip, daha yüksek doğrulukta geometri için Ultra oluşturmayı etkinleştirir.
Yalnızca ai_model meshy-7 (veya latest) olduğunda desteklenir.
Name
should_texture
Type
boolean
varsayılan true
Description
Dokuların oluşturulup oluşturulmayacağını belirler. false olarak ayarlamak doku aşamasını atlar ve dokusuz bir ağ sağlar.

Yalnızca şu durumlarda geçerli should_texture = true

Name
enable_pbr
Type
boolean
varsayılan false
Description
Temel renge ek olarak PBR haritaları (metalik, pürüzlülük, normal) oluşturur. ai_model meshy-6 olduğunda, texture_resolution: 8k hariç, bir emisyon haritası da dahil edilir. meshy-7 ve latest emisyon haritası üretmez.
Name
texture_resolution
Type
string
varsayılan 2k
Description
Temel renk doku çözünürlüğü. 2k (2048×2048), 4k (4096×4096) veya 8k (8192×8192) değerlerinden biri. Daha yüksek çözünürlükler daha fazla yüzey detayı yakalar.
4k ve 8k, ai_model meshy-6, meshy-7 veya latest gerektirir. 8k değerinde emisyon haritası üretilmez.
Name
hd_texture
Type
boolean
⚠ kullanımdan kaldırıldı
varsayılan false
Description
Bunun yerine texture_resolution kullanın — texture_resolution: "4k" ile eşdeğerdir. Her ikisi de ayarlandığında, texture_resolution önceliklidir.
Name
texture_prompt
Type
string
Description
Dokulama sürecine yön vermek için bir metin prompt'u sağlayın. Maksimum 800 karakter.
Name
texture_image_url
Type
string
Description
Dokulama sürecine yön vermek için 2 boyutlu bir görsel sağlayın. Şu anda .jpg, .jpeg ve .png formatlarını destekliyoruz.
Görseli sağlamanın iki yolu vardır:
- Herkese açık erişilebilir URL: Genel internetten erişilebilen bir URL
- Data URI: Görselin base64 ile kodlanmış bir data URI'si. Data URI örneği: data:image/jpeg;base64,<base64 ile kodlanmış görsel verileriniz>
Orijinal asset ile yüklenen görsel arasında önemli geometri farklılıkları varsa görsel dokulama optimum şekilde çalışmayabilir. Dokulama sürecine yön vermek için texture_image_url veya texture_prompt'tan yalnızca biri kullanılabilir. Her iki parametre de sağlanırsa, model varsayılan olarak texture_prompt kullanılarak dokulanır.
Name
texture_image_urls
Type
string[]
Description
Dokulamaya yön vermek için aynı nesneyi farklı görünümlerden gösteren 1 ile 4 arasında görsel sağlayın. İlk görsel birincil (ön) görünümdür; kalan görünümlerin (sol, arka, sağ) sırası önemli değildir.
Her öğe, texture_image_url ile aynı formatları kabul eder (herkese açık erişilebilir bir URL veya base64 data URI, .jpg/.jpeg/.png).
Bu görseller yalnızca dokuya yön verir ve image_urls'den bağımsızdır — iki liste farklı görseller ve farklı sayıda görsel içerebilir.
ai_model meshy-7 veya latest gerektirir. texture_image_url veya texture_prompt ile birleştirilemez.

Name
should_remesh
Type
boolean
varsayılan false (meshy-6), true (others)
Description
Yeniden ağ aşamasının etkinleştirilip etkinleştirilmeyeceğini kontrol eder. En yüksek kaliteli model için should_remesh'i false olarak ayarlamanızı öneririz.

Yalnızca şu durumlarda geçerli should_remesh = true

Name
topology
Type
string
varsayılan triangle
Description
Oluşturulan modelin topology'sini belirtin.
Kullanılabilir değerler:
- quad: Çoğunlukla dörtgen (quad) bir ağ oluşturur.
- triangle: Sadeleştirilmiş bir üçgen ağ oluşturur.
Name
target_polycount
Type
integer
varsayılan 30,000
Description
Oluşturulan modeldeki hedef poligon sayısını belirtin. Gerçek poligon sayısı, geometrinin karmaşıklığına bağlı olarak hedeften farklı olabilir.
Geçerli değer aralığı kullanıcı katmanına bağlı olarak değişir:
- 100 ile 300.000 (dahil)
Name
decimation_mode
Type
integer
Description
Bir poligon sayısı seviyesi ayarlayarak uyarlanabilir sadeleştirmeyi etkinleştirin. Bu ayarlandığında, target_polycount göz ardı edilir.
Kullanılabilir değerler:
- 1: Uyarlanabilir — ultra poligon sayısı.
- 2: Uyarlanabilir — yüksek poligon sayısı.
- 3: Uyarlanabilir — orta poligon sayısı.
- 4: Uyarlanabilir — düşük poligon sayısı.
Name
save_pre_remeshed_model
Type
boolean
varsayılan false
Description
true olarak ayarlandığında, Meshy ayrıca yeniden ağ aşaması tamamlanmadan önce ek bir GLB dosyası saklar.

Name
symmetry_mode
Type
string
⚠ kullanımdan kaldırıldı
varsayılan auto
Description
Kullanımdan kaldırıldı. Bu parametre artık çıkışı etkilemez.
symmetry_mode alanı, model oluşturma süreci sırasında simetri davranışını kontrol eder.
Geçerli değerler:
- off: Simetriyi devre dışı bırakır.
- auto: Girdi geometrisine göre simetriyi otomatik olarak belirler ve uygular.
- on: Oluşturma sırasında simetriyi zorunlu kılar.
Name
pose_mode
Type
string
varsayılan ""
Description
Oluşturulan model için poz mode'unu belirtin.
Kullanılabilir değerler:
- a-pose: Modeli A pozunda oluşturur.
- t-pose: Modeli T pozunda oluşturur.
- "" (boş dize): Belirli bir poz uygulanmaz.
Name
is_a_t_pose
Type
boolean
⚠ kullanımdan kaldırıldı
varsayılan false
Description
Bunun yerine pose_mode kullanın. Modelin A/T pozunda oluşturulup oluşturulmayacağı.
Name
image_enhancement
Type
boolean
varsayılan true
Description
Daha iyi sonuçlar için girdi görsellerini optimize eder. Girdi görsellerinin herhangi bir stil işleme uygulanmadan tam görünümünü korumak için false olarak ayarlayın.
Yalnızca ai_model meshy-6, meshy-7 veya latest olduğunda desteklenir.
Name
remove_lighting
Type
boolean
varsayılan true
Description
Temel renk dokusundaki parlaklıkları ve gölgeleri kaldırarak, özel aydınlatma kurulumları altında daha iyi çalışan daha temiz bir sonuç üretir.
Yalnızca ai_model meshy-6, meshy-7 veya latest olduğunda desteklenir.
Name
moderation
Type
boolean
varsayılan false
Description
true olarak ayarlandığında, girdi içeriği potansiyel olarak zararlı içerik açısından otomatik olarak taranır. Zararlı içerik tespit edilirse görev oluşturma aşamasına geçmez.
image_urls'deki her görsel ve texture_prompt'taki metin taranacaktır.
Name
target_formats
Type
string[]
Description
Çıkışa hangi 3D dosya formatlarının dahil edileceğini belirtir. Yalnızca talep edilen formatlar oluşturulur ve döndürülür, bu da görevin tamamlanma süresini azaltabilir.
Kullanılabilir değerler: glb, obj, fbx, stl, usdz, 3mf
Belirtilmediğinde, 3mf hariç tüm formatlar oluşturulur. 3mf yalnızca açıkça belirtildiğinde dahil edilir.
Name
auto_size
Type
boolean
varsayılan false
Description
true olarak ayarlandığında, hizmet nesnenin gerçek dünya yüksekliğini otomatik olarak tahmin etmek için yapay zeka görüşünü kullanır ve modeli buna göre yeniden boyutlandırır. origin_at açıkça ayarlanmadıkça orijin varsayılan olarak bottom olacaktır.
Name
alpha_thumbnail
Type
boolean
varsayılan false
Description
true olarak ayarlandığında, görev ayrıca önizlemenin şeffaf arka planlı (RGBA) bir sürümünü oluşturur ve bunu GET yanıtında alpha_thumbnail_url olarak döndürür. Mevcut thumbnail_url alanı değişmez.
Name
multi_view_thumbnails
Type
boolean
varsayılan false
Description
true olarak ayarlandığında, görev ayrıca dört ana yön görünümü (ön, sağ, arka, sol) küçük resmi oluşturur ve bunları GET yanıtında thumbnail_urls altında döndürür. Mevcut thumbnail_url alanı değişmez ve ön görünüme işaret etmeye devam eder, bu nedenle mevcut istemciler etkilenmez.
Görev gecikme süresine yaklaşık 3 saniye ekler.

Yalnızca şu durumlarda geçerli auto_size = true

Name
origin_at
Type
string
varsayılan bottom
Description
auto_size etkinken orijin konumu. Kullanılabilir değerler: bottom, center.

Dönüş Değerleri

Yanıtın result özelliği, yeni oluşturulan Çoklu görselden 3D'ye görevinin id'sini içerir.

Hata Modları

Name
400 - Bad Request
Description
İstek kabul edilemedi. Yaygın nedenler:
- Eksik parametre: image_urls veya input_task_id'den biri sağlanmalıdır.
- Geçersiz girdi görevi: input_task_id, SUCCEEDED durumunda bir Metinden görsele, Görselden görsele veya çoklu görünüm varyantı görevine işaret etmelidir.
- Geçersiz görsel sayısı: image_urls 1 ile 4 arasında görsel içermeli, texture_image_urls ise 1 ile 4 arasında olmalıdır.
- Geçersiz görsel formatı: image_urls içindeki bir veya daha fazla görsel desteklenen formatlarda değil.
- Çakışan doku girdileri: texture_image_urls, texture_image_url veya texture_prompt ile birleştirilemez ve should_texture: true gerektirir.
- Çoklu görünüm dokusu için desteklenmeyen model: texture_image_urls, ai_model meshy-7 veya latest gerektirir.
- Erişilemeyen URL: image_urls veya texture_image_urls içindeki bir veya daha fazla öğe indirilemedi.
Name
401 - Unauthorized
Description
Kimlik doğrulama başarısız oldu. Lütfen API anahtarınızı kontrol edin.
Name
402 - Payment Required
Description
Bu görevi gerçekleştirmek için yetersiz kredi.
Name
429 - Too Many Requests
Description
Hız sınırınızı aştınız.

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

Çoklu Görselden 3D'ye Görevini Getir

Bu uç nokta, geçerli bir görev id verildiğinde Çoklu Görselden 3D'ye görevini getirmenizi sağlar. Çoklu Görselden 3D'ye görev nesnesi ile hangi özelliklerin dahil olduğunu görmek için Çoklu Görselden 3D'ye Görev Nesnesi bölümüne bakın.

Parametreler

Name
id
Type
path
Description
Getirilecek Çoklu Görselden 3D'ye görevinin benzersiz tanımlayıcısı.

Dönen Değerler

Yanıt, Çoklu Görselden 3D'ye görev nesnesini içerir. Detaylar için Çoklu Görselden 3D'ye Görev Nesnesi bölümüne bakın.

İstek

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}"

Yanıt

{
  "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

Çoklu görselden 3D'ye Görevi Sil

Bu uç nokta, ilişkili tüm modeller ve veriler dahil olmak üzere bir Çoklu görselden 3D'ye görevini kalıcı olarak siler. Bu işlem geri alınamaz.

Yol Parametreleri

Name
id
Type
path
Description
Silinecek Çoklu görselden 3D'ye görevinin ID'si.

Dönüşler

Başarı durumunda 200 OK döner.

İstek

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}"

Yanıt

// Returns 200 Ok on success.

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

Çoklu Görselden 3D'ye Görevleri Listele

Bu uç nokta, Çoklu Görselden 3D'ye görevlerinin bir listesini almanızı sağlar.

Parametreler

İsteğe bağlı özellikler

Name
page_num
Type
integer
Description
Sayfalama için sayfa numarası. 1 ile başlar ve varsayılan olarak 1'dir.
Name
page_size
Type
integer
Description
Sayfa boyutu sınırı. Varsayılan olarak 10 öğedir. İzin verilen maksimum 50 öğedir.
Name
sort_by
Type
string
Description
Sıralama yapılacak alan. Mevcut değerler:
- +created_at: Oluşturulma zamanına göre artan sırayla sıralar.
- -created_at: Oluşturulma zamanına göre azalan sırayla sıralar.

Dönen Değerler

Sayfalı bir Çoklu Görselden 3D'ye Görev Nesneleri listesi döner.

İstek

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}"

Yanıt

[
  {
    "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

Çoklu Görselden 3D'ye Görev Akışı

Bu uç nokta, Server-Sent Events (SSE) kullanarak Çoklu Görselden 3D'ye bir görev için gerçek zamanlı güncellemeler akışı sağlar.

Parametreler

Name
id
Type
path
Description
Akışı sağlanacak Çoklu Görselden 3D'ye görevinin benzersiz tanımlayıcısı.

Dönen Değerler

Server-Sent Events olarak Çoklu Görselden 3D'ye Görev Nesneleri akışı sağlar.

PENDING veya IN_PROGRESS durumundaki görevler için, yanıt akışı yalnızca gerekli progress ve status alanlarını içerecektir.

İstek

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}"

Yanıt Akışı

// 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
}

Çoklu Görselden 3D'ye Görev Nesnesi

Çoklu Görselden 3D'ye Görev nesnesi, Meshy'nin birden fazla görselden (1 ile 4 arası, dahil) bir 3D model oluşturmak için takip ettiği bir iş birimidir. Görseller aynı nesneye ait olmalı, ideal olarak farklı görünüm veya açılardan çekilmiş olmalıdır. Nesne aşağıdaki özelliklere sahiptir:

Özellikler

Name
id
Type
string
Description
Görev için benzersiz tanımlayıcı. Uygulama ayrıntısı olarak görev id'leri için k-sıralanabilir bir UUID kullansak da, id'nin formatı hakkında hiçbir varsayımda bulunmamalısınız.
Name
type
Type
string
Description
Çoklu Görselden 3D'ye görevinin türü. Değer multi-image-to-3d'dir.
Name
model_urls
Type
object
Description
Meshy tarafından oluşturulan dokulu 3D model dosyasına indirilebilir URL. Bir format oluşturulmadıysa, boş bir dize döndürmek yerine o formata ait özellik atlanır.
- Name
  glb
  Type
  string
  Description
  GLB dosyasına indirilebilir URL.
- Name
  fbx
  Type
  string
  Description
  FBX dosyasına indirilebilir URL.
- Name
  obj
  Type
  string
  Description
  OBJ dosyasına indirilebilir URL.
- Name
  usdz
  Type
  string
  Description
  USDZ dosyasına indirilebilir URL.
- Name
  mtl
  Type
  string
  Description
  Dokular mevcut olduğunda OBJ dışa aktarımlarıyla birlikte döndürülen MTL dosyasına indirilebilir URL.
- Name
  stl
  Type
  string
  Description
  STL dosyasına indirilebilir URL.
- Name
  3mf
  Type
  string
  Description
  3MF dosyasına indirilebilir URL. Yalnızca target_formats üzerinden 3mf talep edildiğinde bulunur.
- Name
  pre_remeshed_glb
  Type
  string
  Description
  Yeniden örgülemeden (remesh) önceki orijinal GLB çıkışına indirilebilir URL.
  Yalnızca görev, hem should_remesh: true hem de save_pre_remeshed_model: true ile oluşturulduğunda kullanılabilir.
Name
thumbnail_url
Type
string
Description
Model dosyasının küçük resmine indirilebilir URL. Mevcut olduğunda thumbnail_urls.front ile eşdeğerdir, geriye dönük uyumluluk için tutulmaktadır.
Name
alpha_thumbnail_url
Type
string
Description
thumbnail_url'ın şeffaf arka plana (RGBA) sahip bir sürümüne indirilebilir URL. Yalnızca görev alpha_thumbnail: true ile oluşturulduğunda ve şeffaf önizleme başarıyla oluşturulduğunda bulunur; aksi takdirde bu alan atlanır.
Name
thumbnail_urls
Type
object
Description
Oluşturulan 3D modelin dört ana yön küçük resmine indirilebilir URL'ler. Her değer, thumbnail_url ile aynı materyaller ve aydınlatmayla render edilmiş 512×512 boyutunda bir PNG'ye ait imzalı bir URL'dir. GLB'yi indirmeden toplu iş hatlarında modeli birden çok açıdan önizlemek için kullanışlıdır.
Yalnızca görev multi_view_thumbnails: true ile oluşturulduğunda ve SUCCEEDED durumuna ulaştığında bulunur. Daha eski görevler ve bu seçenek etkinleştirilmeden oluşturulan görevler bu alanı içermez.
- Name
  front
  Type
  string
  Description
  Ön görünüm, dikey eksen etrafında 0° dönüş (thumbnail_url ile eşleşir).
- Name
  right
  Type
  string
  Description
  Sağ görünüm, 90° dönüş.
- Name
  back
  Type
  string
  Description
  Arka görünüm, 180° dönüş.
- Name
  left
  Type
  string
  Description
  Sol görünüm, 270° dönüş.
Name
texture_prompt
Type
string
Description
Doku oluşturma sürecini yönlendirmek için kullanılan metin prompt'u.
Name
texture_image_urls
Type
string[]
Description
Görevi oluşturmak için kullanılan doku referans görsellerine, sağlanma sırasına göre indirilebilir URL'ler. Yalnızca görev texture_image_urls ile oluşturulduğunda bulunur.
Name
ultra_mode
Type
boolean
Description
Görevin oluşturulduğu ultra_mode değerini yansıtır. Yalnızca ultra_mode'u açıkça ayarlayan meshy-7 (veya latest) görevleri için bulunur; aksi takdirde atlanır.
Name
progress
Type
integer
Description
Görevin ilerleme durumu. Görev henüz başlamadıysa, bu özellik 0 olacaktır. Görev başarılı olduğunda bu değer 100 olacaktır.
Name
started_at
Type
timestamp
Description
Görevin başladığı zamanın milisaniye cinsinden zaman damgası. Görev henüz başlamadıysa, bu özellik 0 olacaktır.
Bir zaman damgası, RFC 3339 standardını takip ederek 1 Ocak 1970 UTC'den itibaren geçen milisaniye sayısını temsil eder. Örneğin, 1 Eylül 2023 Cuma günü 12:00:00 (GMT) 1693569600000 olarak temsil edilir. Bu, Meshy API'deki tüm zaman damgaları için geçerlidir.
Name
created_at
Type
timestamp
Description
Görevin oluşturulduğu zamanın milisaniye cinsinden zaman damgası.
Name
expires_at
Type
timestamp
Description
Görev sonucunun süresinin dolacağı zamanın milisaniye cinsinden zaman damgası.
Name
finished_at
Type
timestamp
Description
Görevin tamamlandığı zamanın milisaniye cinsinden zaman damgası. Görev henüz tamamlanmadıysa, bu özellik 0 olacaktır.
Name
status
Type
string
Description
Görevin durumu. Olası değerler PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED'dan biridir.
Name
texture_urls
Type
array
Description
Görevden oluşturulan doku URL nesnelerinin bir dizisi. Normalde bu, yalnızca bir doku URL nesnesi içerir. Her doku URL'sinin aşağıdaki özellikleri vardır:
- Name
  base_color
  Type
  string
  Description
  Temel renk haritası görseline indirilebilir URL.
- Name
  metallic
  Type
  string
  Description
  Metalik harita görseline indirilebilir URL.
  Görev enable_pbr: false ile oluşturulmuşsa, bu özellik atlanır.
- Name
  normal
  Type
  string
  Description
  Normal harita görseline indirilebilir URL.
  Görev enable_pbr: false ile oluşturulmuşsa, bu özellik atlanır.
- Name
  roughness
  Type
  string
  Description
  Pürüzlülük haritası görseline indirilebilir URL.
  Görev enable_pbr: false ile oluşturulmuşsa, bu özellik atlanır.
- Name
  emission
  Type
  string
  Description
  Emisyon haritası görseline indirilebilir URL.
  Görev enable_pbr: false ile oluşturulmuşsa veya ai_model meshy-5 ise, bu özellik atlanır.
Name
preceding_tasks
Type
integer
Description
Önceki görevlerin sayısı.
Bu alanın değeri yalnızca görev durumu PENDING olduğunda anlamlıdır.
Name
task_error
Type
object
Description
Başarısız görevler için hata ayrıntıları. Tam task_error nesne referansı için Hatalar'a bakın.
Name
consumed_credits
Type
integer
Description
Bu görev tarafından tüketilen kredi sayısı. Görev durumu PENDING, IN_PROGRESS veya SUCCEEDED olduğunda bulunur. FAILED görevler için 0 döner (başarısızlık durumunda krediler iade edilir).

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,
}