Çoklu görselden 3D'ye API

Aynı nesnenin farklı açılardan çekilmiş bir ila dört görselinden bir 3D model oluşturun.

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

Çoklu görselden 3D'ye görevi oluşturma

Bir Çoklu görselden 3D'ye görevi oluşturur. Görev arka planda çalışır. Bir görevin genellikle ne kadar sürdüğünü öğrenmek için İşlem süreleri sayfasına bakın. Bir görevin sahip olduğu alanlar için Çoklu görselden 3D'ye görev nesnesi bölümüne bakın.

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 Ultra 2K geometry, 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>"
    ],
    "ai_model": "meshy-7.1",
    "geometry_resolution": "2k",
    "should_texture": true,
    "enable_pbr": true,
    "target_formats": ["glb"]
  }'

# Textured with Meshy N1 from the input images, the first as the front view
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 front view image url or base64-encoded data URI>",
      "<your back view image url or base64-encoded data URI>"
    ],
    "ai_model": "meshy-7.1",
    "texture_model": "meshy-n1"
  }'

Response

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

Parametreler

Name
input_task_id
Type
string
Zorunlu
Description
image_urls göndermediğiniz sürece zorunludur. Çoklu görünümlü bir görev dahil olmak üzere bir Metinden görsele veya Görselden görsele görevinin kimliği. Meshy, bir ila dört görselini girdi olarak kullanır. Görev, API ile oluşturduğunuz ve SUCCEEDED durumunda olan bir görev olmalıdır.

Name
image_urls
Type
array
Zorunlu
Description
input_task_id göndermediğiniz sürece zorunludur. Her biri genel bir URL veya data:image/jpeg;base64,<base64 ile kodlanmış görsel verileriniz> gibi bir Data URI olarak bir ila dört görsel. Her ikisini de gönderirseniz, Meshy input_task_id kullanır.
Her görsel, en fazla 20 MB boyutunda, her kenarı en az 32 piksel olan ve en fazla 178.956.970 piksel (genişlik × yükseklik) içeren bir .jpg, .jpeg, .png veya .webp dosyası olmalıdır. Dörtten fazla görsel 400 döndürür.
En iyi sonuçlar için görseller aynı nesneyi farklı açılardan göstermelidir. meshy-7.1 veya latest ile Meshy, ilk görseli ön görünüm olarak kullanır ve diğerlerinin sırası önemli değildir.

Name
ai_model
Type
string
varsayılan latest
Description
3D modeli oluşturan AI modeli.
Kullanılabilir değerler:
- latest: Meshy 7.1
- meshy-7.1
- meshy-6
- meshy-6-lite
- meshy-7: kullanımdan kaldırıldı, bunun yerine meshy-7.1 gönderin
Projenize hangi modelin uygun olduğunu, örneğin gerçek bir nesne veya bir 3D baskı için, görmek üzere Modeller sayfasına bakın.
Name
geometry_resolution
Type
string
varsayılan standard
Description
Ne kadar geometri detayı oluşturulacağı.
Kullanılabilir değerler:
- standard
- 2k: Ultra geçişini 2048³ çözünürlükte çalıştırır. meshy-7.1, latest veya kullanımdan kaldırılmış meshy-7 gerektirir.
Name
ultra_mode
Type
boolean
⚠ kullanımdan kaldırıldı
varsayılan false
Description
Bunun yerine geometry_resolution gönderin. ultra_mode: true, geometry_resolution: "2k" ile aynıdır.
Name
should_texture
Type
boolean
varsayılan true
Description
Dokuların oluşturulup oluşturulmayacağı. true, dokulu bir model döndürür ve false, doku adımını atlayıp dokusuz bir ağ döndürür.

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

