Çoklu Görselden 3D'ye API

Çoklu Görselden 3D'ye API, Meshy'nin Çoklu Görselden 3D'ye dönüşüm yeteneklerini kendi uygulamanıza entegre etmenize olanak tanıyan bir özelliktir. Bu bölümde, bu API'yi kullanmaya başlamak için ihtiyacınız olan tüm bilgileri bulacaksınız.

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

Çoklu Görselden 3D'ye Görev Oluştur

Bu uç nokta, yeni bir Çoklu Görselden 3D'ye görev oluşturmanıza olanak tanır. Çoklu Görselden 3D'ye görev nesnesiyle hangi özelliklerin dahil olduğ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 iki değer de sağlanırsa, öncelik input_task_id'ye verilir.

Name
input_task_id
Type
string
Zorunlu
Description
Çıktısı (1-4 resim) girdi olarak kullanılacak tamamlanmış bir görüntü-üretim görevine ait kimlik. Bu 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, bu görev API üzerinden çalıştırılmış olmalı ve SUCCEEDED durumuna sahip olmalıdır.

Name
image_urls
Type
array
Zorunlu
Description
Model oluşturma için Meshy'nin kullanacağı 1 ila 4 resim sağlayın. Şu formatları destekliyoruz: .jpg, .jpeg ve .png. En iyi sonuçlar için tüm resimler aynı nesneyi farklı açılardan göstermelidir.
Her resmi sağlamak için iki yol vardır:
- Herkese açık erişilebilir URL: Genel internetten erişilebilen bir URL.
- Data URI: Resmin base64 kodlamalı bir veri URI'sı. Bir veri URI örneği: data:image/jpeg;base64,<your base64-encoded image data>.
meshy-7 (veya latest) için, ilk resim ana (ön) görünüm olarak kullanılır. Kalan resimlerin sırası önemli değildir.

Name
ai_model
Type
string
varsayılan latest
Description
Kullanılacak modelin kimliği. Mevcut değerler: meshy-5, meshy-6, meshy-7, latest (Meshy 7).
Name
should_texture
Type
boolean
varsayılan true
Description
Dokuların oluşturulup oluşturulmayacağını belirler. false olarak ayarlandığında doku aşaması atlanır ve dokusuz bir ağ sağlanır.

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

Name
enable_pbr
Type
boolean
varsayılan false
Description
PBR Haritaları (metalik, pürüzlülük, normal) temel renk haritasına ek olarak üretir. Emisyon haritası yalnızca ai_model meshy-6 olduğunda ve texture_resolution 8k olmadığında 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
texture_resolution yerine kullanılmalıdır — texture_resolution: "4k"'ya eşdeğer. Her ikisi de ayarlandığında, texture_resolution önceliklidir.
Name
texture_prompt
Type
string
Description
Doku oluşturma sürecini yönlendirmek için bir metin girdisi sağlayın. Maksimum 600 karakter.
Name
texture_image_url
Type
string
Description
Doku oluşturmada yönlendirmesi için 2D bir resim sağlayın. Şu anda .jpg, .jpeg ve .png formatlarını destekliyoruz.
Resmi sağlamak için iki yol:
- Herkese açık erişilebilir URL: Genel internetten erişilebilen bir URL.
- Data URI: Resmin base64 kodlamalı bir veri URI'sı. Örnek veri URI: data:image/jpeg;base64,<your base64-encoded image data>.
Resim dokulama, orijinal varlık ile yüklenmiş resim arasındaki geometri farkları büyükse en iyi şekilde çalışmayabilir. Yalnızca texture_image_url veya texture_prompt dokulama sürecini yönlendirmek için kullanılabilir. Her iki parametre de sağlanırsa, varsayılan olarak texture_prompt modeli dokulamak için kullanılır.

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 modeli almak 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.
Mevcut değerler:
- quad: Dörtgen ağırlıklı bir ağ üretir.
- triangle: Azaltılmış bir üçgen ağı üretir.
Name
target_polycount
Type
integer
varsayılan 30,000
Description
Oluşturulan modelin hedef poligon sayısını belirtin. Geometrinin karmaşıklığına bağlı olarak gerçek poligon sayısı hedeften sapabilir.
Kullanıcı katmanına bağlı olarak geçerli değer aralığı değişir:
- 100 ila 300,000 (dahil)
Name
decimation_mode
Type
integer
Description
Poligon sayısı seviyesini belirleyerek adaptif seyreltmeyi etkinleştirir. Ayarlandığında, target_polycount göz ardı edilir.
Mevcut değerler:
- 1: Adaptif — ultra poligon sayısı.
- 2: Adaptif — yüksek poligon sayısı.
- 3: Adaptif — orta poligon sayısı.
- 4: Adaptif — düşük poligon sayısı.
Name
save_pre_remeshed_model
Type
boolean
varsayılan false
Description
true olarak ayarlandığında, Meshy yeniden ağ aşaması tamamlanmadan önce ek bir GLB dosyası da depolar.

