Yeniden Boyutlandır API'si

Yeniden Boyutlandır API'si, mevcut 3D modelleri gerçek dünya ölçülerine göre yeniden boyutlandırmanıza olanak tanır. Tam bir yükseklik, en uzun kenar kısıtı belirtebilir veya yapay zekanın uygun boyutu otomatik olarak tahmin etmesini sağlayabilirsiniz.

POST/openapi/v1/resize

Yeniden Boyutlandırma Görevi Oluştur

Bu uç nokta yeni bir yeniden boyutlandırma görevi oluşturur.

Parametreler

input_task_id veya model_url öğelerinden yalnızca biri gereklidir. İkisi de sağlanırsa, input_task_id öncelik alır.

Name
input_task_id
Type
string
Zorunlu
Description
Yeniden boyutlandırmak istediğiniz modeli içeren tamamlanmış bir Meshy görevinin ID'si. Görevin durumu SUCCEEDED olmalıdır. Çıktı formatı GLB olacaktır.

Name
model_url
Type
string
Zorunlu
Description
Bir 3D model dosyasına işaret eden herkese açık erişilebilir bir URL veya Data URI. Desteklenen formatlar: .glb, .gltf, .obj, .fbx, .stl. Data URI'ler için MIME type olarak şunu kullanın: application/octet-stream. Çıktı formatı, girdi modelinin orijinal formatını koruyacaktır.

Tam olarak bir yeniden boyutlandırma mode'u gereklidir: resize_height, resize_longest_side veya auto_size. Bu üç parametre birbirini dışlar.

Name
resize_height
Type
number
Description
Modeli metre cinsinden ölçülen belirli bir yüksekliğe yeniden boyutlandırın.

Name
resize_longest_side
Type
number
Description
Modeli, en uzun kenarı metre cinsinden ölçülen bu değerle eşleşecek şekilde yeniden boyutlandırın. En boy oranı korunur.

Name
auto_size
Type
boolean
Description
true olarak ayarlandığında, hizmet nesnenin gerçek dünyadaki yüksekliğini otomatik olarak tahmin etmek ve modeli buna göre yeniden boyutlandırmak için AI vision kullanır. origin_at açıkça ayarlanmadığı sürece orijin varsayılan olarak bottom olur.

Name
origin_at
Type
string
varsayılan bottom
Description
Yeniden boyutlandırmadan sonra orijinin konumu.
Kullanılabilir değerler: bottom, center.

Döndürür

Yanıtın result özelliği, yeni oluşturulan yeniden boyutlandırma görevinin id değerini içerir.

Hata Modları

400 - Bad Request

İstek kabul edilemezdi. Yaygın nedenler:

Eksik parametre: model_url veya input_task_id sağlanmalıdır.
Eksik yeniden boyutlandırma mode'u: resize_height, resize_longest_side veya auto_size öğelerinden en az biri belirtilmelidir.
Birbirini dışlayan parametreler: resize_height, resize_longest_side ve auto_size birlikte kullanılamaz.
Geçersiz girdi görevi: input_task_id başarılı bir göreve başvurmalıdır.
Geçersiz model formatı: model_url, desteklenmeyen bir uzantıya sahip bir dosyaya işaret ediyor.
Erişilemeyen URL: model_url indirilemedi.

401 - Unauthorized

Kimlik doğrulama başarısız oldu. Lütfen API anahtarınızı kontrol edin.

402 - Payment Required

Bu görevi gerçekleştirmek için yetersiz kredi.

429 - Too Many Requests

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

Request

POST

/openapi/v1/resize

# Simple: resize to a specific height
curl https://api.meshy.ai/openapi/v1/resize \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "resize_height": 1.8
  }'

# Advanced: resize longest side with custom origin
curl https://api.meshy.ai/openapi/v1/resize \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "model_url": "https://example.com/model.glb",
    "resize_longest_side": 2.0,
    "origin_at": "center"
  }'

Response

{
  "result": "0193bfc5-ee4f-73f8-8525-44b398884ce9"
}

GET/openapi/v1/resize/:id

Yeniden boyutlandır Görevini Getir

Bu uç nokta, bir yeniden boyutlandır görevini ID'sine göre getirir.

Parametreler

Name
id
Type
path
Description
Getirilecek yeniden boyutlandır görevinin ID'si.

Döndürür

Yeniden boyutlandır Görevi nesnesi.

