Retexture API

Wygeneruj nowe tekstury dla istniejącego modelu 3D na podstawie prompta tekstowego lub obrazów referencyjnych. Model może pochodzić z innego zadania Meshy lub z pliku modelu.

POST/openapi/v1/retexture

Utwórz zadanie Reteksturowania

Tworzy zadanie Reteksturowania. Zadanie jest wykonywane w tle. Informacje o tym, jak długo zwykle trwa zadanie, znajdziesz w Czasach przetwarzania.

Request

POST

/openapi/v1/retexture

# Retexture with text prompt
curl https://api.meshy.ai/openapi/v1/retexture \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model_url": "https://cdn.meshy.ai/model/example_model_2.glb",
    "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
    "enable_original_uv": true,
    "enable_pbr": true
  }'

# Retexture with image style and PBR
curl https://api.meshy.ai/openapi/v1/retexture \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model_url": "https://cdn.meshy.ai/model/example_model_2.glb",
    "image_style_url": "<your publicly accessible image url or base64-encoded data URI>",
    "ai_model": "latest",
    "enable_pbr": true,
    "enable_original_uv": true
  }'

Response

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

Parametry

Name
input_task_id
Type
string
Wymagane
Description
Wymagane, chyba że wyślesz model_url. ID zadania, które utworzyło model 3D do teksturowania, na przykład zadania Tekst na 3D, Obraz na 3D, Remesh lub Reteksturowanie. Zadanie musi być utworzone przez Ciebie za pomocą API i mieć status SUCCEEDED. Meshy teksturuje plik GLB tego zadania.

Name
model_url
Type
string
Wymagane
Description
Wymagane, chyba że wyślesz input_task_id. Model do teksturowania, jako publiczny adres URL lub data URI. Jeśli wyślesz oba, Meshy użyje input_task_id.
Model musi być plikiem GLB, glTF, OBJ, FBX lub STL o rozmiarze maksymalnie 400 MB z adresu URL http lub https, lub 100 MB jako data URI. Dla data URI użyj typu MIME application/octet-stream, na przykład data:application/octet-stream;base64,<Twoje dane modelu zakodowane w base64>.
Plik powyżej 100 MB musi dodatkowo spełniać te zasady:
- Plik GLB, glTF, FBX lub OBJ może mieć co najwyżej 10 000 000 ścian. Meshy liczy ściany jako trójkąty, więc czworokąt liczy się jako 2, a siatka narysowana więcej niż raz liczy się raz na każdą kopię.
- Plik FBX musi być binarnym FBX w wersji 7.1 lub nowszej.
- Plik GLB lub glTF nie może używać kompresji Draco.

Wyślij jedno z tych trzech wejść stylu.

Name
text_style_prompt
Type
string
Wymagane
Description
Wymagane, chyba że wyślesz image_style_url lub multiview_image_urls. Tekst opisujący pożądaną teksturę, maksymalnie 800 znaków. Dłuższy tekst zwraca 400.

Name
image_style_url
Type
string
Wymagane
Description
Wymagane, chyba że wyślesz text_style_prompt lub multiview_image_urls. Obraz 2D, którego styl ma naśladować tekstura, jako publiczny adres URL lub data URI (data:image/jpeg;base64,<Twoje dane obrazu zakodowane w base64>). Jeśli wyślesz zarówno text_style_prompt, jak i image_style_url, Meshy użyje image_style_url.
Obraz musi być plikiem .jpg, .jpeg, .png lub .webp o rozmiarze maksymalnie 20 MB.
Tekstura może nie pasować dobrze, gdy obiekt na obrazie ma bardzo inny kształt niż model.

