Creative Lab — Buzdolabı Mıknatısı API

Fotoğraflarınızı özel buzdolabı mıknatıslarına dönüştürün — buzdolabı için boyutlandırılmış, yuvarlatılmış dikdörtgen renkli derinlik kabartması ve düz manyetik arka yüzey — iki aşamada: prototip giriş fotoğrafınızdan renkli bir konsept görüntü oluşturur, ardından yapı bu konsept görüntüyü kabartma bir 3D modele dönüştürür. İki aşama input_task_id aracılığıyla bağlantılıdır.

  • POST /openapi/creative-lab/fridge-magnet/v1/prototype
  • POST /openapi/creative-lab/fridge-magnet/v1/build
POST/openapi/creative-lab/fridge-magnet/v1/prototype

Buzdolabı Mıknatısı Prototip Görevi Oluştur

Kaynak fotoğraftan tek bir renklendirilmiş konsept görüntüsü oluşturun. Döndürülen görev kimliği, input_task_id olarak yapım uç noktasına ilettiğiniz şeydir. Yanıt yapısı için Buzdolabı Mıknatısı Prototip Görev Nesnesi bölümüne bakın.

Parametreler

  • Name
    image_url
    Type
    string
    Zorunlu
    Description

    Meshy'nin buzdolabı mıknatısına hazır bir konsept görüntüsüne renklendireceği kaynak fotoğraf. Şu anda .jpg, .jpeg, .png ve .webp formatlarını destekliyoruz.

    Görüntüyü sağlamak için iki yol vardır:

    • Herkese açık erişilebilir URL: Genel internetten erişilebilen bir URL.
    • Data URI: Görüntünün base64 ile kodlanmış bir veri URI'si. Bir veri URI örneği: data:image/jpeg;base64,<your base64-encoded image data>.
  • Name
    name
    Type
    string
    Description

    Görüntüleme amaçlı isteğe bağlı görev adı. Maksimum 100 karakter.

  • Name
    remove_background
    Type
    boolean
    varsayılan false
    Description

    true olarak ayarlandığında, prototip görüntü arka planı kaldırılmış olarak şeffaf RGBA PNG formatında döndürülür, böylece konuyu herhangi bir arka plana yerleştirebilirsiniz.

    Bu, yalnızca bu uç noktanın döndürdüğü görüntüyü kontrol eder. Arka plan kaldırmayı kabartmadan önce kontrol eden aynı isimdeki yapım seçeneğinden ayrıdır (varsayılan true).

Dönüşler

Yanıtın result özelliği, yeni oluşturulan buzdolabı mıknatısı prototip görevinin görev id'sini içerir. Görev SUCCEEDED durumuna ulaşana kadar Bir Görev Al uç noktasını sorgulayın veya akışa abone olun, ardından bu kimliği input_task_id olarak yapım uç noktasına iletin.

Başarısızlık Modları

  • Name
    400 - Bad Request
    Description

    İstek kabul edilemezdi. Yaygın nedenler:

    • Eksik parametre: image_url gereklidir.
    • Geçersiz görüntü formatı: Sağlanan image_url desteklenen bir formatta değil (.jpg, .jpeg, .png, .webp).
    • Görüntü boyutları aralık dışında: Görüntü çok küçük, maksimum dosya boyutunu aşıyor veya maksimum piksel sayısını aşıyor.
    • Ulaşılamayan URL: image_url indirilemedi (404 veya timeout).
    • Geçersiz Data URI: Base64 dizisi hatalı.
    • İçerik işaretlendi: Girdi görüntüsü NSFW veya fikri mülkiyet moderation tarafından işaretlendi.
  • 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.

İstek

POST
/openapi/creative-lab/fridge-magnet/v1/prototype
# Stage 1: generate a colorized fridge magnet concept image
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/prototype \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_url": "<your publicly accessible image url or base64-encoded data URI>"
  }'

Yanıt

{
  "result": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9"
}
Prototip örneği
Bir kaynak fotoğrafla başlayın, ardından buzdolabı mıknatısı yapım aşamasında kullanılan prototip görüntüsünü oluşturun.
Creative Lab Buzdolabı Mıknatısı girişi olarak kullanılan kaynak manzara fotoğrafı
Prototip girişi
Kaynak fotoğraftan üretilen Creative Lab Buzdolabı Mıknatısı prototip çıktısı
Prototip çıktısı
POST/openapi/creative-lab/fridge-magnet/v1/build