Name
texture_model
Type
string
varsayılan depends on ai_model
Description
3D modeli aynı görev içinde birden fazla görünümden dokulandıran AI modeli. ai_model değeriniz için varsayılan doku modelini kullanmak üzere boş bırakın. Kredi maliyetini değiştirmez.
Kullanılabilir değerler:
- meshy-7: PBR haritaları ve 8K'ya kadar dokularla Meshy 7
- meshy-n1: yalnızca referans görsellerden 2K temel renk dokusu üreten Meshy N1
Her ai_model her ikisini de kabul eder. meshy-6 veya meshy-6-lite ile dokulu bir istek 400 döndürür, seçilen doku modelinin desteklemediği bir seçenek de aynı şekilde davranır. should_texture: false ile Meshy, texture_model parametresini yoksayar, ancak bilinmeyen bir değer yine de 400 döndürür.
meshy-n1 ile Meshy, texture_image_urls veya texture_image_url değerinden, ikisini de göndermediğinizde ise girdi görsellerinden dokulandırır. İlk görsel ön görünümdür. 7.999.999 üçgenden büyük oluşturulan bir model görevi başarısız kılar ve Meshy kredilerini iade eder.
Her doku modelinin ne yaptığını ve hangisinin seçileceğini öğrenmek için Modeller sayfasına bakın.
Name
enable_pbr
Type
boolean
varsayılan false
Description
Temel renge ek olarak metalik, pürüzlülük ve normal haritalarının da oluşturulup oluşturulmayacağı. Meshy 6 doku modeli ayrıca bir emisyon haritası oluşturur, ancak texture_resolution: 8k durumu hariç. texture_model: meshy-n1 ile true, 400 döndürür.
Name
texture_resolution
Type
string
varsayılan 2k
Description
Temel renk dokusunun boyutu. Daha büyük bir boyut daha fazla yüzey detayı yakalar.
Kullanılabilir değerler:
- 2k: 2048×2048
- 4k: 4096×4096
- 8k: 8192×8192
4k ve 8k, Meshy 7 veya Meshy 6 doku modelini gerektirir ve diğerleriyle 400 döndürür. 8k değerinde Meshy bir emisyon haritası oluşturmaz.
Name
hd_texture
Type
boolean
⚠ kullanımdan kaldırıldı
varsayılan false
Description
Bunun yerine texture_resolution gönderin. hd_texture: true, texture_resolution: "4k" ile aynıdır. Her ikisini de gönderirseniz, Meshy texture_resolution kullanır.
Name
texture_prompt
Type
string
Description
Dokuya rehberlik eden, en fazla 800 karakterlik metin. Daha uzun metin 400 döndürür. texture_model: meshy-n1 ile bunu göndermek 400 döndürür.
Name
texture_image_url
Type
string
Description
Dokuya rehberlik eden tek bir 2D görsel; genel bir URL veya data:image/jpeg;base64,<base64 ile kodlanmış görsel verileriniz> gibi bir Data URI olarak. Görsel, en fazla 20 MB boyutunda, her kenarı en az 32 piksel olan ve en fazla 178.956.970 piksel (genişlik × yükseklik) içeren bir .jpg, .jpeg, .png veya .webp dosyası olmalıdır.
Hem texture_image_url hem de texture_prompt gönderirseniz, Meshy texture_prompt kullanır. texture_model: meshy-n1 ile Meshy, bu görseli ön görünüm olarak kullanarak dokulandırır.
Görseldeki şekil, 3D modelden büyük ölçüde farklı olduğunda doku iyi çıkmayabilir.
Name
texture_image_urls
Type
string[]
Description
Dokuya rehberlik eden, nesnenin farklı görünümlerinden bir ila dört görsel. Meshy, ilk görseli ön görünüm olarak kullanır. Diğer görünümlerin (sol, arka, sağ) sırası önemli değildir.
Her görsel, texture_image_url ile aynı kurallara uyar. Genel bir URL veya Data URI olmalı; .jpg, .jpeg, .png veya .webp biçiminde, en fazla 20 MB boyutunda, her kenarı en az 32 piksel olan ve en fazla 178.956.970 piksel (genişlik × yükseklik) içeren bir dosya olmalıdır.
Bu görseller yalnızca dokuya rehberlik eder ve image_urls değerine bağlı değildir. İki liste farklı görseller ve farklı sayıda görsel içerebilir.
texture_image_urls, Meshy 7 veya Meshy N1 doku modelini gerektirir. Bunu şunlardan biriyle gönderin:
- meshy-7.1, latest veya kullanımdan kaldırılmış meshy-7 değerinde ai_model
- meshy-7 veya meshy-n1 değerinde texture_model
Bunu texture_image_url veya texture_prompt ile birlikte gönderemezsiniz.

