Creative Lab — Tuğla Figür API

Bir kaynak fotoğrafı, iki aşamada tuğla tarzında koleksiyon yapılabilir bir 3B minifigüre dönüştürün: prototip, giriş fotoğrafınızdan stilize edilmiş bir konsept görüntü üretir, ardından yapı, bu konsept görüntüyü dokulu 3B modele dönüştürür. İki aşama input_task_id aracılığıyla birbirine bağlıdır.

  • POST /openapi/creative-lab/brick-figure/v1/prototype
  • POST /openapi/creative-lab/brick-figure/v1/build
POST/openapi/creative-lab/brick-figure/v1/prototype

Bir Tuğla Figür Prototip Görevi Oluştur

Kaynak fotoğraftan tek bir tuğla tarzında konsept görüntü oluşturun. Dönüş olarak verilen görev kimliği, oluşturma uç noktasına input_task_id olarak göndereceğiniz değerdir. Yanıtın yapısını görmek için Tuğla Figür Prototip Görev Nesnesi bölümüne bakın.

Parametreler

  • Name
    image_url
    Type
    string
    Zorunlu
    Description

    Kaynak fotoğrafı Meshy'nin bir tuğla minifigürü olarak stilize etmesi için kullanılır. Şu anda .jpg, .jpeg, .png ve .webp formatlarını destekliyoruz.

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

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

    Gösterim amaçlı isteğe bağlı görev adı. Maksimum 100 karakter.

Dönen Değerler

Yanıtın result özelliği, yeni oluşturulan tuğla figür prototip görevine ait görevin id değerini içerir. Görev SUCCEEDED durumuna ulaşana kadar Bir Görevi Getir uç noktasını veya akışa abone olun, ardından bu kimliği inşa uç noktasına input_task_id olarak gönderin.

Hata 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 desteklenmeyen bir formatta (.jpg, .jpeg, .png, .webp).
    • Görüntü boyutları aralık dışında: Görüntü çok küçük, maksimum dosya boyutunu aşan veya maksimum piksel sayısını aşan.
    • Erişim sağlanamayan URL: image_url indirilemedi (404 veya timeout).
    • Geçersiz Data URI: Base64 dizisi hatalı.
    • İçerik işaretlendi: Başvuru 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 yeterli kredi yok.

  • Name
    403 - Forbidden
    Description

    Girdi görseli fikri mülkiyet ihlali nedeniyle işaretlendi.

  • Name
    429 - Too Many Requests
    Description

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

İstek

POST
/openapi/creative-lab/brick-figure/v1/prototype
# 1. Aşama: bir tuğla tarzında konsept görüntü oluştur
curl https://api.meshy.ai/openapi/creative-lab/brick-figure/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": "018a210d-8ba4-705c-b111-1f1776f7f578"
}
POST/openapi/creative-lab/brick-figure/v1/build

Bir Tuğla Figür Yapım Görevi Oluştur

Başarıyla tamamlanmış bir prototip görevden son dokulu 3D tuğla figürü oluşturun. Yapım, Görselden 3D'ye ile aynı görüntüden 3D'ye dönüşüm boru hattını çalıştırır, bu nedenle yanıt nesnesi formatı ve çıktı URL'lerinin listesi tam olarak eşleşir. Yanıt yapısı için Tuğla Figür Yapım Görevi Nesnesi'ne bakın.

Parametreler

  • Name
    input_task_id
    Type
    string
    Zorunlu
    Description

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

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

  • Name
    name
    Type
    string
    Description

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

Dönüşler

Yanıtın result özelliği, yeni oluşturulan tuğla figür yapım görevinin görev id değerini içerir. Görev SUCCEEDED durumuna ulaşana kadar Bir Görevi Al uç noktasını sorgulayın veya akışa abone olun, ardından dokulu GLB'yi model_urls.glb den indirin (veya alt işlem hattınız OBJ tercih ederse, OBJ + MTL çiftini model_urls.obj ve model_urls.mtl den 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: Başvurulan prototip görev henüz SUCCEEDED durumuna ulaşmadı.
    • Aday yok: Prototip görev başarılı oldu ancak aday görsel üretmedi.
  • Name
    401 - Unauthorized
    Description

    Kimlik doğrulama başarısız. 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

    Başvurulan prototip görev mevcut değil, başka bir kullanıcıya ait veya web uygulaması aracılığıyla oluşturulmuş (yalnızca API modundaki prototip görevler yapım işlemine devam eder).

  • Name
    429 - Too Many Requests
    Description

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

