Creative Lab — Vinyl Figure API

Przekształć zdjęcie źródłowe w 3D figurkę kolekcjonerską z dużą głową w dwóch etapach: prototyp generuje stylizowany obraz koncepcyjny z Twojego zdjęcia wejściowego, następnie buduj przekształca ten obraz koncepcyjny w trójwymiarowy model z teksturą. Oba etapy są połączone przez input_task_id.

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

POST/openapi/creative-lab/vinyl-figure/v1/prototype

Utwórz zadanie prototypu figurki winylowej

Wygeneruj obraz koncepcyjny w stylu figurki winylowej z oryginalnego zdjęcia. Zwrócone ID zadania to to, co przekazujesz jako input_task_id do punktu końcowego build. Odwołaj się do Obiekt zadania prototypu figurki winylowej aby zobaczyć kształt odpowiedzi.

Parametry

  • Name
    image_url
    Type
    string
    Wymagane
    Description

    Źródłowe zdjęcie dla Meshy do stylizacji jako figurka winylowa z dużą głową. Obecnie obsługujemy formaty .jpg, .jpeg, .png i .webp.

    Istnieją dwa sposoby dostarczenia zdjęcia:

    • Publicznie dostępny URL: URL, który jest dostępny z publicznego internetu.
    • Data URI: Dane obrazu zakodowane w base64. Przykład Data URI: data:image/jpeg;base64,<twoje zakodowane dane obrazu w base64>.
  • Name
    name
    Type
    string
    Description

    Opcjonalna nazwa zadania do celów wyświetlania. Maksymalnie 100 znaków.

Zwroty

Właściwość result odpowiedzi zawiera id nowo utworzonego zadania prototypu figurki winylowej. Śledź Pobierz zadanie punkt końcowy lub subskrybuj strumień aż zadanie osiągnie SUCCEEDED, a następnie przekaż to ID do punktu końcowego build jako input_task_id.

Tryby niepowodzenia

  • Name
    400 - Bad Request
    Description

    Żądanie było nieakceptowalne. Częste przyczyny:

    • Brakujący parametr: image_url jest wymagany.
    • Nieprawidłowy format obrazu: Dostarczony image_url nie jest obsługiwanym formatem (.jpg, .jpeg, .png, .webp).
    • Rozdzielczość obrazu poza zakresem: Obraz jest zbyt mały, przekracza maksymalny rozmiar pliku lub przekracza maksymalną liczbę pikseli.
    • Nieosiągalny URL: image_url nie mógł zostać pobrany (404 lub timeout).
    • Nieprawidłowy Data URI: Ciąg base64 jest źle sformułowany.
    • Zawartość oznaczona: Obraz wejściowy został oznaczony przez moderation NSFW lub własności intelektualnej.
  • Name
    401 - Unauthorized
    Description

    Uwierzytelnianie nie powiodło się. Sprawdź swój klucz API.

  • Name
    402 - Payment Required
    Description

    Niewystarczające kredyty do wykonania tego zadania.

  • Name
    429 - Too Many Requests
    Description

    Przekroczyłeś swój limit szybkości.

Request

POST
/openapi/creative-lab/vinyl-figure/v1/prototype
# Etap 1: wygeneruj obraz koncepcyjny w stylu figurki winylowej
curl https://api.meshy.ai/openapi/creative-lab/vinyl-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": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de"
}
Prototype example
Start with a source portrait, then generate the prototype image used by the build stage.
Source photo used as the Creative Lab Vinyl Figure input
Prototype input
Big-head vinyl figure prototype image generated from the source photo
Prototype output

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

Utwórz zadanie budowy winylowej figurki

Wygeneruj finalną teksturowaną trójwymiarową winylową figurkę na podstawie udanego zadania prototypowego. Budowa wykorzystuje ten sam proces Obraz na 3D, co Obraz na 3D, więc format obiektu odpowiedzi i lista adresów URL wyników są dokładnie takie same. Zapoznaj się z Obiekt zadania budowy winylowej figurki aby poznać kształt odpowiedzi.