Name
should_remesh
Type
boolean
varsayılan true (meshy-6-lite), false (other models)
Description
Oluşturmadan sonra modelin yeniden ağlanıp ağlanmayacağı. En yüksek kaliteli 3D model için false olarak ayarlayın.

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

Name
topology
Type
string
varsayılan triangle
Description
Yeniden ağlanan modelin yüzey tipi.
Kullanılabilir değerler:
- quad: dörtgen ağırlıklı bir ağ
- triangle: seyreltilmiş bir üçgen ağ
texture_model: meshy-n1 ile, model yeniden ağlandığında quad, 400 döndürür; meshy-6-lite bunu varsayılan olarak yapar.
Name
target_polycount
Type
integer
varsayılan 30000
Description
Hedeflenen yüzey sayısı, 100 ile 300000 arasında. Sonuç, modelin geometrisine bağlı olarak hedeften farklı olabilir. Aralık dışında bir değer 400 döndürür.
Name
decimation_mode
Type
integer
Description
Seviyeye göre uyarlanabilir yüzey sayısı. Bunu ayarladığınızda Meshy, target_polycount değerini yoksayar.
Kullanılabilir değerler:
- 1: ultra
- 2: yüksek
- 3: orta
- 4: düşük
Name
save_pre_remeshed_model
Type
boolean
varsayılan false
Description
Yeniden ağlamadan önceki GLB'nin de kaydedilip kaydedilmeyeceği; model_urls.pre_remeshed_glb içinde döndürülür.

Name
symmetry_mode
Type
string
⚠ kullanımdan kaldırıldı
varsayılan auto
Description
Boş bırakın. Çıktıyı etkilemez.
Kullanılabilir değerler:
- off: simetri yok
- auto: girdi geometrisine dayalı simetri
- on: zorunlu simetri
Name
pose_mode
Type
string
varsayılan ""
Description
Oluşturulan modelin pozu.
Kullanılabilir değerler:
- a-pose: A pozu
- t-pose: T pozu
- "" (boş dize): belirli bir poz yok
Name
is_a_t_pose
Type
boolean
⚠ kullanımdan kaldırıldı
varsayılan false
Description
Bunun yerine pose_mode gönderin. Modelin A veya T pozunda oluşturulup oluşturulmayacağı.
Name
image_enhancement
Type
boolean
varsayılan true
Description
Oluşturmadan önce girdi görsellerinin optimize edilip edilmeyeceği. false, hiçbir stil işleme yapmadan girdi görsellerinin tam görünümünü korur. Yalnızca meshy-6, meshy-7.1 veya latest ile desteklenir. Bunu meshy-6-lite ile göndermek 400 döndürür.
Name
remove_lighting
Type
boolean
varsayılan true
Description
Temel renk dokusundan vurguların ve gölgelerin kaldırılıp kaldırılmayacağı. Daha temiz sonuç, kendi aydınlatmanız altında daha iyi çalışır. Bunu yalnızca Meshy 6 doku modeli kullanır ve texture_resolution: 8k durumunda her zaman aydınlatmayı kaldırır. texture_model: meshy-n1 ile true, 400 döndürür. ai_model: meshy-6-lite ve onun varsayılan doku modeliyle bunu göndermek 400 döndürür.
Name
moderation
Type
boolean
varsayılan false
Description
Girdilerin zararlı içerik için taranıp taranmayacağı. Meshy, her girdi görselini, texture_image_url değerini veya texture_image_urls içindeki her görseli ve texture_prompt içindeki metni tarar. Meshy zararlı içerik bulursa, istek 400 döndürür ve Meshy bir görev oluşturmaz.
Name
target_formats
Type
string[]
Description
Oluşturulacak 3D dosya biçimleri. Meshy yalnızca listelediğiniz biçimleri oluşturur ve döndürür; bu da görevi kısaltabilir.
Kullanılabilir değerler:
- glb
- obj
- fbx
- stl
- usdz
- 3mf
Boş bırakırsanız, Meshy 3mf dışındaki her biçimi oluşturur. Meshy, yalnızca onu listelediğinizde 3mf oluşturur.
Name
auto_size
Type
boolean
varsayılan false
Description
Nesnenin gerçek dünyadaki yüksekliğinin AI görüşü ile tahmin edilip modelin buna göre yeniden boyutlandırılıp boyutlandırılmayacağı. Meshy, origin_at ayarlamadığınız sürece orijini alta yerleştirir.

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