Name
symmetry_mode
Type
string
⚠ kullanımdan kaldırıldı
varsayılan auto
Description
Kullanımdan kaldırıldı. Bu parametre artık çıktıyı etkilemez.
symmetry_mode alanı, model oluşturma sürecinde simetri davranışını kontrol eder.
Geçerli değerler:
- off: Simetriyi devre dışı bırakır.
- auto: Girdi geometrisine dayalı olarak otomatik olarak simetri belirler ve uygular.
- on: Oluşturma süresince simetri sağlar.
Name
pose_mode
Type
string
varsayılan ""
Description
Oluşturulan model için poz modunu belirleyin.
Mevcut değerler:
- a-pose: Modeli A duruşunda oluşturur.
- t-pose: Modeli T duruşunda oluşturur.
- "" (boş string): Belirli bir poz uygulanmaz.
Name
is_a_t_pose
Type
boolean
⚠ kullanımdan kaldırıldı
varsayılan false
Description
pose_mode kullanın. Modelin A/T pozunda mı oluşturulacağı.
Name
image_enhancement
Type
boolean
varsayılan true
Description
Daha iyi sonuçlar için giriş resimlerini optimize eder. Giriş resimlerinin tam görünümünü korumak için false olarak ayarlayın ve herhangi bir stil işleme yapmadan bırakı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 dokusundan parlaklıkları ve gölgeleri kaldırır, özel aydınlatma düzenekleri altında daha iyi çalışan daha temiz bir sonuç verir.
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, giriş içeriği otomatik olarak potansiyel zararlı içerik açısından taranacaktır. Zararlı içerik tespit edilirse, görev oluşturulmaya devam etmeyecektir.
image_urls'dan gelen her resim ve texture_prompt'tan gelen metin taranacaktır.
Name
target_formats
Type
string[]
Description
Çıkışa dahil edilecek 3D dosya formatlarını belirtir. Yalnızca istenen formatlar oluşturulacak ve döndürülecektir, bu da görev tamamlama süresini azaltabilir.
Mevcut 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 AI vizyonunu kullanarak nesnenin gerçek dünya yüksekliğini otomatik olarak tahmin eder ve modeli buna göre yeniden boyutlandırır. Orijin origin_at açıkça ayarlanmadığı sürece varsayılan olarak bottom olarak ayarlanır.
Name
alpha_thumbnail
Type
boolean
varsayılan false
Description
true olarak ayarlandığında, görev ön izlemenin şeffaf arka planlı (RGBA) bir sürümünü ek olarak oluşturur ve GET yanıtında alpha_thumbnail_url olarak döndürür. Mevcut thumbnail_url alanı değişmeden kalır.
Name
multi_view_thumbnails
Type
boolean
varsayılan false
Description
true olarak ayarlandığında, görev dört ana görünüm küçük resimlerini (ön, sağ, arka, sol) ek olarak oluşturur ve GET yanıtında thumbnail_urls altında döndürür. Mevcut thumbnail_url alanı değişmeden kalır ve ön görünüme işaret etmeye devam eder, bu nedenle mevcut istemciler etkilenmez.
Göreve yaklaşık 3 saniye gecikme ekler.

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

Name
origin_at
Type
string
varsayılan bottom
Description
auto_size etkinleştirildiğinde orijinin konumu. Mevcut değerler: bottom, center.

Dönenler

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

Başarısızlık Modları

Name
400 - Kötü İstek
Description
İstek kabul edilemezdi. Yaygın nedenler:
- Eksik parametre: Ya image_urls ya da input_task_id sağlanmalıdır.
- Geçersiz görev girişi: input_task_id, SUCCEEDED Metinden Görsele, Görselden Görsele veya çoklu görünüm varyant görevine ait olmalıdır.
- Geçersiz resim sayısı: image_urls, 1 ile 4 arasında resim içermelidir.
- Geçersiz resim formatı: image_urls'da bulunan bir veya daha fazla resim desteklenmeyen formatlarda.
- Erişilemeyen URL: Bir veya daha fazla image_urls indirilemedi.
Name
401 - Yetkisiz
Description
Kimlik doğrulama başarısız. API anahtarınızı kontrol edin.
Name
402 - Ödeme Gerekiyor
Description
Bu görevi gerçekleştirmek için yeterli krediniz yok.
Name
429 - Çok Fazla İstek
Description
Hız sınırınızı aştınız.