Name
multiview_image_urls
Type
string[]
Wymagane
Description
Wymagane, chyba że wyślesz text_style_prompt lub image_style_url. Od jednego do czterech obrazów tego samego obiektu z różnych widoków. Pierwszy obraz to widok główny (z przodu). Kolejność pozostałych widoków (lewy, tylny, prawy) nie ma znaczenia. Pusta tablica lub więcej niż cztery obrazy zwracają 400.
Każdy obraz podlega tym samym zasadom formatu i rozmiaru co image_style_url, maksymalnie 20 MB na obraz. Nie możesz łączyć multiview_image_urls z text_style_prompt lub image_style_url.
multiview_image_urls wymaga jawnego "ai_model": "meshy-7". Jakikolwiek inny ai_model, w tym domyślny latest, zwraca 400.

Name
ai_model
Type
string
domyślne latest
Description
Model AI generujący teksturę.
Dostępne wartości:
- meshy-6-lite
- meshy-6
- meshy-7
- latest: Meshy 7
Name
enable_original_uv
Type
boolean
domyślne false
Description
Czy zachować układ UV modelu zamiast generować nowy.
- Dla modelu wygenerowanego przez Meshy, z input_task_id lub model_url wskazującego na wynik Meshy, użyj true, aby ponownie wykorzystać jego zoptymalizowany układ UV.
- Dla modelu przesłanego skądinąd, użyj true, aby zachować UV, które są już dobre. Pozostaw false, aby Meshy wygenerowało nowe UV, co odpowiada modelowi bez właściwego mapowania UV.
Name
enable_pbr
Type
boolean
domyślne false
Description
Czy generować również mapy PBR (metaliczność, chropowatość i normalną) wraz z kolorem bazowym. Przy meshy-6 Meshy generuje też mapę emisji, z wyjątkiem texture_resolution ustawionego na 8k. meshy-6-lite, meshy-7 i latest nie generują mapy emisji.
Name
texture_resolution
Type
string
domyślne 2k
Description
Rozmiar tekstury koloru bazowego. Wyższe rozdzielczości rejestrują więcej szczegółów powierzchni.
Dostępne wartości:
- 2k: 2048 × 2048 pikseli
- 4k: 4096 × 4096 pikseli
- 8k: 8192 × 8192 pikseli
4k i 8k wymagają ai_model ustawionego na meshy-6, meshy-7 lub latest. Przy meshy-6-lite zwracają 400. Przy 8k Meshy nie generuje mapy emisji.
Name
hd_texture
Type
boolean
⚠ przestarzałe
domyślne false
Description
Użyj zamiast tego texture_resolution. true jest równoważne texture_resolution: "4k". Jeśli wyślesz oba, Meshy użyje texture_resolution.
Name
remove_lighting
Type
boolean
domyślne true
Description
Czy usunąć podświetlenia i cienie z tekstury koloru bazowego. Wynik sprawdza się lepiej przy Twoim własnym oświetleniu.
Meshy stosuje to tylko przy meshy-6, przy texture_resolution ustawionym na 2k lub 4k. Przy meshy-7 lub latest, lub przy 8k, Meshy akceptuje ten parametr i go ignoruje. Przy meshy-6-lite wysłanie go z jakąkolwiek wartością zwraca 400.
Name
target_formats
Type
string[]
Description
Formaty plików do wygenerowania. Meshy generuje tylko wymienione formaty, co może skrócić zadanie. Jeśli pominiesz ten parametr, Meshy generuje każdy format z wyjątkiem 3mf.
Dostępne wartości:
- glb
- obj
- fbx
- stl
- usdz
- 3mf
Name
alpha_thumbnail
Type
boolean
domyślne false
Description
Czy dodatkowo wyrenderować podgląd z przezroczystym tłem (RGBA), zwracany w alpha_thumbnail_url przy pobieraniu zadania. thumbnail_url się nie zmienia.

Zwraca

Pole result odpowiedzi zawiera ID nowego zadania Reteksturowania.

Tryby niepowodzenia