Parametry

  • Name
    input_task_id
    Type
    string
    Wymagane
    Description

    ID zadania prototypowego utworzonego za pośrednictwem tego samego punktu końcowego OpenAPI. Prototyp musi zostać utworzony z użyciem tego samego klucza API, musi osiągnąć SUCCEEDED, i musi wygenerować dokładnie jeden obraz kandydacki.

    Zadania prototypowe utworzone za pośrednictwem aplikacji webowej nie są akceptowane — punkt końcowy budowy akceptuje tylko zadania prototypowe wygenerowane przez POST /openapi/creative-lab/vinyl-figure/v1/prototype i odrzuca każde inne źródło z 404.

  • Name
    name
    Type
    string
    Description

    Opcjonalna nazwa zadania do celów wyświetlania. Maksymalnie 100 znaków.

Zwroty

Właściwość result odpowiedzi zawiera ID zadania nowo utworzonego zadania budowy winylowej figurki. Sprawdź punkt końcowy Pobierz zadanie lub subskrybuj stream do momentu gdy zadanie osiągnie SUCCEEDED, a następnie pobierz teksturowany GLB z model_urls.glb (lub parę OBJ + MTL z model_urls.obj i model_urls.mtl jeśli twój dalszy proces preferuje OBJ).

Tryby błędów

  • Name
    400 - Bad Request
    Description

    Żądanie było nieakceptowalne. Typowe przyczyny:

    • Brakujący parametr: input_task_id jest wymagany.
    • Nieprawidłowy UUID: input_task_id nie jest prawidłowym UUID.
    • Parent not succeeded: Wskazane zadanie prototypowe nie osiągnęło jeszcze SUCCEEDED.
    • Brak kandydata: Zadanie prototypowe zakończyło się pomyślnie, ale nie wygenerowało obrazu kandydata.
  • Name
    401 - Unauthorized
    Description

    Uwierzytelnianie nie powiodło się. Proszę sprawdzić klucz API.

  • Name
    402 - Payment Required
    Description

    Niewystarczająca liczba kredytów do wykonania tego zadania.

  • Name
    404 - Not Found
    Description

    Wskazane zadanie prototypowe nie istnieje, należy do innego użytkownika, lub zostało utworzone za pośrednictwem aplikacji webowej (tylko zadania prototypowe w trybie API zmieniają się w budowę).

  • Name
    429 - Too Many Requests
    Description

    Przekroczono limit szybkości.

Request

POST
/openapi/creative-lab/vinyl-figure/v1/build
# Etap 2: łańcuch budowy z udanego zadania prototypu
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "input_task_id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de"
  }'

Response

{
  "result": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef"
}

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

Pobierz zadanie Vinyl Figure

Pobierz prototyp lub zadanie budowy, mając ważne id zadania. Ścieżka URL musi odpowiadać etapowi zadania — zadanie budowy pobrane przez /prototype/:id zwróci 404, i odwrotnie.

Odnieś się do Obiekt zadania prototypu Vinyl Figure oraz Obiekt zadania budowy Vinyl Figure dla kształtów odpowiedzi.

Parametry

  • Name
    id
    Type
    path
    Description

    Unikalny identyfikator zadania vinyl figure do pobrania.

Zwraca

Odpowiedź zawiera obiekt zadania vinyl figure. Kształt zależy od wymaganego etapu.

Żądanie

GET
/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de
# Prototyp
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# Budowa
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Odpowiedź Prototypu

{
  "id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de",
  "type": "creative-lab-vinyl-figure-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969600000,
  "started_at": 1752969604000,
  "finished_at": 1752969630000,
  "expires_at": 1753228830000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Odpowiedź Budowy

{
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "type": "creative-lab-vinyl-figure-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969700000,
  "started_at": 1752969710000,
  "finished_at": 1752969735000,
  "expires_at": 1753228935000,
  "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/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/texture_0.png?Expires=***"
    }
  ]
}
DELETE/openapi/creative-lab/vinyl-figure/v1/(prototype|build)/:id

Usuń zadanie dotyczące figurki winylowej