İstek

POST

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

# Basit istek
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>"
    ]
  }'

# PBR dokulama ve GLB formatıyla
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"]
  }'

Yanıt

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

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

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

Bu uç nokta, geçerli bir görev id verilen bir Çoklu Görselden 3D'ye görevi getirmenize olanak tanır. Çoklu Görselden 3D'ye Görev Nesnesiyle 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
Getirilmesi gereken Çoklu Görselden 3D'ye göreve özgü kimlik.

Dönenler

Yanıt, Çoklu Görselden 3D'ye görev nesnesini içerir. Ayrıntılar 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örev Sil

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

Yol Parametreleri

Name
id
Type
path
Description
Silinmesi gereken Çoklu Görselden 3D'ye göreve özgü kimlik.

Dönenler

Başarılı olduğunda 200 OK döndürür.

İ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

// Başarılı olduğunda 200 Ok döner.

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

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

Bu uç nokta, Çoklu Görselden 3D'ye görev listesini getirmenize olanak tanır.

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. Maksimum izin verilen değer 50 öğedir.
Name
sort_by
Type
string
Description
Sıralama için kullanılacak alan. Mevcut değerler:
- +created_at: Oluşturulma zamanına göre artan sırayla sıralama.
- -created_at: Oluşturulma zamanına göre azalan sırayla sıralama.

Dönenler

Çoklu Görselden 3D'ye Görev Nesneleri listesini sayfalanmış olarak döndürür.

İ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=***",
      "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
  }
]

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

Çoklu Görselden 3D'ye Görevi Yayınla

Bu uç nokta, Server-Sent Events (SSE) kullanarak gerçek zamanlı güncellemeler yayınlar.

Parametreler

Name
id
Type
path
Description
Yayınlanacak Çoklu Görselden 3D'ye görevin benzersiz kimliği.

Dönenler

Görev Nesnelerini, Server-Sent Events olarak bir akış olarak döndürür.

PENDING veya IN_PROGRESS görevleri 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ışı

// Hata olayı örneği
event: error
data: {
  "status_code": 404,
  "message": "Görev bulunamadı"
}

// Mesaj olayı örnekleri görev ilerlemesini gösterir.
// PENDING veya IN_PROGRESS görevleri için yanıt akışı tüm alanları içermez.
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 resimden (1 ile 4 dahil) bir 3D model oluşturmak için izlediği bir iş birimidir. Resimler aynı nesnenin, ideal olarak farklı görünümlerden veya açılardan çekilmiş olmalıdır. Nesne şu özelliklere sahiptir:

Özellikler

Name
id
Type
string
Description
Görev için benzersiz tanımlayıcı. Görev kimlikleri için uygulama detayında k-sıralanabilir bir UUID kullansak da kimlik formatı hakkında varsayımlarda bulunmamalısınız.
Name
type
Type
string
Description
Çoklu Görselden 3D'ye görevin türü. Değeri multi-image-to-3d'dir.
Name
model_urls
Type
object
Description
Meshy tarafından üretilen dokulu 3D model dosyasının indirilebilir URL'si. Format üretilmezse özellik boş bir string döndürmek yerine atlanır.
- Name
  glb
  Type
  string
  Description
  GLB dosyasının indirilebilir URL'si.
- Name
  fbx
  Type
  string
  Description
  FBX dosyasının indirilebilir URL'si.
- Name
  obj
  Type
  string
  Description
  OBJ dosyasının indirilebilir URL'si.
- Name
  usdz
  Type
  string
  Description
  USDZ dosyasının indirilebilir URL'si.
- Name
  mtl
  Type
  string
  Description
  OBJ dışa aktarımlarıyla birlikte döndürülmüş MTL dosyasının indirilebilir URL'si.
- Name
  stl
  Type
  string
  Description
  STL dosyasının indirilebilir URL'si.
- Name
  3mf
  Type
  string
  Description
  3MF dosyasının indirilebilir URL'si. Yalnızca 3mf target_formats aracılığıyla istendiğinde bulunur.
- Name
  pre_remeshed_glb
  Type
  string
  Description
  Yeniden ağlanmadan önceki orijinal GLB çıktısının indirilebilir URL'si.
  Yalnızca should_remesh: true ve save_pre_remeshed_model: true ile oluşturulan görevler için kullanılabilir.