Name
origin_at
Type
string
varsayılan bottom
Description
Modelin orijininin nereye yerleştirileceği, bottom veya center.

Name
alpha_thumbnail
Type
boolean
varsayılan false
Description
Şeffaf arka planlı (RGBA) bir önizlemenin de oluşturulup oluşturulmayacağı; görevi aldığınızda alpha_thumbnail_url içinde döndürülür. thumbnail_url değişmez.
Name
multi_view_thumbnails
Type
boolean
varsayılan false
Description
Ön, sağ, arka ve sol önizlemelerin de oluşturulup oluşturulmayacağı; görevi aldığınızda thumbnail_urls içinde döndürülür. thumbnail_url değişmez ve hâlâ ön görünümü gösterir. Bu, göreve yaklaşık 5 saniye ekler.

Dönüş Değerleri

Yanıtın result alanı, yeni Çoklu görselden 3D'ye görevinin kimliğini tutar.

Hata durumları

Name
400 - Bad Request
Description
İstek çalıştırılamaz. Hata mesajı hangi sorunu bulduğunu belirtir. Örneğin:
- Eksik parametre: Ne image_urls ne de input_task_id gönderildi.
- Geçersiz girdi görevi: input_task_id, SUCCEEDED durumunda bir Metinden görsele veya Görselden görsele görevi, ya da çoklu görünümlü bir görev değil.
- Geçersiz görsel sayısı: image_urls veya texture_image_urls, 1 ila 4 görsel içermiyor.
- Geçersiz görsel biçimi: image_urls içindeki bir görsel desteklenen bir biçimde değil.
- Çakışan doku girdileri: texture_image_urls, texture_image_url ile, texture_prompt ile veya should_texture: false ile birlikte gönderildi.
- Çoklu görünüm dokusu için desteklenmeyen model: texture_image_urls, meshy-6 veya meshy-6-lite değerinde ai_model ile gönderildi, texture_model meshy-7 veya meshy-n1 olmadığı sürece.
- Ulaşılamayan URL: Meshy, image_urls veya texture_image_urls içindeki bir görseli indiremiyor.
- Görsel çok büyük: image_urls, texture_image_url veya texture_image_urls içindeki bir görsel 20 MB'den büyük.
- Geçersiz görsel boyutu: image_urls, texture_image_url veya texture_image_urls içindeki bir görselin bir kenarı 32 pikselden kısa veya 178.956.970 pikselden (genişlik × yükseklik) fazla.
- Çoklu görsel girdisi için desteklenmeyen çözünürlük: geometry_resolution, bu uç noktanın desteklemediği "4k" değerinde. 2k veya standard kullanın.
- Görsel seçenekleri için desteklenmeyen model: image_enhancement, ai_model: "meshy-6-lite" ile gönderildi, veya remove_lighting, ai_model: "meshy-6-lite" ve onun varsayılan doku modeliyle gönderildi.
- Geçersiz doku modeli: texture_model, geçerli bir doku modeli adı değil.
- Doku modeli kullanılamıyor: Dokulu bir istek, meshy-6 veya meshy-6-lite değerinde texture_model gönderdi. Çoklu görselden 3D'ye, yalnızca birden fazla görünümden dokulandıran doku modellerini kabul eder. meshy-7 veya meshy-n1 gönderin, ya da texture_model değerini boş bırakın.
- Doku modeli için desteklenmeyen seçenek: İstek, doku modelinden desteklemediği bir seçenek istiyor, örneğin meshy-n1 ile enable_pbr: true veya meshy-6-lite ile 4k doku. Modeller sayfasına bakın.
İsteği düzeltip yeniden gönderin. Hatalar sayfasına bakın.
Name
401 - Unauthorized
Description
API anahtarı eksik veya geçersiz. Authorization başlığını kontrol edin.
Name
402 - Payment Required
Description
Örneğin:
- Yetersiz kredi: Hesapta bu görev için yeterli kredi yok veya hesap bir kredi sınırına ulaştı. Kredi bakiyenizi kontrol edip yeniden deneyin.
- Ücretsiz plan: Bir görev oluşturmak ücretli bir plan gerektirir. Abonelik ayarlarınızdan planınızı yükseltip yeniden deneyin.
Name
403 - Forbidden
Description
İçerik denetimi, prompt'u veya bir girdi görselini engelledi. Girdiyi değiştirip yeniden deneyin.
Name
404 - Not Found
Description
input_task_id, görevlerinizden hiçbiriyle eşleşmiyor. Görev kimliğini kontrol edip isteği yeniden gönderin.
Name
429 - Too Many Requests
Description
Hız sınırınızı aştınız. Bekleyip yeniden deneyin. Hız sınırları sayfasına bakın.

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