Anuluj zadanie dotyczące figurki winylowej. Jeśli zadanie jest jeszcze PENDING, kredyty zużyte w momencie tworzenia są zwracane. Zadania, które są już IN_PROGRESS, są anulowane bez zwrotu (pracownik może już być w trakcie zużywania zasobów). Zadania, które osiągnęły stan końcowy (SUCCEEDED, FAILED, CANCELED), nie mogą być anulowane.

Ścieżka URL musi odpowiadać etapowi zadania — DELETE na /prototype/:buildId zwraca 404.

Parametry ścieżki

  • Name
    id
    Type
    path
    Description

    Unikalny identyfikator zadania dotyczącego figurki winylowej do anulowania.

Zwracane wartości

Zwraca 204 No Content w przypadku sukcesu z pustym ciałem.

Tryby błędów

  • Name
    400 - Bad Request
    Description

    Zadanie jest już w stanie końcowym i nie może być anulowane.

  • Name
    404 - Not Found
    Description

    Zadanie nie istnieje, należy do innego użytkownika lub jego etap nie odpowiada ścieżce URL.

Request

DELETE
/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de
curl --request DELETE \
  --url https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// Zwraca 204 No Content w przypadku sukcesu (puste ciało).

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

Transmisja zadania figurki winylowej

Przesyłaj aktualizacje w czasie rzeczywistym dla zadania figurki winylowej za pomocą Server-Sent Events (SSE). Ścieżka URL musi pasować do etapu zadania — otwarcie strumienia na /prototype/:buildId/stream emituje pojedynczy event: error z ładunkiem status_code: 404 i zamyka strumień.

Parametry

  • Name
    id
    Type
    path
    Description

    Unikalny identyfikator zadania figurki winylowej do transmisji.

Zwraca

Zwraca strumień obiektów zadania Vinyl Figure Prototype lub Vinyl Figure Build jako Server-Sent Events. Dla zadań PENDING lub IN_PROGRESS, strumień odpowiedzi będzie zawierać tylko niezbędne pola progress i status.

Request

GET
/openapi/creative-lab/vinyl-figure/v1/build/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/stream
curl -N https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Przyklad zdarzenia błędu (niewłaściwy etap lub zadanie nie znalezione)
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Przykłady zdarzeń komunikatu ilustrujących postęp zadania.
// Dla zadań PENDING lub IN_PROGRESS, strumień odpowiedzi nie będzie zawierał wszystkich pól.
event: message
data: {
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "type": "creative-lab-vinyl-figure-build",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969700000,
  "started_at": 1752969710000,
  "finished_at": 1752969735000,
  "expires_at": 1753228935000,
  "task_error": null,
  "consumed_credits": 30,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/texture_0.png?Expires=***"
    }
  ]
}
GET/openapi/creative-lab/vinyl-figure/v1/(prototype|build)

Lista zadań dla winylowych Figurek

Pobierz stronicowaną listę swoich zadań dla winylowych figurek na jednym etapie. Ścieżka URL wybiera etap — /prototype zwraca zadania dotyczące prototypów; /build zwraca zadania dotyczące budowy. Zadania z innego etapu nie są zawarte w żadnej z odpowiedzi.

Parametry Ścieżki

  • Name
    stage
    Type
    path
    Wymagane
    Description

    Albo prototype albo build. Kolekcja zwraca tylko zadania, których etap odpowiada URL — pobierając /prototype nigdy nie zwraca zadań budowy i vice versa.

Parametry Zapytania

  • Name
    page_num
    Type
    integer
    domyślne 1
    Description

    Numer strony dla stronicowania.

  • Name
    page_size
    Type
    integer
    domyślne 10
    Description

    Limit rozmiaru strony. Dozwolone maksimum to 50 elementów.

  • Name
    sort_by
    Type
    string
    domyślne -created_at
    Description

    Pole do sortowania. Dostępne wartości:

    • +created_at: Sortuj według czasu utworzenia w porządku rosnącym.
    • -created_at: Sortuj według czasu utworzenia w porządku malejącym.

Zwraca

Zwraca stronicowaną listę obiektów zadań dla etapu — zarówno obiekt zadania prototypu winylowej figurki przy listowaniu /prototype albo obiekt zadania budowy winylowej figurki przy listowaniu /build.

Request

GET
/openapi/creative-lab/vinyl-figure/v1/prototype
# Listuj zadania prototypu
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

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