Request

GET

/openapi/v1/resize/:id

curl https://api.meshy.ai/openapi/v1/resize/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "resize",
  "model_urls": {
      "glb": "https://assets.meshy.ai/.../model.glb?Expires=..."
  },
  "progress": 100,
  "status": "SUCCEEDED",
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "task_error": null,
  "consumed_credits": 1
}

DELETE/openapi/v1/resize/:id

Yeniden Boyutlandırma Görevini Sil

Bu uç nokta, tüm ilişkili modeller ve veriler dahil olmak üzere bir yeniden boyutlandırma görevini kalıcı olarak siler. Bu işlem geri alınamaz.

Yol Parametreleri

Name
id
Type
path
Description
Silinecek yeniden boyutlandırma görevinin ID'si.

Döndürür

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

Request

DELETE

/openapi/v1/resize/:id

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/resize/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// Returns 200 Ok on success.

GET/openapi/v1/resize

Yeniden Boyutlandırma Görevlerini Listele

Bu uç nokta, yeniden boyutlandırma görevlerinin listesini almanızı sağlar.

Parametreler

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 değer 50 öğedir.

Name
sort_by
Type
string
Description
Sıralama yapılacak alan. Kullanılabilir değerler:
- +created_at: Oluşturulma zamanına göre artan sırada sırala.
- -created_at: Oluşturulma zamanına göre azalan sırada sırala.

Dönen Değerler

Yeniden Boyutlandırma Görevi Nesneleri için sayfalanmış bir liste döndürür.

Request

GET

/openapi/v1/resize

curl https://api.meshy.ai/openapi/v1/resize?page_size=10 \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

[
  {
    "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
    "type": "resize",
    "model_urls": {
      "glb": "https://assets.meshy.ai/.../model.glb?Expires=..."
    },
    "progress": 100,
    "status": "SUCCEEDED",
    "created_at": 1699999999000,
    "started_at": 1700000000000,
    "finished_at": 1700000001000,
    "task_error": null,
    "consumed_credits": 1
  }
]

GET/openapi/v1/resize/:id/stream

Bir Yeniden boyutlandır Görevini Akışla Aktar

Bu uç nokta, Server-Sent Events (SSE) kullanarak bir Yeniden boyutlandır görevi için gerçek zamanlı güncellemeleri akış olarak aktarır.

Parametreler

Name
id
Type
path
Description
Akış olarak aktarılacak Yeniden boyutlandır görevi için benzersiz tanımlayıcı.

Döndürür

Server-Sent Events olarak Yeniden boyutlandır Görev Nesneleri 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çerir.

Request

GET

/openapi/v1/resize/:id/stream

curl -N https://api.meshy.ai/openapi/v1/resize/a43b5c6d-7e8f-901a-234b-567c890d1e2f/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Message event examples illustrate task progress.
event: message
data: {
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "resize",
  "model_urls": {
    "glb": "https://assets.meshy.ai/.../model.glb?Expires=..."
  },
  "progress": 100,
  "status": "SUCCEEDED",
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "task_error": null,
  "consumed_credits": 1
}

Yeniden Boyutlandırma Görev Nesnesi

Yeniden Boyutlandırma Görevi nesnesi, bir yeniden boyutlandırma işini temsil eder.

Özellikler

id · dize

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

type · dize

Görevin türü. Değer resize şeklindedir.

model_urls · nesne

Yeniden boyutlandırılmış model dosyası için indirilebilir URL. input_task_id kullanıldığında çıktı her zaman GLB olur. model_url kullanıldığında çıktı orijinal formatı korur.

progress · tam sayı

Görevin progress değeri (0-100).

status · dize

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

preceding_tasks · tam sayı

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

created_at · zaman damgası

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

started_at · zaman damgası

Görevin başlatıldığı zaman damgası, milisaniye cinsinden. Başlatılmadıysa 0.

finished_at · zaman damgası

Görevin tamamlandığı zaman damgası, milisaniye cinsinden. Tamamlanmadıysa 0.

task_error · nesne

Görev başarısız olduysa hata nesnesi. Daha fazla ayrıntı için Hatalar bölümüne bakın.

consumed_credits · tam sayı

Bu görev tarafından tüketilen kredi sayısı (yeniden boyutlandırma görevi başına 1 kredi). FAILED görevleri için 0 döndürür.