Creative Lab Tuğla Figür API

Bir fotoğrafı iki aşamada tuğla tarzı koleksiyonluk 3D minifigüre dönüştürün. Bir prototip görevi, fotoğraftan bir konsept görüntü oluşturur. Bir üretim görevi ise bu görüntüyü dokulu bir 3D modele dönüştürür ve prototip görevinin kimliğini input_task_id olarak alı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

Brick Figure prototype görevi oluştur

Bir fotoğraftan brick tarzında bir konsept görüntü oluşturur. 3D modeli oluşturmak için bu görevin ID'sini input_task_id olarak build uç noktasına iletin. Görevin alanları için bkz. Brick Figure prototype görev nesnesi.

Request

POST

/openapi/creative-lab/brick-figure/v1/prototype

# Stage 1: generate a brick-style concept image
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>"
  }'

Response

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

Parametreler

Name
image_url
Type
string
Zorunlu
Description
Brick minifigüre dönüştürülecek fotoğraf; genel erişime açık bir URL veya data URI (data:image/jpeg;base64,<base64 ile kodlanmış görüntü verileriniz>) olarak.
Görüntü, en fazla 20 MB boyutunda bir JPG, JPEG, PNG veya WebP dosyası olmalıdır.
Name
name
Type
string
Description
Görev için en fazla 100 karakterlik bir ad. Bu ad, görevin name alanında geri döner. Daha uzun bir ad 400 döndürür.
Name
remove_background
Type
boolean
varsayılan false
Description
Prototip görüntüsünden arka planın kaldırılıp kaldırılmayacağı. true değeri, nesneyi herhangi bir arka plana yerleştirebilmeniz için şeffaf bir RGBA PNG döndürür. Build işlemi de görüntünün arka planı olmayan hâlinden başlar. Meshy arka planı kaldıramazsa, görüntüyü arka planıyla birlikte döndürür ve görev yine de başarılı olur.

Dönüş Değerleri

result alanı, yeni prototype görevinin ID'sini tutar. status değeri SUCCEEDED olana kadar görevi alın veya akış olarak izleyin. Ardından ID'yi input_task_id olarak build uç noktasına iletin.

Hata durumları

Name
400 - Bad Request
Description
İstek çalıştırılamıyor. Örneğin:
- image_url eksik.
- Görüntü bir JPG, JPEG, PNG veya WebP dosyası değil.
- Görüntü çok küçük, 20 MB'ın üzerinde veya maksimum piksel sayısının üzerinde.
- Meshy görüntüyü indiremiyor; örneğin URL 404 döndürüyor veya zaman aşımına uğruyor.
- Data URI geçerli base64 değil.
- Görüntü NSFW olarak işaretlendi.
Hata mesajı hangi sorunu bulduğunu belirtir. İsteği düzeltip tekrar gönderin.
Name
401 - Unauthorized
Description
API anahtarı eksik veya geçersiz. Authorization başlığını kontrol edin.
Name
402 - Payment Required
Description
Aşağıdakilerden biri geçerlidir:
- Hesapta yeterli kredi yok.
- API anahtarı, çalışma alanı veya üye kredi limitine ulaştı.
- Hesap ücretsiz plandadır.
Kredilerinizi ve planınızı kontrol edip tekrar deneyin.
Name
403 - Forbidden
Description
Ekibinizde IP Filtering açık ve Meshy görüntüyü üçüncü taraf fikri mülkiyeti nedeniyle işaretledi. Kullanım haklarına sahip olduğunuz bir görüntü gönderin.
Name
429 - Too Many Requests
Description
Şu sınırlardan biri aşıldı:
- Hız sınırınızın izin verdiğinden daha fazla istek gönderdiniz. Birkaç saniye bekleyip tekrar deneyin. Bkz. Hız sınırları.
- Çok fazla göreviniz kuyruğa alınmış veya çalışıyor durumda. Bazılarının tamamlanmasını bekleyip tekrar deneyin.
- Krediniz kalmayan sınırsız bir plandaysanız, kredisiz çalıştırılabilecek görev sayısına ulaştınız. Bir görevin tamamlanmasını bekleyin veya kredi ekleyin.
Name
500 - Internal Server Error
Description
Meshy bir sunucu hatasıyla karşılaştı; örneğin görüntü üzerinde fikri mülkiyet kontrolünü çalıştıramadı. Meshy görevi oluşturmaz ve tahsil ettiği tüm kredileri iade eder. İsteği tekrar deneyin.

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