Buzdolabı Mıknatısı Yapı Görevi Oluştur

Başarılı bir prototip görevinden nihai 3D baskıya uygun buzdolabı mıknatısını oluşturun. Yapı, prototipin renklendirilmiş konsept görüntüsünde bir derinlik haritası rölyef hattı çalıştırır ve istediğiniz formatta tek bir ağ eseri gönderir. Yanıt yapısı için Buzdolabı Mıknatısı Yapı Görevi Nesnesi bölümüne bakın.

Parametreler

  • Name
    input_task_id
    Type
    string
    Zorunlu
    Description

    Aynı OpenAPI uç noktası aracılığıyla oluşturulmuş bir prototip görevinin görev kimliği. Prototip aynı API anahtarı ile oluşturulmuş olmalı, SUCCEEDED durumuna ulaşmış olmalı ve tam olarak bir aday görüntü üretmiş olmalıdır.

    Web uygulaması aracılığıyla oluşturulan prototip görevler kabul edilmez — yapı uç noktası yalnızca POST /openapi/creative-lab/fridge-magnet/v1/prototype tarafından üretilen prototip görevleri kabul eder ve diğer kaynakları 404 ile reddeder.

  • Name
    name
    Type
    string
    Description

    Görüntüleme amaçları için isteğe bağlı görev adı. Maksimum 100 karakter.

options

Rölyef geometrisi için isteğe bağlı ayar parametreleri. Her alanın mantıklı bir varsayılan değeri vardır — yalnızca değiştirmek istediğiniz alanları gönderin.

  • Name
    badge_shape
    Type
    string
    varsayılan rounded-rect
    Description

    Buzdolabı mıknatısının dış hat silueti. Mevcut değerler:

    • circle
    • rounded-rect (varsayılan)
    • hexagon
    • shield
    • star
  • Name
    size_mm
    Type
    number
    varsayılan 60
    Description

    Buzdolabı mıknatısının kenar uzunluğu, milimetre cinsinden. Aralık: (0, 400].

  • Name
    relief_height_mm
    Type
    number
    varsayılan 3.3
    Description

    Tabanın üzerindeki maksimum rölyef yüksekliği, milimetre cinsinden. Aralık: [0, 20].

  • Name
    relief_offset_mm
    Type
    number
    varsayılan 0
    Description

    Ekstrüzyondan önce rölyefe uygulanan dikey kaydırma, milimetre cinsinden. Aralık: [0, 20].

  • Name
    base_thickness_mm
    Type
    number
    varsayılan 2.0
    Description

    Rölyefin arkasındaki düz taban plakasının kalınlığı, milimetre cinsinden. Buzdolabı mıknatısının varsayılanı daha kalın bir 2 mm tabandır — mıknatısın buzdolabına tutunması için yeterli gövde sağlar ve rölyefin kırılgan hissetmesini engeller. Aralık: [0, 20].

  • Name
    has_closed_back
    Type
    boolean
    varsayılan true
    Description

    Buzdolabı mıknatısının arka yüzeyinin kapalı bir yüzey olarak mühürlenip mühürlenmediği (mıknatısı yapıştırdığınız taraf). Açık bir kabuk için false olarak ayarlayın.

  • Name
    relief_curve
    Type
    string
    varsayılan linear
    Description

    Derinlik haritası değerlerini rölyef yüksekliğine eşleyen transfer eğrisi. Mevcut değerler:

    • linear (varsayılan)
    • gamma
    • s-curve
  • Name
    curve_param
    Type
    number
    varsayılan 1.0
    Description

    Transfer eğrisi için şekil parametresi (relief_curve gamma olduğunda anlamlıdır). Aralık: (0, 10].

  • Name
    invert_depth
    Type
    boolean
    varsayılan false
    Description

    Derinlik haritası yorumunu ters çevirerek daha koyu bölgelerin daha yüksek rölyef olmasını sağlar.

  • Name
    smoothing
    Type
    number
    varsayılan 0.24
    Description

    Rölyef çıkarılmadan önce derinlik haritasına uygulanan yumuşatma gücü. Aralık: [0, 10].

  • Name
    relief_scale
    Type
    number
    varsayılan 1.0
    Description

    relief_height_mm üzerinde uygulanan dikey ölçek çarpanı. Aralık: (0, 10].

  • Name
    depth_threshold
    Type
    number
    varsayılan 0.1
    Description

    Derinlik haritası değerleri için düşük geçiş eşiği; bu değerin altındaki her şey sıfıra sıkıştırılır. Aralık: [0, 1].

  • Name
    remove_background
    Type
    boolean
    varsayılan true
    Description

    Rölyef işleminden önce prototipin konsept görüntüsünün arka planını otomatik olarak kaldırır.

    Aynı adı taşıyan prototip parametresinden ayrı (varsayılan false), bu parametre prototip görüntüsünün şeffaflıkla geri dönüp dönmeyeceğini kontrol eder.

  • Name
    export_resolution
    Type
    integer
    varsayılan 512
    Description

    İhracat için kullanılan ağ çözünürlüğü. Aralık: [64, 2048].