Multi-Image to 3D görevini al

ID'sine göre bir Multi-Image to 3D görevini döndürür.

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"
    }
  ],
  "preceding_tasks": 0,
  "task_error": null,

  "consumed_credits": 30
}

Parametreler

Name
id
Type
path
Description
Oluşturma yanıtından alınan görev ID'si.

Dönüş Değerleri

Multi-Image to 3D görev nesnesi.

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

Bir Çoklu görselden 3D'ye görevini sil

Bir Çoklu görselden 3D'ye görevini, modelleri ve verileriyle birlikte kalıcı olarak siler. Bir silme işlemini geri alamazsınız.

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

// 200 OK on success, with an empty body.
//
// 409 Conflict when the task is IN_PROGRESS. The task keeps running:
{
  "message": "Task is IN_PROGRESS and cannot be deleted. Credits for a task the worker has already started are not refundable; wait for it to reach SUCCEEDED, FAILED or CANCELED, then delete it."
}

Yol parametreleri

Name
id
Type
path
Description
Silinecek görevin ID'si.

Görev durumu

PENDING durumundaki bir görevi silmek, görevi oluştururken kullanılan kredileri iade eder.

IN_PROGRESS durumundaki bir görev silinemez. İstek 409 Conflict döndürür ve görev çalışmaya devam eder. Meshy, başlamış olan bir görev için iade yapmaz, bu nedenle görevi silmek hem kredilerinize hem de sonuca mal olur. Görevin SUCCEEDED, FAILED veya CANCELED durumuna ulaşmasını bekleyin, ardından silin.

Son durumdaki (SUCCEEDED, FAILED veya CANCELED) bir görevi silmek kredilerini iade etmez.

Dönüş değerleri

Görev silindiğinde 200 OK, görev IN_PROGRESS durumundayken 409 Conflict döner.

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

Çoklu görselden 3D'ye görevlerini listele

Çoklu görselden 3D'ye görevlerinizin bir listesini döndürür.

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"
      }
    ],
    "preceding_tasks": 0,
    "task_error": null,

    "consumed_credits": 30
  }
]

Parametreler

Name
page_num
Type
integer
varsayılan 1
Description
Döndürülecek sayfa numarası, en fazla 255. Daha büyük bir değer 400 döndürür.
Name
page_size
Type
integer
varsayılan 10
Description
Sayfa başına görev sayısı, en fazla 100.
Name
sort_by
Type
string
Description
Sıralama düzeni.
Kullanılabilir değerler:
- +created_at: en eskiden en yeniye
- -created_at: en yeniden en eskiye