Response (List Prototype Tasks)

[
  {
    "id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de",
    "type": "creative-lab-vinyl-figure-prototype",
    "name": "",
    "status": "SUCCEEDED",
    "progress": 100,
    "created_at": 1752969600000,
    "started_at": 1752969604000,
    "finished_at": 1752969630000,
    "expires_at": 1753228830000,
    "preceding_tasks": 0,
    "task_error": null,
    "consumed_credits": 6,
    "image_urls": [
      "https://assets.meshy.ai/***/concept.png?Expires=***"
    ]
  }
]

Obiekt zadania prototypu figurki winylowej

Obiekt zadania prototypu figurki winylowej jest jednostką pracy, którą Meshy śledzi, aby wygenerować obraz koncepcji w stylu figurki winylowej z fotografii źródłowej. Wynik tego etapu jest powiązany z etapem budowy za pomocą input_task_id.

Właściwości

  • Name
    id
    Type
    string
    Description

    Unikalny identyfikator zadania. Używamy UUID k-sortowalnego dla identyfikatorów zadań jako szczegółu implementacyjnego, nie powinieneś jednak zakładać żadnego formatu tego identyfikatora.

  • Name
    type
    Type
    string
    Description

    Typ zadania. Wartość wynosi creative-lab-vinyl-figure-prototype.

  • Name
    name
    Type
    string
    Description

    Nazwa zadania podana przy jego tworzeniu. Pusty string, jeśli nie podano nazwy.

  • Name
    status
    Type
    string
    Description

    Status zadania. Możliwe wartości to: PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

  • Name
    progress
    Type
    integer
    Description

    Postęp zadania. Jeśli zadanie jeszcze się nie rozpoczęło, ta właściwość będzie miała wartość 0. Po zakończeniu zadania będzie to 100.

  • Name
    created_at
    Type
    timestamp
    Description

    Znacznik czasu utworzenia zadania, w milisekundach.

  • Name
    started_at
    Type
    timestamp
    Description

    Znacznik czasu rozpoczęcia zadania, w milisekundach. Jeśli zadanie jeszcze nie rozpoczęło się, ta właściwość będzie miała wartość 0.

  • Name
    finished_at
    Type
    timestamp
    Description

    Znacznik czasu zakończenia zadania, w milisekundach. Jeśli zadanie jeszcze się nie zakończyło, ta właściwość będzie miała wartość 0.

  • Name
    expires_at
    Type
    timestamp
    Description

    Znacznik czasu wygaśnięcia wyniku zadania, w milisekundach.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Liczba zadań poprzedzających.

  • Name
    task_error
    Type
    object
    Description

    Szczegóły błędu dla nieudanych zadań. Zobacz Błędy dla pełnej dokumentacji obiektu task_error.

  • Name
    consumed_credits
    Type
    integer
    Description

    Liczba kredytów wykorzystanych przez to zadanie. Obecna, gdy status zadania to PENDING, IN_PROGRESS lub SUCCEEDED. Dla zadań FAILED zwraca 0 (kredyty są zwracane w przypadku niepowodzenia).

  • Name
    image_urls
    Type
    array of strings
    Description

    Adresy URL do pobrania obrazów koncepcyjnych generowanych przez to prototypowe zadanie. Obecnie API zawsze zwraca dokładnie jednego kandydata; pole to jest tablicą, aby przyszłe wersje mogły prezentować wielu kandydatów bez zmiany kompatybilności.

Example Vinyl Figure Prototype Task Object