Brick Figure yapı (build) görevi oluştur

Başarılı bir prototip görevinden dokulu 3D minifigürü oluşturur. Alanları için Brick Figure yapı görevi nesnesi bölümüne bakın.

Request

POST

/openapi/creative-lab/brick-figure/v1/build

# Stage 2: chain build off a succeeded prototype task
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"
  }'

Response

{
  "result": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb"
}

Parametreler

Name
input_task_id
Type
string
Zorunlu
Description
Oluşturulacak prototip görevinin ID'si. Bu, hesabınızın POST /openapi/creative-lab/brick-figure/v1/prototype ile oluşturduğu ve durumu SUCCEEDED olan bir görev olmalıdır.
API üzerinden oluşturduğunuz Brick Figure prototip görevlerinizden biri olmayan bir ID, web uygulamasında yapılmış bir prototip dahil, 404 döndürür.
Name
name
Type
string
Description
Görev için en fazla 100 karakterlik bir ad. Bu ad, görevin name alanında geri döner. Daha uzun bir ad 400 döndürür.

Dönüş Değerleri

result alanı, yeni yapı görevinin ID'sini tutar. status alanı SUCCEEDED olana kadar görevi alın veya akış olarak izleyin. Ardından dokulu GLB dosyasını model_urls.glb üzerinden indirin. Bunun yerine bir OBJ için, model_urls.obj dosyasını malzeme dosyasıyla birlikte model_urls.mtl üzerinden indirin.

Hata durumları

Name
400 - Bad Request
Description
İstek çalıştırılamıyor. Örneğin:
- input_task_id eksik veya geçerli bir görev ID'si değil.
- Prototip görevinin durumu SUCCEEDED değil. Hâlâ çalışıyorsa bekleyin ve tekrar deneyin. Başarısız olduysa veya iptal edildiyse, yeni bir prototip görevi oluşturun.
- Prototip görevi başarılı oldu ancak bir görüntüsü yok. Yeni bir prototip görevi oluşturun.
Hata mesajı hangi sorunu bulduğunu belirtir.
Name
401 - Unauthorized
Description
API anahtarı eksik veya geçersiz. Authorization başlığını kontrol edin.
Name
402 - Payment Required
Description
Aşağıdakilerden biri geçerlidir:
- Hesapta yeterli kredi yok.
- API anahtarı, çalışma alanı veya üye kredi limitine ulaştı.
- Hesap ücretsiz plandadır.
Kredilerinizi ve planınızı kontrol edin, ardından tekrar deneyin.
Name
404 - Not Found
Description
input_task_id, hesabınızın API ile oluşturduğu herhangi bir Brick Figure prototip göreviyle eşleşmiyor. Web uygulamasında yapılan bir prototip de 404 döndürür. Bir prototip oluşturma yanıtından gelen result ID'sini gönderin.
Name
429 - Too Many Requests
Description
Şu sınırlardan biri aşıldı:
- Hız sınırınızın izin verdiğinden daha fazla istek gönderdiniz. Birkaç saniye bekleyin, ardından tekrar deneyin. Bkz. Hız sınırları.
- Çok fazla göreviniz sırada bekliyor veya çalışıyor. Bazılarının bitmesini bekleyin, ardından tekrar deneyin.
- Kredisi kalmamış sınırsız bir plandayken, kredisiz çalıştırılabilecek görev sayısına ulaştınız. Bir görevin bitmesini bekleyin veya kredi ekleyin.

GET/openapi/creative-lab/brick-figure/v1/(prototype|build)/:id

Bir Brick Figure görevi al

Bir prototip veya build görevi döndürür. Yol (path), görevin aşamasıyla eşleşmelidir. /prototype/:id üzerinden istenen bir build görevi 404 döndürür ve aynı şekilde /build/:id üzerinden istenen bir prototip görevi de 404 döndürür.

Alanlar için bkz. Brick Figure prototip görev nesnesi ve Brick Figure build görev nesnesi.

Request

GET

/openapi/creative-lab/brick-figure/v1/prototype/018a210d-8ba4-705c-b111-1f1776f7f578

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

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