Name
400 - Bad Request
Description
Żądanie nie może zostać wykonane. Komunikat błędu wskazuje, jaki problem wykryto. Na przykład:
- Brakujący parametr: Nie wysłano ani model_url, ani input_task_id.
- Brakujący styl: Nie wysłano żadnego z text_style_prompt, image_style_url ani multiview_image_urls.
- Sprzeczne wejścia stylu: Wysłano multiview_image_urls razem z text_style_prompt lub image_style_url.
- Nieobsługiwany model dla wielu widoków: Wysłano multiview_image_urls bez jawnego "ai_model": "meshy-7".
- Nieprawidłowe zadanie wejściowe: input_task_id nie jest zakończonym powodzeniem zadaniem obsługiwanego typu.
- Nieprawidłowy format modelu: Plik model_url ma nieobsługiwane rozszerzenie.
- Niedostępny adres URL: Meshy nie może pobrać pliku model_url, obrazu image_style_url ani obrazu z multiview_image_urls.
- Plik modelu zbyt duży: Plik model_url ma ponad 400 MB z adresu URL http lub https, lub ponad 100 MB jako data URI.
- Zbyt wiele ścian: Plik model_url ma ponad 100 MB i więcej niż 10 000 000 ścian. Zmniejsz liczbę ścian i wyślij plik ponownie.
- ASCII FBX powyżej 100 MB: Plik model_url to ASCII FBX o rozmiarze ponad 100 MB. Wyślij go jako binarny FBX lub GLB.
- Nieodczytywalny plik modelu: Plik model_url ma ponad 100 MB, a Meshy nie może odczytać jego nagłówka. Na przykład to GLB lub glTF skompresowany Draco, lub binarny FBX starszy niż 7.1.
- Nagłówek modelu zbyt złożony: Plik model_url ma ponad 100 MB, a jego nagłówek zawiera zbyt wiele siatek, węzłów lub rekordów do sprawdzenia. Zmniejsz liczbę obiektów w pliku i wyślij go ponownie.
- Obraz zbyt duży: Obraz image_style_url lub obraz z multiview_image_urls ma ponad 20 MB.
Popraw żądanie i wyślij je ponownie. Zobacz Błędy.
Name
401 - Unauthorized
Description
Brakuje klucza API lub jest on nieprawidłowy. Sprawdź nagłówek Authorization.
Name
402 - Payment Required
Description
Na przykład:
- Niewystarczające kredyty: Konto nie ma wystarczającej liczby kredytów na to zadanie lub konto osiągnęło limit kredytów. Sprawdź saldo kredytów, a następnie spróbuj ponownie.
- Plan darmowy: Utworzenie zadania wymaga płatnego planu. Ulepsz swój plan w ustawieniach subskrypcji, a następnie spróbuj ponownie.
Name
403 - Forbidden
Description
input_task_id to model płaskorzeźby, którego ten punkt końcowy nie może reteksturować. Komunikat brzmi This model type does not support this operation. Wyślij inny model.
Name
404 - Not Found
Description
input_task_id nie pasuje do żadnego z Twoich zadań. Sprawdź ID zadania, a następnie wyślij żądanie ponownie.
Name
429 - Too Many Requests
Description
Przekroczono limit szybkości. Odczekaj, a następnie spróbuj ponownie. Zobacz Limity szybkości.

GET/openapi/v1/retexture/:id

Pobierz zadanie Reteksturowania

Zwraca zadanie Reteksturowania na podstawie jego ID.

Request

GET

/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578

curl https://api.meshy.ai/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "retexture",
  "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=***",
    "mtl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.mtl?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
  "texture_image_url": "",
  "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"
    }
  ],
  "task_error": {

    "message": ""

  },

  "consumed_credits": 10
}

Parametry

Name
id
Type
path
Description
ID zadania z odpowiedzi utworzenia.

Zwraca

Obiekt zadania Reteksturowania.

DELETE/openapi/v1/retexture/:id

Usuń zadanie Reteksturowania

Trwale usuwa zadanie Reteksturowania, łącznie z jego modelami i danymi. Nie można cofnąć usunięcia.

Request

DELETE

/openapi/v1/retexture/a43b5c6d-7e8f-901a-234b-567c890d1e2f

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/retexture/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
  -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."
}

Parametry ścieżki

Name
id
Type
path
Description
ID zadania do usunięcia.

Status zadania