Döndürülenler

Çoklu görselden 3D'ye görev nesnelerinin sayfalanmış bir listesi.

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

Bir Çoklu görselden 3D'ye görevini akışa aktar

Bir Çoklu görselden 3D'ye görevinin güncellemelerini Server-Sent Events (SSE) olarak akışa aktarır.

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.
// These examples are shortened. Each event holds the full task object.
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"
    }
  ],
  "preceding_tasks": 0,
  "task_error": null,

  "consumed_credits": 30
}

Parametreler

Name
id
Type
path
Description
Oluşturma yanıtından alınan görev ID'si.

Dönüş Değerleri

Server-Sent Events olarak bir Çoklu görselden 3D'ye görev nesneleri akışı.

Her olay, Get uç noktasının döndürdüğü ile aynı biçimde, tam görev nesnesini içerir. Görev PENDING veya IN_PROGRESS durumundayken, sonuç alanlarının henüz değerleri yoktur.

Çoklu görselden 3D'ye görev nesnesi

Çoklu görselden 3D'ye görev nesnesi, bir nesnenin bir ila dört görselinden 3D model üretiminin bir örneğini tanımlar. Görev başarılı olduğunda durumu, progress değerini ve model dosyalarını tutar.

Özellikler

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"
    }
  ],
  "preceding_tasks": 0,
  "task_error": null,

  "consumed_credits": 30
}

Name
id
Type
string
Description
Görev ID'si. Bunu opak bir dize olarak kabul edin ve biçimine güvenmeyin.
Name
type
Type
string
Description
Görev türü, her zaman multi-image-to-3d.
Name
model_urls
Type
object
Description
Üretilen 3D model için indirme URL'leri, her dosya biçimi için bir tane. Görevin üretmediği bir biçimin, boş bir dize yerine hiç anahtarı yoktur.
- Name
  glb
  Type
  string
  Description
  GLB dosyası.
- Name
  fbx
  Type
  string
  Description
  FBX dosyası.
- Name
  obj
  Type
  string
  Description
  OBJ dosyası.
- Name
  usdz
  Type
  string
  Description
  USDZ dosyası.
- Name
  mtl
  Type
  string
  Description
  MTL dosyası, model dokulara sahip olduğunda OBJ dosyasıyla birlikte döndürülür.
- Name
  stl
  Type
  string
  Description
  STL dosyası.
- Name
  3mf
  Type
  string
  Description
  3MF dosyası. Yalnızca target_formats içinde 3mf bulunduğunda mevcuttur.
- Name
  pre_remeshed_glb
  Type
  string
  Description
  Yeniden ağ işleminden önceki GLB dosyası. Yalnızca görevi hem should_remesh: true hem de save_pre_remeshed_model: true ile oluşturduğunuzda mevcuttur.
Name
thumbnail_url
Type
string
Description
Modelin önizleme görseli için indirme URL'si. thumbnail_urls.front alanı mevcut olduğunda bununla aynıdır.
Name
alpha_thumbnail_url
Type
string
Description
thumbnail_url değerinin şeffaf arka planlı (RGBA) bir sürümü için indirme URL'si. Yalnızca görevi alpha_thumbnail: true ile oluşturduğunuzda ve Meshy şeffaf önizlemeyi render ettiğinde mevcuttur.
Name
thumbnail_urls
Type
object
Description
3D modelin dört taraftan önizlemeleri için indirme URL'leri. Her biri, thumbnail_url ile aynı materyaller ve aydınlatmayla render edilmiş 512×512 bir PNG için imzalı bir URL'dir. Bunları, GLB'yi indirmeden modeli birkaç açıdan önizlemek için kullanabilirsiniz.
Yalnızca görevi multi_view_thumbnails: true ile oluşturduğunuzda ve görev SUCCEEDED durumuna ulaştığında mevcuttur. multi_view_thumbnails: true olmadan oluşturulan bir görevde bu alan bulunmaz.
- Name
  front
  Type
  string
  Description
  Dikey eksen etrafında 0° açıdaki ön görünüm. thumbnail_url ile eşleşir.