output

İsteğe bağlı tel formatı seçici. Varsayılan glb.

  • Name
    format
    Type
    string
    varsayılan glb
    Description

    Yapı tarafından döndürülen eser paketi. Mevcut değerler:

    • glb (varsayılan) — model_urls.glb altında tek bir model.glb döndürür.
    • obj — model.obj + model.mtl + texture.png dosyalarını sıkıştırır ve paketi model_urls.obj altında döndürür.
    • zip — jeneratörün çıkardığı her eseri sıkıştırır ve paketi model_urls.bundle_zip altında döndürür.

Dönüşler

Yanıtın result özelliği, yeni oluşturulan buzdolabı mıknatısı yapı görevinin görev id değerini içerir. Görev SUCCEEDED durumuna ulaşana kadar Bir Görev Al uç noktasını sorgulayın veya akışa abone olun, ardından model_urls içindeki tek girişten eseri indirin.

Başarısızlık Modları

  • Name
    400 - Bad Request
    Description

    İstek kabul edilemezdi. Yaygın nedenler:

    • Eksik parametre: input_task_id gereklidir.
    • Geçersiz UUID: input_task_id geçerli bir UUID değil.
    • Ebeveyn başarılı değil: Referans verilen prototip görevi henüz SUCCEEDED durumuna ulaşmadı.
    • Aday yok: Prototip görevi başarılı oldu ancak aday görüntü üretmedi.
    • Seçenekler aralık dışında: options alanlarından biri izin verilen aralık veya enum setinin dışında kaldı.
  • 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
    404 - Not Found
    Description

    Referans verilen prototip görevi mevcut değil, farklı bir kullanıcıya ait veya web uygulaması aracılığıyla oluşturulmuş (yalnızca API modunda prototip görevleri yapıya zincirlenir).

  • Name
    429 - Too Many Requests
    Description

    Hız sınırınızı aştınız.

İstek

POST
/openapi/creative-lab/fridge-magnet/v1/build
# Stage 2: chain build off a succeeded prototype task
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/build \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "input_task_id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
    "options": {
      "badge_shape": "rounded-rect",
      "size_mm": 60,
      "relief_height_mm": 3.3
    },
    "output": {
      "format": "glb"
    }
  }'

Yanıt

{
  "result": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0"
}
Yapı örneği
Yapı görevi, seçilen prototip görüntüsünü 3D baskıya uygun bir buzdolabı mıknatısı modeline dönüştürür.
Creative Lab Buzdolabı Mıknatısı yapı modeli önizlemesi
Yapı modeli önizlemesi
GET/openapi/creative-lab/fridge-magnet/v1/(prototype|build)/:id

Buzdolabı Mıknatısı Görevini Getir

Geçerli bir görev idsi verilen bir prototip veya inşa görevini getirir. URL yolu görevin aşamasıyla eşleşmelidir — /prototype/:id üzerinden getirilen bir inşa görevi 404 döndürür ve tersi de geçerlidir.