İstek

POST
/openapi/creative-lab/brick-figure/v1/build
# Aşama 2: başarılı bir prototip görevden yapım zinciri oluştur
curl https://api.meshy.ai/openapi/creative-lab/brick-figure/v1/build \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578"
  }'

Yanıt

{
  "result": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb"
}
GET/openapi/creative-lab/brick-figure/v1/(prototype|build)/:id

Tuğla Figürü Görevini Al

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

Yanıt şekilleri için The Brick Figure Prototype Task Object ve The Brick Figure Build Task Object başvurun.

Parametreler

  • Name
    id
    Type
    path
    Description

    Alınacak tuğla figürü görevinin benzersiz kimliği.

Döndürür

Yanıt, tuğla figürü görev nesnesini içerir. Şekil, hangi aşamanın istendiğine bağlıdır.

İstek

GET
/openapi/creative-lab/brick-figure/v1/prototype/018a210d-8ba4-705c-b111-1f1776f7f578
# Prototip
curl https://api.meshy.ai/openapi/creative-lab/brick-figure/v1/prototype/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# İnşa
curl https://api.meshy.ai/openapi/creative-lab/brick-figure/v1/build/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Prototip Yanıtı

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "creative-lab-brick-figure-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123456000,
  "started_at": 1729123460000,
  "finished_at": 1729123486000,
  "expires_at": 1729382686000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

İnşa Yanıtı

{
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "type": "creative-lab-brick-figure-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123500000,
  "started_at": 1729123510000,
  "finished_at": 1729123535000,
  "expires_at": 1729382735000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 30,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/texture_0.png?Expires=***"
    }
  ]
}
DELETE/openapi/creative-lab/brick-figure/v1/(prototype|build)/:id

Bir Tuğla Figür Görevini Silme

Bir tuğla figür görevini iptal et. Eğer görev hala PENDING durumundaysa, oluşturulma sırasında tüketilen krediler iade edilir. Zaten IN_PROGRESS olan görevler iptal edilir ancak iade yapılmaz (çalışan zaten kaynak tüketiyor olabilir). Zaten bir son durumuna (SUCCEEDED, FAILED, CANCELED) ulaşmış görevler iptal edilemez.

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

Yol Parametreleri

  • Name
    id
    Type
    path
    Description

    İptal edilecek tuğla figür görevinin benzersiz tanımlayıcısı.

Geri Dönüşler

Başarı halinde boş bir gövde ile 204 No Content döner.

Başarısızlık Durumları

  • Name
    400 - Bad Request
    Description

    Görev zaten bir son durumda ve iptal edilemez.

  • Name
    404 - Not Found
    Description

    Görev exist etmiyor, farklı bir kullanıcıya ait veya aşaması URL yoluyla eşleşmiyor.

İstek

DELETE
/openapi/creative-lab/brick-figure/v1/prototype/018a210d-8ba4-705c-b111-1f1776f7f578
curl --request DELETE \
  --url https://api.meshy.ai/openapi/creative-lab/brick-figure/v1/prototype/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Yanıt

// Başarı halinde 204 No Content döner (boş gövde).
GET/openapi/creative-lab/brick-figure/v1/(prototype|build)/:id/stream

Bir Tuğla Figürü Görevini Yayınla

Server-Sent Events (SSE) aracılığıyla bir tuğla figürü görevi için gerçek zamanlı güncellemeleri yayınlayın. URL yolunun, görevin aşamasıyla eşleşmesi gerekir — /prototype/:buildId/stream adresinde bir akış açılması status_code: 404 ile tek bir event: error yükü gönderir ve akışı kapatır.

Parametreler

  • Name
    id
    Type
    path
    Description

    Yayınlamak için tuğla figürü görevinin benzersiz tanıtıcısı.

Dönenler

Tuğla Figürü Prototip veya Tuğla Figürü İnşa Et görev nesnelerinin bir akışını Server-Sent Events olarak döndürür. PENDING veya IN_PROGRESS görevleri için, yanıt akışı sadece gerekli progress ve status alanlarını içerecektir.

Request