Prototype Response

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

Build Response

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

Parametreler

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

Dönüş değerleri

Yoldaki aşamayla eşleşen prototip görev nesnesi veya build görev nesnesi.

Başarısızlık durumları

Name
400 - Bad Request
Description
id geçerli bir görev ID'si değil. Oluşturma yanıtındaki result ID'sini gönderin.
Name
403 - Forbidden
Description
Ekibinizde IP Filtering açık ve Meshy, görevin görselini üçüncü taraf fikri mülkiyet açısından işaretledi. Enterprise plandaki ekipler bu hatayı almaz. Kullanma hakkına sahip olduğunuz bir görselden prototip görevi oluşturun.
Name
404 - Not Found
Description
Bu ID'ye sahip hiçbir Brick Figure görevi hesabınıza ait değil veya görevin aşaması yol ile eşleşmiyor. ID'yi kontrol edin ve göreve uyacak şekilde /prototype veya /build kullanın.
Name
500 - Internal Server Error
Description
Meshy fikri mülkiyet kontrolünü çalıştıramadı. İsteği yeniden deneyin.

DELETE/openapi/creative-lab/brick-figure/v1/(prototype|build)/:id

Bir Brick Figure görevini sil

Bir Brick Figure görevini iptal eder. PENDING bir görevi iptal etmek, görevin kredilerini iade eder. Bir IN_PROGRESS görev ise, bir işçi (worker) zaten görevi başlatmış olduğundan iade yapılmadan iptal edilir. Nihai bir durumda (SUCCEEDED, FAILED veya CANCELED) olan bir görev iptal edilemez.

Yol, görevin aşamasıyla eşleşmelidir. Örneğin, bir build görevinin ID'si ile /prototype/:id üzerinde DELETE yapmak 404 döndürür.

Request

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

Response

// Returns 204 No Content on success (empty body).

Yol parametreleri

Name
id
Type
path
Description
İptal edilecek görevin ID'si.

Dönüş değerleri

Boş gövdeyle birlikte 204 No Content.

Hata modları

Name
400 - Bad Request
Description
Aşağıdakilerden biri geçerlidir:
- id geçerli bir görev ID'si değil. Oluşturma yanıtından gelen result ID'sini gönderin.
- Görev zaten nihai bir durumda (SUCCEEDED, FAILED veya CANCELED), bu nedenle iptal edilemez.
Name
404 - Not Found
Description
Bu ID'ye sahip bir Brick Figure görevi hesabınıza ait değil veya görevin aşaması yolla eşleşmiyor. ID'yi kontrol edin ve görevle eşleşmesi için /prototype veya /build kullanın.

GET/openapi/creative-lab/brick-figure/v1/(prototype|build)/:id/stream

Bir Brick Figure görevini akışa alma

Bir Brick Figure görevinin güncellemelerini Server-Sent Events (SSE) olarak akışa alır. Yol, görevin aşamasıyla eşleşmelidir. Eşleşmezse, örneğin bir build görevinin ID'si /prototype/:id/stream üzerinde kullanılırsa, akış status_code: 404 ile bir error olayı gönderip kapanır.

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

// 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.
// Every frame is the full task object; fields not yet populated are null / empty.
// The following PENDING frame is shortened to the fields that change.
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=***"
    }
  ]
}

Parametreler

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

Dönüş Değerleri

Bir prototype veya build görev nesnelerinin akışı. Her olay, Bir Brick Figure görevini al işleminin döndürdüğü şekliyle tam görev nesnesini içerir. Görev PENDING veya IN_PROGRESS durumundayken, çıktı alanları hâlâ boştur (null, [] veya {}) ve finished_at değeri null'dur.

Eğer IP Filtering görevin sonucunu engellerse, akış bunun yerine, bir get isteğinin döndüreceği status_code ile birlikte tek bir error olayı gönderir.

GET/openapi/creative-lab/brick-figure/v1/(prototype|build)

Brick Figure görevlerini listele

Bir seferde bir aşamaya ait Brick Figure görevlerinizi, her seferinde bir sayfa olacak şekilde döndürür. Yol (path), aşamayı seçer. /prototype yalnızca prototype görevlerini, /build ise yalnızca build görevlerini döndürür.

Request

GET

/openapi/creative-lab/brick-figure/v1/prototype

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

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