Yanıt şekilleri için Buzdolabı Mıknatısı Prototip Görev Nesnesi ve Buzdolabı Mıknatısı İnşa Görev Nesnesi bölümlerine bakın.

Parametreler

  • Name
    id
    Type
    path
    Description

    Getirilecek buzdolabı mıknatısı görevinin benzersiz tanımlayıcısı.

Dönüşler

Yanıt, buzdolabı mıknatısı görev nesnesini içerir. Şekil, hangi aşamanın istendiğine bağlıdır.

İstek

GET
/openapi/creative-lab/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9
# Prototype
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# Build
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/build/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Prototip Yanıtı

{
  "id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
  "type": "creative-lab-fridge-magnet-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543210000,
  "started_at": 1729543215000,
  "finished_at": 1729543242000,
  "expires_at": 1729802442000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

İnşa Yanıtı

{
  "id": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "type": "creative-lab-fridge-magnet-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543250000,
  "started_at": 1729543258000,
  "finished_at": 1729543285000,
  "expires_at": 1729802485000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 20,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/output/model.glb?Expires=***"
  }
}
DELETE/openapi/creative-lab/fridge-magnet/v1/(prototype|build)/:id

Buzdolabı Mıknatısı Görevini Sil

Bir buzdolabı mıknatısı görevini iptal edin. Görev hala PENDING durumundaysa, oluşturma sırasında tüketilen krediler iade edilir. Zaten IN_PROGRESS durumunda olan görevler iade yapılmadan iptal edilir (çalışan kaynakları tüketiyor olabilir). Zaten bir son duruma ulaşmış (SUCCEEDED, FAILED, CANCELED) görevler iptal edilemez.

URL yolu, görevin aşamasıyla eşleşmelidir — /prototype/:buildId üzerinde DELETE 404 döndürür.

Yol Parametreleri

  • Name
    id
    Type
    path
    Description

    İptal edilecek buzdolabı mıknatısı görevi için benzersiz tanımlayıcı.

Dönüşler

Başarı durumunda boş bir gövde ile 204 No Content döndürür.

Hata Modları

  • Name
    400 - Bad Request
    Description

    Görev zaten bir son durumda ve iptal edilemez.

  • Name
    404 - Not Found
    Description

    Görev mevcut değil, farklı bir kullanıcıya ait veya aşaması URL yoluyla eşleşmiyor.

İstek

DELETE
/openapi/creative-lab/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9
curl --request DELETE \
  --url https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Yanıt

// Returns 204 No Content on success (empty body).
GET/openapi/creative-lab/fridge-magnet/v1/(prototype|build)/:id/stream

Buzdolabı Mıknatısı Görevini Yayınla

Buzdolabı mıknatısı görevi için gerçek zamanlı güncellemeleri Server-Sent Events (SSE) aracılığıyla yayınlayın. URL yolu, görevin aşamasıyla eşleşmelidir — /prototype/:buildId/stream adresinde bir akış açmak, status_code: 404 ile tek bir event: error yükü yayar ve akışı kapatır.

Parametreler

  • Name
    id
    Type
    path
    Description

    Yayınlanacak buzdolabı mıknatısı görevinin benzersiz tanımlayıcısı.

Dönen Değerler

Buzdolabı Mıknatısı Prototipi veya Buzdolabı Mıknatısı Yapısı görev nesnelerinin Server-Sent Events olarak bir akışını 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/creative-lab/fridge-magnet/v1/build/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/stream
curl -N https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/build/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Yanıt Akışı

// Error event example (wrong stage or task not found)
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": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "type": "creative-lab-fridge-magnet-build",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543250000,
  "started_at": 1729543258000,
  "finished_at": 1729543285000,
  "expires_at": 1729802485000,
  "task_error": null,
  "consumed_credits": 20,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/output/model.glb?Expires=***"
  }
}
GET/openapi/creative-lab/fridge-magnet/v1/(prototype|build)

Buzdolabı Mıknatısı Görevlerini Listele

Tek bir aşama için buzdolabı mıknatısı görevlerinizin sayfalı bir listesini alın. URL yolu aşamayı seçer — /prototype prototip görevlerini döndürür; /build yapı görevlerini döndürür. Diğer aşamadan görevler her iki yanıtta da dahil edilmez.