GET
/openapi/creative-lab/brick-figure/v1/build/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/stream
curl -N https://api.meshy.ai/openapi/creative-lab/brick-figure/v1/build/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Hata olayı örneği (yanlış aşama veya görev bulunamadı)
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Mesaj olayı örnekleri görev ilerlemesini gösterir.
// PENDING veya IN_PROGRESS görevleri için, yanıt akışı tüm alanları içermeyecektir.
event: message
data: {
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "type": "creative-lab-brick-figure-build",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123500000,
  "started_at": 1729123510000,
  "finished_at": 1729123535000,
  "expires_at": 1729382735000,
  "task_error": null,
  "consumed_credits": 30,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/texture_0.png?Expires=***"
    }
  ]
}
GET/openapi/creative-lab/brick-figure/v1/(prototype|build)

Tuğla Figür Görevlerini Listele

Tek bir aşama için tuğla figür görevlerinizin sayfalanmış bir listesini alın. URL yolu aşamayı seçer — /prototype prototip görevlerini döndürür; /build ise inşa görevlerini döndürür. Diğer aşamanın görevleri hiçbir yanıtın içinde yer almaz.

Yol Parametreleri

  • Name
    stage
    Type
    path
    Zorunlu
    Description

    prototype veya build olmalı. Koleksiyon yalnızca aşaması URL ile eşleşen görevleri döndürür — /prototype alma hiçbir zaman inşa görevlerini döndürmez ve tam 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ı. İzin verilen maksimum 100 öğedir.

  • Name
    sort_by
    Type
    string
    varsayılan -created_at
    Description

    Sıralama alanı. Mevcut değerler:

    • +created_at: Oluşturma zamanına göre artan sırayla sıralama.
    • -created_at: Oluşturma zamanına göre azalan sırayla sıralama.

Dönüşler

Aşama başına görev nesnesinin sayfalanmış bir listesini döndürür — /prototype listelendiğinde tuğla figür prototip görev nesnesi veya /build listelendiğinde tuğla figür inşa görev nesnesi.

İstek

GET
/openapi/creative-lab/brick-figure/v1/prototype
# Prototip görevlerini listele
curl https://api.meshy.ai/openapi/creative-lab/brick-figure/v1/prototype?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# İnşa görevlerini listele
curl https://api.meshy.ai/openapi/creative-lab/brick-figure/v1/build?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Yanıt (Prototip Görevleri Listele)

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "creative-lab-brick-figure-prototype",
    "name": "",
    "status": "SUCCEEDED",
    "progress": 100,
    "created_at": 1729123456000,
    "started_at": 1729123460000,
    "finished_at": 1729123486000,
    "expires_at": 1729382686000,
    "preceding_tasks": 0,
    "task_error": null,
    "consumed_credits": 6,
    "image_urls": [
      "https://assets.meshy.ai/***/concept.png?Expires=***"
    ]
  }
]

Tuğla Figür Prototip Görev Nesnesi

Tuğla Figür Prototip Görev nesnesi, Meshy'nin bir kaynak fotoğraftan tuğla tarzında bir kavram resmi oluşturmak için izlediği bir iş birimidir. Bu aşamanın çıktısı, input_task_id aracılığıyla inşa etme aşamasına aktarılmaktadır.

Özellikler

  • Name
    id
    Type
    string
    Description

    Görev için benzersiz tanımlayıcı. Görev kimlikleri için k-sıralı UUID kullanıyor olmamıza rağmen, id formatı hakkında herhangi bir varsayımda bulunmamalısınız.

  • Name
    type
    Type
    string
    Description

    Görevin türü. Değer creative-lab-brick-figure-prototype şeklindedir.

  • Name
    name
    Type
    string
    Description

    Görev oluşturulurken belirtilen görev adı. Eğer bir ad sağlanmamışsa boş string olur.

  • Name
    status
    Type
    string
    Description

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

  • 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 değer 100 olur.

  • Name
    created_at
    Type
    timestamp
    Description

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

    Bir zaman damgası, 1 Ocak 1970 UTC tarihinden itibaren geçen milisaniye sayısını temsil eder ve RFC 3339 standardı izlenir. Örneğin, Cuma, 1 Eylül 2023, 12:00:00 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ın zaman damgası, milisaniye cinsinden. Görev henüz başlamadıysa, bu özellik null olacaktır.

  • Name
    finished_at
    Type
    timestamp
    Description

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

  • Name
    expires_at
    Type
    timestamp
    Description

    Görev sonucunun süresinin dolduğu zamanın 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 mevcut olacaktır. 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örevi tarafından oluşturulan konsept görüntü adaylarının indirilebilir URL'leri. Şu anda API her zaman tam olarak bir aday döndürüyor; alan bir dizi olduğundan gelecekteki revizyonlar, kırılmadan birden fazla aday gösterebilir.