Response (List Prototype Tasks)

[
  {
    "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=***"
    ]
  }
]

Yol parametreleri

Name
stage
Type
path
Zorunlu
Description
Listelenecek aşama, prototype veya build.

Sorgu parametreleri

Name
page_num
Type
integer
varsayılan 1
Description
Döndürülecek sayfa, 1 ile 255 arasında. 0 ilk sayfayı döndürür. 0 ile 255 dışındaki 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. 101 ile 255 arasındaki bir değer 100 görev döndürür, 0 ise varsayılanı kullanır. 0 ile 255 dışındaki bir değer 400 döndürür.
Name
sort_by
Type
string
varsayılan -created_at
Description
Sıralama düzeni.
Kullanılabilir değerler:
- -created_at: önce en yeni
- +created_at: önce en eski

Döndürülenler

Yoldaki aşamaya karşılık gelen bir prototype görev nesneleri veya build görev nesneleri dizisi.

Brick Figure prototype görev nesnesi

Bir prototype görevi, bir fotoğraftan tuğla tarzı bir kavram görseli oluşturur. Görseli 3D modele dönüştürmek için görevin kimliğini input_task_id olarak build uç noktasına iletin.

Özellikler

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

Name
id
Type
string
Description
Görev kimliği. Biçimine güvenmeyin.
Name
type
Type
string
Description
Görev türü, her zaman creative-lab-brick-figure-prototype.
Name
name
Type
string
Description
Görevi oluştururken gönderdiğiniz name, göndermediyseniz "".
Name
status
Type
string
Description
Görevin durumu.
Kullanılabilir değerler:
- PENDING: sırada bekliyor
- IN_PROGRESS: sonuç üretiliyor
- SUCCEEDED: sonlandı, sonuçla birlikte
- FAILED: sonlandı, nedeni task_error içinde
- CANCELED: sonlandı, sonuç yok
Name
progress
Type
integer
Description
Tamamlanan işin yüzdesi, 0 ile 100 arasında. Görev başlayana kadar 0, başarılı olduğunda 100 olur.
Name
created_at
Type
timestamp
Description
Görevin oluşturulduğu zaman, Unix milisaniye cinsinden.
Name
started_at
Type
timestamp
Description
Bir çalışanın görevi başlattığı zaman, Unix milisaniye cinsinden. O ana kadar null.
Name
finished_at
Type
timestamp
Description
Görevin nihai bir duruma ulaştığı zaman, Unix milisaniye cinsinden. O ana kadar null.
Name
expires_at
Type
timestamp
Description
Görevin sonucunun süresinin dolduğu zaman, Unix milisaniye cinsinden. Bu, finished_at'ten 3 gün sonra ya da görev tamamlanana kadar created_at'ten 3 gün sonrasıdır. API sonuçlarını süresiz olarak saklayan Enterprise hesaplar için bu süre yaklaşık 100 yıl sonrasıdır. Bkz. Varlık saklama.
Name
preceding_tasks
Type
integer
Description
Görevin PENDING durumundayken sıradaki konumu. 1, bir sonraki sırada başlayacağı anlamına gelir. Görev sıradan çıktıktan sonra 0, liste sonuçlarında ise her zaman 0.
Name
task_error
Type
object
Description
Görevin neden başarısız olduğu. status değeri FAILED olmadıkça null. Bkz. Hatalar.
Name
consumed_credits
Type
integer
Description
Görev için, varsa iade sonrasında tahsil edilen kredi sayısı. Hata döndüren bir istekten ücret alınmaz. Başarısız bir görev 0'dır, çünkü Meshy bunu iade eder. İptal etme, bir görevi yalnızca PENDING durumundayken iade eder. Meshy tahsilatı okuyamazsa, bir get veya stream yanıtı bu alanı dışarıda bırakır ve bir liste isteği 500 döndürür. Bu durumda isteği yeniden deneyin.
Name
image_urls
Type
array of strings
Description
Kavram görseli için indirme URL'leri. Görev başarılı olduktan sonra dizide bir URL bulunur, o ana kadar boştur.

Brick Figür oluşturma görev nesnesi

Bir oluşturma görevi, başarılı bir prototip görevinden dokulu bir 3D minifigür üretir. model_urls, thumbnail_url ve texture_urls alanları, Görselden 3D'ye görev nesnesi ile aynı biçime sahiptir.