Yol Parametreleri

  • Name
    stage
    Type
    path
    Zorunlu
    Description

    Ya prototype ya da build. Koleksiyon yalnızca aşaması URL ile eşleşen görevleri döndürür — /prototype çağrıldığında asla yapı görevleri döndürülmez ve tersi.

Sorgu Parametreleri

  • Name
    page_num
    Type
    integer
    varsayılan 1
    Description

    Sayfalama için sayfa numarası.

  • Name
    page_size
    Type
    integer
    varsayılan 10
    Description

    Sayfa boyutu sınırı. Maksimum izin verilen 50 öğedir.

  • Name
    sort_by
    Type
    string
    varsayılan -created_at
    Description

    Sıralama için alan. Mevcut değerler:

    • +created_at: Oluşturulma zamanına göre artan sırayla sıralayın.
    • -created_at: Oluşturulma zamanına göre azalan sırayla sıralayın.

Dönen Değerler

Aşama başına görev nesnesinin sayfalı bir listesini döndürür — ya /prototype listelenirken buzdolabı mıknatısı prototip görev nesnesi ya da /build listelenirken buzdolabı mıknatısı yapı görev nesnesi.

İstek

GET
/openapi/creative-lab/fridge-magnet/v1/prototype
# List prototype tasks
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/prototype?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# List build tasks
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/build?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Yanıt (Prototip Görevlerini Listele)

[
  {
    "id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
    "type": "creative-lab-fridge-magnet-prototype",
    "name": "",
    "status": "SUCCEEDED",
    "progress": 100,
    "created_at": 1729543210000,
    "started_at": 1729543215000,
    "finished_at": 1729543242000,
    "expires_at": 1729802442000,
    "preceding_tasks": 0,
    "task_error": null,
    "consumed_credits": 6,
    "image_urls": [
      "https://assets.meshy.ai/***/concept.png?Expires=***"
    ]
  }
]

Buzdolabı Mıknatısı Prototip Görev Nesnesi

Buzdolabı Mıknatısı Prototip Görev nesnesi, Meshy'nin bir kaynak fotoğrafından renklendirilmiş bir konsept görüntü oluşturmak için takip ettiği bir iş birimidir. Bu aşamanın çıktısı, input_task_id aracılığıyla inşa aşamasına zincirlenir.

Özellikler

  • Name
    id
    Type
    string
    Description

    Görev için benzersiz tanımlayıcı. Görev kimlikleri için k-sıralanabilir UUID kullanıyoruz, ancak kimliğin formatı hakkında herhangi bir varsayımda bulunmamalısınız.

  • Name
    type
    Type
    string
    Description

    Görevin türü. Değer creative-lab-fridge-magnet-prototype olarak belirlenmiştir.

  • Name
    name
    Type
    string
    Description

    Görev oluşturulurken sağlanan görev adı. Eğer bir ad sağlanmadıysa boş bir dize olur.

  • Name
    status
    Type
    string
    Description

    Görevin durumu. Olası değerler PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED'den biridir.

  • 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ıyla tamamlandığında, bu 100 olur.

  • Name
    created_at
    Type
    timestamp
    Description

    Görevin oluşturulduğu zaman damgası, milisaniye cinsinden.

    Bir zaman damgası, 1 Ocak 1970 UTC'den itibaren 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'deki tüm zaman damgaları için geçerlidir.

  • Name
    started_at
    Type
    timestamp
    Description

    Görevin başladığı zaman damgası, milisaniye cinsinden. Görev henüz başlamadıysa, bu özellik 0 olacaktır.

  • Name
    finished_at
    Type
    timestamp
    Description

    Görevin tamamlandığı zaman damgası, milisaniye cinsinden. Görev henüz tamamlanmadıysa, bu özellik 0 olacaktır.

  • Name
    expires_at
    Type
    timestamp
    Description

    Görev sonucunun sona erdiği zaman damgası, milisaniye cinsinden.

  • 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ı. Tam task_error nesne referansı 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 mevcuttur. FAILED görevler için 0 döner (başarısızlık durumunda krediler iade edilir).

  • Name
    image_urls
    Type
    array of strings
    Description

    Bu prototip görev tarafından üretilen konsept görüntü adaylarının indirilebilir URL'leri. Şu anda API her zaman tam olarak bir aday döndürür; alan bir dizi olarak tanımlanmıştır, böylece gelecekteki revizyonlar birden fazla adayı kırılma olmadan ortaya çıkarabilir.