{
  "id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de",
  "type": "creative-lab-vinyl-figure-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969600000,
  "started_at": 1752969604000,
  "finished_at": 1752969630000,
  "expires_at": 1753228830000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Obiekt zadania tworzenia figurki winylowej

Obiekt zadania tworzenia figurki winylowej to jednostka pracy, którą Meshy śledzi, aby wygenerować teksturowaną winylową figurkę 3D z zakończonego sukcesem zadania prototypowego. Wykorzystuje ten sam proces przekształcania obrazu na 3D używany przez Obraz na 3D, więc pola wyjściowe odzwierciedlają obiekt zadania tego punktu końcowego task object.

Właściwości

  • Name
    id
    Type
    string
    Description

    Unikalny identyfikator zadania.

  • Name
    type
    Type
    string
    Description

    Typ zadania. Wartość to creative-lab-vinyl-figure-build.

  • Name
    name
    Type
    string
    Description

    Nazwa zadania podana podczas tworzenia zadania. Pusty ciąg znaków, jeśli nazwa nie została podana.

  • Name
    status
    Type
    string
    Description

    Status zadania. Możliwe wartości to PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

  • Name
    progress
    Type
    integer
    Description

    Postęp zadania. Jeśli zadanie nie jest jeszcze rozpoczęte, ta właściwość będzie miała wartość 0. Gdy zadanie zakończy się pomyślnie, osiągnie wartość 100.

  • Name
    created_at
    Type
    timestamp
    Description

    Znacznik czasu utworzenia zadania, w milisekundach.

  • Name
    started_at
    Type
    timestamp
    Description

    Znacznik czasu rozpoczęcia zadania, w milisekundach.

  • Name
    finished_at
    Type
    timestamp
    Description

    Znacznik czasu zakończenia zadania, w milisekundach.

  • Name
    expires_at
    Type
    timestamp
    Description

    Znacznik czasu wygaśnięcia wyniku zadania, w milisekundach.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Liczba poprzedzających zadań. Istotne tylko, gdy status to PENDING.

  • Name
    task_error
    Type
    object
    Description

    Szczegóły błędów dla niepowodzeń zadania. Zobacz Błędy dla pełnej referencji obiektu task_error.

  • Name
    consumed_credits
    Type
    integer
    Description

    Liczba kredytów zużytych przez to zadanie. Zwraca 0 dla zadań FAILED (kredyty są zwracane w przypadku niepowodzenia).

  • Name
    prompt
    Type
    string
    Description

    Zawsze puste dla budowy winylowej figurki. Obecne dla kompatybilności między punktami końcowymi z udostępnionym kształtem V2ImageTo3DTaskResponse używanym przez Obraz na 3D.

  • Name
    negative_prompt
    Type
    string
    Description

    Zawsze puste dla budowy winylowej figurki. Obecne dla kompatybilności między punktami końcowymi.

  • Name
    texture_prompt
    Type
    string
    Description

    Zawsze puste dla budowy winylowej figurki. Obecne dla kompatybilności między punktami końcowymi.

  • Name
    texture_image_url
    Type
    string
    Description

    Zawsze puste dla budowy winylowej figurki. Obecne dla kompatybilności między punktami końcowymi.

  • Name
    model_urls
    Type
    object
    Description

    Pobieralne URL-e dla wygenerowanego modelu 3D. Budowanie winylowej figurki emituje teksturowany GLB plus parę OBJ + MTL dla pipeline'ów preferujących Wavefront OBJ. Kształt pola pasuje do obiektu Obraz na 3D model_urls, więc przyszłe formaty można dodać bez łamania zmian.

    • Name
      glb
      Type
      string
      Description

      Pobieralny URL do teksturowanego pliku GLB.

    • Name
      obj
      Type
      string
      Description

      Pobieralny URL do pliku Wavefront OBJ (geometria + UV).

    • Name
      mtl
      Type
      string
      Description

      Pobieralny URL do pliku materiału MTL towarzyszącego OBJ. Sparuj z obj i wpisem z texture_urls[0].base_color.

  • Name
    thumbnail_url
    Type
    string
    Description

    Pobieralny URL do miniatury obrazu pliku modelu.

  • Name
    texture_urls
    Type
    array
    Description

    Tablica obiektów URL tekstur wygenerowana przez to zadanie. Obecnie zawiera jeden obiekt z mapą kolorów podstawowych.

    • Name
      base_color
      Type
      string
      Description

      Pobieralny URL do obrazu z mapą kolorów podstawowych.

Example Vinyl Figure Build Task Object

{
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "type": "creative-lab-vinyl-figure-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969700000,
  "started_at": 1752969710000,
  "finished_at": 1752969735000,
  "expires_at": 1753228935000,
  "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/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/texture_0.png?Expires=***"
    }
  ]
}