Usunięcie zadania o statusie PENDING zwraca kredyty użyte podczas jego tworzenia.

Zadania o statusie IN_PROGRESS nie można usunąć. Żądanie zwraca 409 Conflict, a zadanie nadal się wykonuje. Meshy nie zwraca kredytów za zadanie, które już się rozpoczęło, więc usunięcie go kosztowałoby Cię zarówno kredyty, jak i wynik. Poczekaj, aż osiągnie status SUCCEEDED, FAILED lub CANCELED, a następnie je usuń.

Usunięcie zadania o statusie końcowym (SUCCEEDED, FAILED lub CANCELED) nie powoduje zwrotu kredytów.

Zwraca

200 OK, gdy zadanie zostanie usunięte, lub 409 Conflict, gdy zadanie ma status IN_PROGRESS.

GET/openapi/v1/retexture

List tasks Reteksturowania

Zwraca listę Twoich tasków Reteksturowania.

Request

GET

/openapi/v1/retexture

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

Response

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "retexture",
    "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=***",
      "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***"
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
    "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
    "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": {

      "message": ""

    },

    "consumed_credits": 10
  }
]

Parametry

Name
page_num
Type
integer
domyślne 1
Description
Numer strony do zwrócenia.
Name
page_size
Type
integer
domyślne 10
Description
Liczba tasków na stronę, maksymalnie 100.
Name
sort_by
Type
string
Description
Kolejność sortowania.
Dostępne wartości:
- +created_at: od najstarszych
- -created_at: od najnowszych

Zwraca

Listę stronicowaną obiektów tasków Reteksturowania.

GET/openapi/v1/retexture/:id/stream

Przesyłanie strumieniowe zadania Reteksturowania

Przesyła strumieniowo aktualizacje zadania Reteksturowania jako zdarzenia wysyłane przez serwer (SSE).

Request

GET

/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578/stream

curl -N https://api.meshy.ai/openapi/v1/retexture/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",
  "progress": 50,
  "status": "IN_PROGRESS"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "retexture",
  "progress": 100,
  "status": "SUCCEEDED",
  "created_at": 1692771650657,
  "started_at": 1692771667037,
  "finished_at": 1692771669037,
  "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=***",
    "mtl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.mtl?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***"
  },
  "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": {

    "message": ""

  },

  "consumed_credits": 10
}

Parametry

Name
id
Type
path
Description
ID zadania z odpowiedzi na żądanie utworzenia.

Zwraca

Strumień obiektów zadania Reteksturowania w formie zdarzeń wysyłanych przez serwer.

Każde zdarzenie zawiera pełny obiekt zadania, w tej samej postaci, jaką zwraca punkt końcowy Get. Dopóki zadanie ma status PENDING lub IN_PROGRESS, jego pola wynikowe nie mają jeszcze wartości.

Obiekt zadania Reteksturowania

Obiekt zadania Reteksturowania opisuje jedno reteksturowanie modelu 3D. Zawiera status, progress oraz pliki modelu i tekstury, gdy zadanie zakończy się powodzeniem.

Właściwości

Example Retexture Task Model

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "retexture",
  "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=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***"
  },
  "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
  "image_style_url": "https://assets.meshy.ai/***/image/example_image.jpg?Expires=***",
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "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": {

    "message": ""

  },

  "consumed_credits": 10
}

Name
id
Type
string
Description
ID zadania. Traktuj je jako nieprzejrzysty ciąg znaków i nie polegaj na jego formacie.
Name
type
Type
string
Description
Typ zadania, zawsze retexture.
Name
model_urls
Type
object
Description
Adresy URL do pobrania teksturowanego modelu 3D, po jednym dla każdego formatu pliku.
- Name
  glb
  Type
  string
  Description
  Plik GLB.
- Name
  fbx
  Type
  string
  Description
  Plik FBX.
- Name
  obj
  Type
  string
  Description
  Plik OBJ.
- Name
  usdz
  Type
  string
  Description
  Plik USDZ.