Name
thumbnail_url
Type
string
Description
Model dosyasının küçük resim görüntüsünün indirilebilir URL'si. thumbnail_urls.front'e denk geldiğinde var olan uyumluluğu korur.
Name
alpha_thumbnail_url
Type
string
Description
thumbnail_url'ün şeffaf arka planlı (RGBA) sürümünün indirilebilir URL'si. Yalnızca görev alpha_thumbnail: true olarak oluşturulduğunda ve şeffaf ön izleme başarıyla renderlandığında bulunur; aksi halde bu alan atlanır.
Name
thumbnail_urls
Type
object
Description
Oluşturulan 3D modelin dört ana görünüm küçük resminin indirilebilir URL'leri. Her değer, thumbnail_url ile aynı malzeme ve aydınlatma kullanılarak 512×512 PNG olarak imzalanmış bir URL'dir. GLB indirmeden modelin birden fazla açıdan ön izlenmesi için toplu iş akışlarında kullanışlıdır.
Yalnızca görev multi_view_thumbnails: true ile oluşturulmuşsa ve SUCCEEDED durumuna ulaşmışsa bulunur. Eski görevler ve opt-in olmadan oluşturulan görevler bu alanı içermeyecektir.
- Name
  front
  Type
  string
  Description
  Ön görünüm, dikey eksen etrafında 0° döndürme (thumbnail_url ile eşleşir).
- Name
  right
  Type
  string
  Description
  Sağ görünüm, 90° döndürme.
- Name
  back
  Type
  string
  Description
  Arka görünüm, 180° döndürme.
- Name
  left
  Type
  string
  Description
  Sol görünüm, 270° döndürme.
Name
texture_prompt
Type
string
Description
Doku oluşturma sürecini yönlendirmek için kullanılan metin girdisi.
Name
progress
Type
integer
Description
Görevin ilerlemesi. Eğer görev henüz başlamadıysa, bu özellik 0 olacaktır. Görev başarıyla tamamlandığında bu 100 olacaktır.
Name
started_at
Type
timestamp
Description
Görevin başlatıldığı zaman damgası, milisaniye cinsinden. Eğer görev henüz başlamadıysa, bu özellik 0 olacaktır.
Bir zaman damgası, 1 Ocak 1970 UTC'den bu yana geçen milisaniye sayısını temsil eder ve RFC 3339 standardını takip eder. Örneğin, Cuma, 1 Eylül 2023 12:00:00 PM GMT, 1693569600000 olarak temsil edilir. Bu, Meshy API'nin tüm zaman damgaları için geçerlidir.
Name
created_at
Type
timestamp
Description
Görevin oluşturulduğu zaman damgası, milisaniye cinsinden.
Name
expires_at
Type
timestamp
Description
Görev sonucunun sona ereceği zaman damgası, milisaniye cinsinden.
Name
finished_at
Type
timestamp
Description
Görevin tamamlandığı zaman damgası, milisaniye cinsinden. Eğer 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'den biridir.
Name
texture_urls
Type
array
Description
Görevden üretilen doku URL nesnelerinin bir dizisi. Normalde bu yalnızca bir doku URL nesnesi içerir. Her doku URL'si, aşağıdaki özelliklere sahiptir:
- Name
  base_color
  Type
  string
  Description
  Temel renk harita görüntüsünün indirilebilir URL'si.
- Name
  metallic
  Type
  string
  Description
  Metalik harita görüntüsünün indirilebilir URL'si.
  Eğer görev enable_pbr: false ile oluşturulduysa, bu özellik atlanır.
- Name
  normal
  Type
  string
  Description
  Normal harita görüntüsünün indirilebilir URL'si.
  Eğer görev enable_pbr: false ile oluşturulduysa, bu özellik atlanır.
- Name
  roughness
  Type
  string
  Description
  Pürüzlülük harita görüntüsünün indirilebilir URL'si.
  Eğer görev enable_pbr: false ile oluşturulduysa, bu özellik atlanır.
- Name
  emission
  Type
  string
  Description
  Emisyon harita görüntüsünün indirilebilir URL'si.
  Eğer görev enable_pbr: false veya ai_model meshy-5 olarak ayarlandığında, 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 ise anlamlıdır.
Name
task_error
Type
object
Description
Başarısız görevler için hata detayları. Hatalar için tam task_error nesnesi referansını görmek için Hatalar bölümüne 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. Başarısız görevler için 0 döner (başarısızlık durumunda krediler iade edilir).

Çoklu Görselden 3D'ye Görev Nesnesi Örneği

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