Örnek Buzdolabı Mıknatısı Prototip Görev Nesnesi

{
  "id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
  "type": "creative-lab-fridge-magnet-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543210000,
  "started_at": 1729543215000,
  "finished_at": 1729543242000,
  "expires_at": 1729802442000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Buzdolabı Mıknatısı Yapı Görev Nesnesi

Buzdolabı Mıknatısı Yapı Görev nesnesi, Meshy'nin başarılı bir prototip görevinden nihai 3D buzdolabı mıknatısı ağı oluşturmak için takip ettiği bir iş birimidir. Yapı, prototipin konsept görüntüsü üzerinde bir derinlik haritası rölyef hattı çalıştırır ve arayanın talep ettiği formatta tek bir ağ eseri yayınlar.

Özellikler

  • Name
    id
    Type
    string
    Description

    Görev için benzersiz tanımlayıcı.

  • Name
    type
    Type
    string
    Description

    Görevin türü. Değer creative-lab-fridge-magnet-build'dir.

  • Name
    name
    Type
    string
    Description

    Görev oluşturulduğunda sağlanan görev adı. Eğer bir ad sağlanmadıysa boş string.

  • Name
    status
    Type
    string
    Description

    Görevin durumu. Olası değerler PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED'den biridir.

  • Name
    progress
    Type
    integer
    Description

    Görevin ilerlemesi. Görev henüz başlamadıysa, bu özellik 0 olacaktır. Görev başarılı olduktan sonra, bu 100 olur.

  • Name
    created_at
    Type
    timestamp
    Description

    Görevin oluşturulduğu zamanın zaman damgası, milisaniye cinsinden.

  • Name
    started_at
    Type
    timestamp
    Description

    Görevin başlatıldığı zamanın zaman damgası, milisaniye cinsinden.

  • Name
    finished_at
    Type
    timestamp
    Description

    Görevin tamamlandığı zamanın zaman damgası, milisaniye cinsinden.

  • Name
    expires_at
    Type
    timestamp
    Description

    Görev sonucunun sona erdiği zamanın zaman damgası, milisaniye cinsinden.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Önceki görevlerin sayısı. Sadece durum PENDING olduğunda anlamlıdır.

  • Name
    task_error
    Type
    object
    Description

    Başarısız görevler için hata detayları. Tam task_error nesne referansı için Hatalar sayfasına bakın.

  • Name
    consumed_credits
    Type
    integer
    Description

    Bu görev tarafından tüketilen kredi sayısı. FAILED görevler için 0 döner (başarısızlık durumunda krediler iade edilir).

  • Name
    model_urls
    Type
    object
    Description

    Üretilen eserin indirilebilir URL'leri, eser adına göre anahtarlanmıştır. Her zaman tam olarak bir giriş içerir — yapı isteğinin output.format'ı aracılığıyla talep edilen format. Anahtar, talep edilen formatla eşleşir:

    • Name
      glb
      Type
      string
      Description

      GLB dosyasının indirilebilir URL'si. output.format glb olduğunda (varsayılan) mevcuttur.

    • Name
      obj
      Type
      string
      Description

      model.obj, model.mtl ve texture.png içeren bir zip paketinin indirilebilir URL'si. output.format obj olduğunda mevcuttur.

    • Name
      bundle_zip
      Type
      string
      Description

      Üreticinin çıkardığı her eserin bir zip paketinin indirilebilir URL'si. output.format zip olduğunda mevcuttur.

Örnek Buzdolabı Mıknatısı Yapı Görev Nesnesi

{
  "id": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "type": "creative-lab-fridge-magnet-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543250000,
  "started_at": 1729543258000,
  "finished_at": 1729543285000,
  "expires_at": 1729802485000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 20,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/output/model.glb?Expires=***"
  }
}