- Name
  right
  Type
  string
  Description
  90° açıdaki sağ görünüm.
- Name
  back
  Type
  string
  Description
  180° açıdaki arka görünüm.
- Name
  left
  Type
  string
  Description
  270° açıdaki sol görünüm.
Name
texture_prompt
Type
string
Description
Dokuyu yönlendiren metin prompt'u.
Name
texture_image_urls
Type
string[]
Description
Görevi oluştururken kullandığınız doku referans görsellerinin, gönderdiğiniz sırayla indirme URL'leri. Yalnızca görevi texture_image_urls ile oluşturduğunuzda mevcuttur.
Name
ultra_mode
Type
boolean
⚠ kullanımdan kaldırıldı
Description
Bunun yerine geometry_resolution alanını okuyun.
Name
geometry_resolution
Type
string
Description
Görevin çalıştığı Ultra katmanı, yani 2k. Bir standard görevde bu alan bulunmaz.
Name
progress
Type
integer
Description
Görevin ne kadarının tamamlandığı, yüzde olarak. Görev başlayana kadar 0, başarılı olduğunda 100 değerindedir.
Name
started_at
Type
timestamp
Description
Görevin başladığı zaman, Unix milisaniye cinsinden. Görev başlayana kadar 0 değerindedir.
Name
created_at
Type
timestamp
Description
Görevin oluşturulduğu zaman, Unix milisaniye cinsinden.
Name
expires_at
Type
timestamp
Description
Görevin sonuçlarının süresinin dolduğu zaman, Unix milisaniye cinsinden.
Name
finished_at
Type
timestamp
Description
Görevin tamamlandığı zaman, Unix milisaniye cinsinden. Görev tamamlanana kadar 0 değerindedir.
Name
status
Type
string
Description
Görev durumu, PENDING, IN_PROGRESS, SUCCEEDED, FAILED veya CANCELED değerlerinden biridir.
Name
texture_urls
Type
array
Description
Görevin ürettiği doku haritaları için indirme URL'leri, nesnelerden oluşan bir dizi olarak. Genellikle tek bir nesne içerir. Her nesnede şu alanlar bulunur:
- Name
  base_color
  Type
  string
  Description
  Temel renk haritası.
- Name
  metallic
  Type
  string
  Description
  Metalik harita. Görevi enable_pbr: false ile oluşturduğunuzda dahil edilmez.
- Name
  normal
  Type
  string
  Description
  Normal harita. Görevi enable_pbr: false ile oluşturduğunuzda dahil edilmez.
- Name
  roughness
  Type
  string
  Description
  Pürüzlülük haritası. Görevi enable_pbr: false ile oluşturduğunuzda dahil edilmez.
- Name
  emission
  Type
  string
  Description
  Emisyon haritası. Yalnızca görevi şunların tümüyle oluşturduğunuzda dahil edilir:
  
  ai_model: meshy-6, varsayılan doku modeliyle
  
  enable_pbr: true
  
  2k veya 4k değerinde bir texture_resolution
Name
preceding_tasks
Type
integer
Description
Kuyrukta bu görevden önce bekleyen görev sayısı. Bu değer yalnızca görev PENDING durumundayken anlamlıdır.
Name
task_error
Type
object
Description
Görev başarısız olduğunda hata ayrıntıları. Durum FAILED olmadığı sürece null değerindedir. Hatalar bölümüne bakın.
Name
consumed_credits
Type
integer
Description
Görevin kullandığı kredi sayısı. Durum PENDING, IN_PROGRESS veya SUCCEEDED olduğunda mevcuttur. Meshy, bir görev başarısız olduğunda kredileri iade ettiği için FAILED bir görevde bu değer 0'dır.