Özellikler

Example Brick Figure Build Task Object

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

Name
id
Type
string
Description
Görev kimliği. Biçimine güvenmeyin.
Name
type
Type
string
Description
Görev türü, her zaman creative-lab-brick-figure-build.
Name
name
Type
string
Description
Görevi oluştururken gönderdiğiniz name, göndermediyseniz "".
Name
status
Type
string
Description
Görevin durumu.
Kullanılabilir değerler:
- PENDING: sırada bekliyor
- IN_PROGRESS: sonuç üretiliyor
- SUCCEEDED: sonuçlanmış, sonuçla birlikte
- FAILED: sonuçlanmış, nedeni task_error içinde
- CANCELED: sonuçlanmış, sonuç olmadan
Name
progress
Type
integer
Description
Tamamlanan işin yüzdesi, 0 ile 100 arasında. Görev başlayana kadar 0, başarılı olduğunda 100 olur.
Name
created_at
Type
timestamp
Description
Görevin oluşturulduğu zaman, Unix milisaniye cinsinden.
Name
started_at
Type
timestamp
Description
Bir çalışanın görevi başlattığı zaman, Unix milisaniye cinsinden. O zamana kadar null.
Name
finished_at
Type
timestamp
Description
Görevin nihai bir duruma ulaştığı zaman, Unix milisaniye cinsinden. O zamana kadar null.
Name
expires_at
Type
timestamp
Description
Görevin sonucunun süresinin dolacağı zaman, Unix milisaniye cinsinden. finished_at'ten 3 gün sonrası veya görev bitene kadar created_at'ten 3 gün sonrasıdır. API sonuçlarını süresiz olarak saklayan Enterprise hesapları için, bu yaklaşık 100 yıl sonrasıdır. Bkz. Varlık saklama.
Name
preceding_tasks
Type
integer
Description
Görev PENDING durumundayken sıradaki konumu. 1, sıradaki görevin bu olduğu anlamına gelir. Görev sıradan çıktıktan sonra 0, ve liste sonuçlarında her zaman 0.
Name
task_error
Type
object
Description
Görevin neden başarısız olduğu. status değeri FAILED olmadıkça null. Bkz. Hatalar.
Name
consumed_credits
Type
integer
Description
Herhangi bir iade sonrası görev için tahsil edilen kredi sayısı. Hata döndüren bir istekten ücret alınmaz. Başarısız bir görev 0'dır, çünkü Meshy bunu iade eder. İptal etmek, bir görevi yalnızca PENDING durumundayken iade eder. Meshy ücreti okuyamazsa, bir get veya stream yanıtı bu alanı dışarıda bırakır ve bir liste isteği 500 döndürür. Bu durumda isteği yeniden deneyin.
Name
prompt
Type
string
Description
Bir Brick Figür oluşturma görevi için her zaman "".
Name
negative_prompt
Type
string
Description
prompt gibi, bir Brick Figür oluşturma görevi için her zaman "".
Name
texture_prompt
Type
string
Description
prompt gibi, bir Brick Figür oluşturma görevi için her zaman "".
Name
texture_image_url
Type
string
Description
prompt gibi, bir Brick Figür oluşturma görevi için her zaman "".
Name
model_urls
Type
object
Description
3D model için indirme URL'leri, dokulu bir GLB ve MTL dosyasıyla birlikte bir OBJ dosyası olarak.
- Name
  glb
  Type
  string
  Description
  Dokulu GLB dosyası için indirme URL'si.
- Name
  obj
  Type
  string
  Description
  Geometri ve UV'leri içeren OBJ dosyası için indirme URL'si.
- Name
  mtl
  Type
  string
  Description
  obj ile birlikte kullanılan MTL malzeme dosyası için indirme URL'si. Bunu obj ile ve texture_urls[0].base_color içindeki doku ile birlikte kullanın.
Name
thumbnail_url
Type
string
Description
Modelin önizleme görüntüsü için indirme URL'si.
Name
texture_urls
Type
array
Description
Doku haritaları, taban renk haritasını tutan tek bir nesneye sahip bir dizi olarak.
- Name
  base_color
  Type
  string
  Description
  Taban renk haritası için indirme URL'si.