- Name
  mtl
  Type
  string
  Description
  Plik MTL. Meshy zwraca go wraz z plikiem OBJ, gdy model ma tekstury.
- Name
  stl
  Type
  string
  Description
  Plik STL.
- Name
  3mf
  Type
  string
  Description
  Plik 3MF. Obecny tylko wtedy, gdy target_formats zawiera 3mf.
Name
text_style_prompt
Type
string
Description
Prompt tekstowy, z którym utworzono zadanie.
Name
image_style_url
Type
string
Description
Obraz stylu, z którym utworzono zadanie.
Name
multiview_image_urls
Type
string[]
Description
Adresy URL do pobrania obrazów referencyjnych Wiele widoków, z którymi utworzono zadanie. Obecne tylko wtedy, gdy zadanie zostało utworzone z multiview_image_urls.
Name
thumbnail_url
Type
string
Description
Adres URL do pobrania miniatury modelu.
Name
alpha_thumbnail_url
Type
string
Description
Adres URL do pobrania wersji thumbnail_url z przezroczystym tłem (RGBA). Obecny tylko wtedy, gdy zadanie zostało utworzone z alpha_thumbnail: true, a Meshy wyrenderowało przezroczysty podgląd.
Name
progress
Type
integer
Description
Ile procent zadania zostało wykonane, wyrażone jako wartość procentowa. Wynosi 0 do momentu rozpoczęcia zadania i 100, gdy zadanie zakończy się powodzeniem.
Name
started_at
Type
timestamp
Description
Czas rozpoczęcia zadania, w milisekundach Unix. Wynosi 0 do momentu rozpoczęcia zadania.
Name
created_at
Type
timestamp
Description
Czas utworzenia zadania, w milisekundach Unix.
Name
expires_at
Type
timestamp
Description
Czas wygaśnięcia wyników zadania, w milisekundach Unix.
Name
finished_at
Type
timestamp
Description
Czas zakończenia zadania, w milisekundach Unix. Wynosi 0 do momentu zakończenia zadania.
Name
status
Type
string
Description
Status zadania, jeden z: PENDING, IN_PROGRESS, SUCCEEDED, FAILED lub CANCELED.
Name
texture_urls
Type
array
Description
Adresy URL do pobrania wygenerowanych tekstur, jako tablica obiektów. Tablica zazwyczaj zawiera jeden obiekt. Każdy obiekt ma następujące pola:
- Name
  base_color
  Type
  string
  Description
  Adres URL do pobrania mapy koloru bazowego.
- Name
  metallic
  Type
  string
  Description
  Adres URL do pobrania mapy metaliczności. Meshy pomija to pole, gdy zadanie zostało utworzone z enable_pbr: false.
- Name
  normal
  Type
  string
  Description
  Adres URL do pobrania mapy normalnych. Meshy pomija to pole, gdy zadanie zostało utworzone z enable_pbr: false.
- Name
  roughness
  Type
  string
  Description
  Adres URL do pobrania mapy chropowatości. Meshy pomija to pole, gdy zadanie zostało utworzone z enable_pbr: false.
- Name
  emission
  Type
  string
  Description
  Adres URL do pobrania mapy emisji. Meshy pomija to pole, gdy zadanie zostało utworzone z dowolnym z poniższych:
  
  enable_pbr: false
  
  ai_model o wartości meshy-6-lite, meshy-7 lub latest
  
  texture_resolution: 8k
Name
preceding_tasks
Type
integer
Description
Liczba zadań znajdujących się w kolejce przed tym zadaniem. Obecne tylko wtedy, gdy zadanie ma status PENDING.
Name
task_error
Type
object
Description
Szczegóły błędu, gdy zadanie zakończy się niepowodzeniem. Zobacz Błędy.
Name
consumed_credits
Type
integer
Description
Liczba kredytów wykorzystanych przez zadanie. Obecne, gdy status to PENDING, IN_PROGRESS lub SUCCEEDED. Dla zadania ze statusem FAILED wynosi 0, ponieważ Meshy zwraca kredyty, gdy zadanie zakończy się niepowodzeniem.