Example Brick Figure Prototype Task Object

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "creative-lab-brick-figure-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123456000,
  "started_at": 1729123460000,
  "finished_at": 1729123486000,
  "expires_at": 1729382686000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Tuğla Figür Yapı Görev Nesnesi

Tuğla Figür Yapı Görev Nesnesi, Meshy tarafından izlenen ve başarılı bir prototip görevinden dokulu 3D tuğla figürü oluşturmak için kullanılan bir çalışma birimidir. Image to 3D tarafından kullanılan aynı görselden 3D'ye işlem hattını çalıştırır, böylece çıktı alanları bu uç noktanın görev nesnesi ile uyumludur.

Ö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-brick-figure-build.

  • Name
    name
    Type
    string
    Description

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

  • Name
    status
    Type
    string
    Description

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

  • Name
    progress
    Type
    integer
    Description

    Görevin ilerlemesi. Görev henüz başlamadıysa, bu özellik 0 olarak döner. Görev başarılı olduğunda, bu 100 olur.

  • Name
    created_at
    Type
    timestamp
    Description

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

  • Name
    started_at
    Type
    timestamp
    Description

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

  • Name
    finished_at
    Type
    timestamp
    Description

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

  • Name
    expires_at
    Type
    timestamp
    Description

    Görev sonucunun süresinin dolacağı zamana ait zaman damgası, milisaniye cinsinden.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Önceki görevlerin sayısı. Anlamlı olan sadece PENDING durumunda.

  • 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ıkta krediler iade edilir).

  • Name
    prompt
    Type
    string
    Description

    Her zaman tuğla figürü inşası için boş. Uç noktalar arası uyumluluk için Görselden 3D'ye tarafından kullanılan paylaşılan V2ImageTo3DTaskResponse yapısı ile mevcuttur.

  • Name
    negative_prompt
    Type
    string
    Description

    Her zaman tuğla figürü inşası için boş. Uç noktalar arası uyumluluk için mevcuttur.

  • Name
    texture_prompt
    Type
    string
    Description

    Her zaman tuğla figürü inşası için boş. Uç noktalar arası uyumluluk için mevcuttur.

  • Name
    texture_image_url
    Type
    string
    Description

    Her zaman tuğla figürü inşası için boş. Uç noktalar arası uyumluluk için mevcuttur.

  • Name
    model_urls
    Type
    object
    Description

    Oluşturulan 3D model için indirilebilir URL'ler. Tuğla figürü inşası dokulu bir GLB ve Wavefront OBJ tercih eden işlemler için OBJ + MTL çiftini üretir. Alan şekli, gelecekteki format eklemelerinin kırılma olmadan yerleşebilmesi için Görselden 3D'ye model_urls nesnesi ile eşleşir.

    • Name
      glb
      Type
      string
      Description

      Dokulu GLB dosyasının indirilebilir URL'si.

    • Name
      obj
      Type
      string
      Description

      Wavefront OBJ dosyasının indirilebilir URL'si (geometri + UV).

    • Name
      mtl
      Type
      string
      Description

      OBJ yardımcı MTL malzeme dosyasının indirilebilir URL'si. obj ile ve texture_urls[0].base_colordan giriş ile eşleştirin.

  • Name
    thumbnail_url
    Type
    string
    Description

    Model dosyasının küçük resim görüntüsünün indirilebilir URL'si.

  • Name
    texture_urls
    Type
    array
    Description

    Bu görev tarafından üretilen doku URL nesnelerinin dizisi. Şu anda temel renk haritasına sahip tek bir nesne içerir.

    • Name
      base_color
      Type
      string
      Description

      Temel renk haritası görüntüsünün indirilebilir URL'si.

Örnek Tuğla Figürü Yapım Görevi Nesnesi

{
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "type": "creative-lab-brick-figure-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123500000,
  "started_at": 1729123510000,
  "finished_at": 1729123535000,
  "expires_at": 1729382735000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 30,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/texture_0.png?Expires=***"
    }
  ]
}