Creative Lab — Figure API

Zet een bronfoto in twee fasen om in een verzamelbare 3D-figuur in chibi-stijl: prototype genereert een gestileerde conceptafbeelding op basis van uw invoerfoto, en vervolgens build zet die conceptafbeelding om in een 3D-model met texture. De twee fasen zijn met elkaar verbonden via input_task_id.

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

Create a Figure Prototype Task

Genereer een enkele chibi-stijl conceptafbeelding op basis van de brongfoto. De geretourneerde task-ID is wat je doorgeeft als input_task_id aan de build- endpoint. Raadpleeg The Figure Prototype Task Object voor de vorm van de response.

Parameters

  • Name
    image_url
    Type
    string
    Verplicht
    Description

    Brongfoto die Meshy stileert als een chibi-figuur. We ondersteunen momenteel de formaten .jpg, .jpeg, .png en .webp.

    Er zijn twee manieren om de afbeelding aan te leveren:

    • Publiek toegankelijke URL: Een URL die toegankelijk is vanaf het publieke internet.
    • Data URI: Een base64-gecodeerde data-URI van de afbeelding. Voorbeeld van een data-URI: data:image/jpeg;base64,<your base64-encoded image data>.
  • Name
    name
    Type
    string
    Description

    Optionele tasknaam voor weergavedoeleinden. Maximaal 100 tekens.

  • Name
    remove_background
    Type
    boolean
    standaard false
    Description

    Wanneer ingesteld op true, wordt de prototypeafbeelding geretourneerd als een transparante RGBA-PNG met de achtergrond verwijderd, zodat je het onderwerp op elke achtergrond kunt samenstellen.

Returns

De result-property van de response bevat de task-id van de nieuw aangemaakte figure-prototype-task. Poll de Get a Task-endpoint of abonneer je op de stream totdat de task de status SUCCEEDED bereikt, en geef die ID vervolgens door aan de build-endpoint als input_task_id.

Failure Modes

  • Name
    400 - Bad Request
    Description

    Het verzoek was onacceptabel. Veelvoorkomende oorzaken:

    • Ontbrekende parameter: image_url is verplicht.
    • Ongeldig afbeeldingsformaat: De opgegeven image_url heeft geen ondersteund formaat (.jpg, .jpeg, .png, .webp).
    • Afbeeldingsafmetingen buiten bereik: De afbeelding is te klein, overschrijdt de maximale bestandsgrootte, of overschrijdt het maximale aantal pixels.
    • Onbereikbare URL: De image_url kon niet worden gedownload (404 of timeout).
    • Ongeldige Data URI: De base64-string is onjuist opgemaakt.
    • Content gemarkeerd: De invoerafbeelding werd gemarkeerd door NSFW- of intellectuele-eigendoms-moderation.
  • Name
    401 - Unauthorized
    Description

    Authenticatie is mislukt. Controleer je API-sleutel.

  • Name
    402 - Payment Required
    Description

    Onvoldoende credits om deze task uit te voeren.

  • Name
    429 - Too Many Requests
    Description

    Je hebt je rate limit overschreden.

Request

POST
/openapi/creative-lab/figure/v1/prototype
# Stage 1: generate a chibi-style concept image
curl https://api.meshy.ai/openapi/creative-lab/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"
}
Prototype-voorbeeld
Begin met een bronportret en genereer vervolgens de prototypeafbeelding die door de build-fase wordt gebruikt.
Bronportret gebruikt als invoer voor Creative Lab Figure
Prototype-invoer
Chibi-stijl figuurprototype gegenereerd op basis van de brongfoto
Prototype-uitvoer
POST/openapi/creative-lab/figure/v1/build

Een Figure Build-taak aanmaken

Genereer het uiteindelijke getextureerde 3D-figuur uit een geslaagde prototype-taak. De build voert dezelfde image-to-3D-pipeline uit als Afbeelding naar 3D, dus het formaat van het responsobject en de lijst met output-URL's komen exact overeen. Raadpleeg Het Figure Build Task-object voor de vorm van de response.

Parameters

  • Name
    input_task_id
    Type
    string
    Verplicht
    Description

    De task-ID van een prototype-taak die via dezelfde OpenAPI-endpoint is aangemaakt. Het prototype moet zijn aangemaakt met dezelfde API-sleutel, moet de status SUCCEEDED hebben bereikt en moet precies één kandidaatafbeelding hebben geproduceerd.

    Prototype-taken die via de webapp zijn aangemaakt worden niet geaccepteerd — de build-endpoint accepteert alleen prototype-taken die zijn geproduceerd door POST /openapi/creative-lab/figure/v1/prototype en weigert elke andere bron met 404.

  • Name
    name
    Type
    string
    Description

    Optionele taaknaam voor weergavedoeleinden. Maximaal 100 tekens.

Returns

De result-eigenschap van de response bevat de task-id van de nieuw aangemaakte figure build-taak. Poll de Get a Task-endpoint of abonneer je op de stream totdat de taak de status SUCCEEDED bereikt, en download vervolgens de getextureerde GLB van model_urls.glb (of het OBJ + MTL-paar van model_urls.obj en model_urls.mtl als je downstream-pipeline de voorkeur geeft aan OBJ).

Foutmodi

  • Name
    400 - Bad Request
    Description

    Het verzoek was onacceptabel. Veelvoorkomende oorzaken:

    • Ontbrekende parameter: input_task_id is verplicht.
    • Ongeldige UUID: De input_task_id is geen geldige UUID.
    • Bovenliggende taak niet geslaagd: De aangehaalde prototype-taak heeft nog niet de status SUCCEEDED bereikt.
    • Geen kandidaat: De prototype-taak is geslaagd maar heeft geen kandidaatafbeelding geproduceerd.
  • Name
    401 - Unauthorized
    Description

    Authenticatie is mislukt. Controleer je API-sleutel.

  • Name
    402 - Payment Required
    Description

    Onvoldoende credits om deze taak uit te voeren.

  • Name
    404 - Not Found
    Description

    De aangehaalde prototype-taak bestaat niet, behoort toe aan een andere gebruiker, of is aangemaakt via de webapp (alleen prototype-taken in API-mode kunnen doorschakelen naar build).

  • Name
    429 - Too Many Requests
    Description

    Je hebt je rate limit overschreden.

Request

POST
/openapi/creative-lab/figure/v1/build
# Stage 2: chain build off a succeeded prototype task
curl https://api.meshy.ai/openapi/creative-lab/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"
}
Build-voorbeeld
De build-taak zet de geselecteerde prototype-afbeelding om in een downloadbaar getextureerd 3D-model.
Voorbeeld van Creative Lab Figure build-model
Voorbeeld van build-model
GET/openapi/creative-lab/figure/v1/(prototype|build)/:id

Retrieve a Figure Task

Haal een prototype- of buildtaak op aan de hand van een geldige taak-id. Het URL-pad moet overeenkomen met de fase van de taak — een buildtaak die wordt opgehaald via /prototype/:id geeft 404 terug, en omgekeerd.

Raadpleeg Het Figure Prototype Task-object en Het Figure Build Task-object voor de vormen van de respons.

Parameters

  • Name
    id
    Type
    path
    Description

    Unieke identificatie van de figure-taak die moet worden opgehaald.

Retourwaarden

De respons bevat het figure-taakobject. De vorm hangt af van welke fase is opgevraagd.

Request

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

# Build
curl https://api.meshy.ai/openapi/creative-lab/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-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-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": 20,
  "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/figure/v1/(prototype|build)/:id

Verwijder een Figure-taak

Annuleer een figure-taak. Als de taak nog PENDING is, worden de bij het aanmaken verbruikte credits terugbetaald. Taken die al IN_PROGRESS zijn, worden geannuleerd zonder terugbetaling (de worker verbruikt mogelijk al bronnen). Taken die al een eindstatus hebben bereikt (SUCCEEDED, FAILED, CANCELED) kunnen niet worden geannuleerd.

Het URL-pad moet overeenkomen met de fase van de taak — DELETE op /prototype/:buildId geeft 404 terug.

Padparameters

  • Name
    id
    Type
    path
    Description

    Unieke identificatie van de te annuleren figure-taak.

Retourneert

Retourneert 204 No Content bij succes met een lege body.

Storingsmodi

  • Name
    400 - Bad Request
    Description

    De taak bevindt zich al in een eindstatus en kan niet worden geannuleerd.

  • Name
    404 - Not Found
    Description

    De taak bestaat niet, behoort toe aan een andere gebruiker, of de fase ervan komt niet overeen met het URL-pad.

Request

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

Response

// Returns 204 No Content on success (empty body).
GET/openapi/creative-lab/figure/v1/(prototype|build)/:id/stream

Stream een figuurtaak

Stream realtime updates voor een figuurtaak via Server-Sent Events (SSE). Het URL-pad moet overeenkomen met de fase van de taak — het openen van een stream op /prototype/:buildId/stream levert één event: error-payload met status_code: 404 en sluit de stream.

Parameters

  • Name
    id
    Type
    path
    Description

    Unieke identifier voor de te streamen figuurtaak.

Retourneert

Retourneert een stream van Figure Prototype of Figure Build taakobjecten als Server-Sent Events. Elk frame draagt het volledige taakobject voor de fase — dezelfde vorm die het Get-endpoint retourneert — dus zolang de taak PENDING of IN_PROGRESS is, zijn de uitvoervelden simpelweg nog niet ingevuld (null, [] of {}) en is finished_at gelijk aan null.

Request

GET
/openapi/creative-lab/figure/v1/build/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/stream
curl -N https://api.meshy.ai/openapi/creative-lab/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 PENDING frame below is abbreviated 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-figure-build",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123500000,
  "started_at": 1729123510000,
  "finished_at": 1729123535000,
  "expires_at": 1729382735000,
  "task_error": null,
  "consumed_credits": 20,
  "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/figure/v1/(prototype|build)

List Figure Tasks

Haal een gepagineerde lijst op van uw figuurtaken voor één fase. Het URL-pad bepaalt de fase — /prototype retourneert prototypetaken; /build retourneert buildtaken. Taken uit de andere fase worden niet opgenomen in beide responses.

Padparameters

  • Name
    stage
    Type
    path
    Verplicht
    Description

    Ofwel prototype ofwel build. De collectie retourneert alleen taken waarvan de fase overeenkomt met de URL — het opvragen van /prototype retourneert nooit buildtaken en omgekeerd.

Queryparameters

  • Name
    page_num
    Type
    integer
    standaard 1
    Description

    Paginanummer voor paginering.

  • Name
    page_size
    Type
    integer
    standaard 10
    Description

    Paginagrootte-limiet. Maximaal toegestaan is 100 items.

  • Name
    sort_by
    Type
    string
    standaard -created_at
    Description

    Veld om op te sorteren. Beschikbare waarden:

    • +created_at: Sorteer op aanmaaktijd in oplopende volgorde.
    • -created_at: Sorteer op aanmaaktijd in aflopende volgorde.

Retourwaarden

Retourneert een gepagineerde lijst van het taakobject per fase — ofwel het figuur-prototypetaakobject bij het weergeven van /prototype, of het figuur-buildtaakobject bij het weergeven van /build.

Request

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

# List build tasks
curl https://api.meshy.ai/openapi/creative-lab/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-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=***"
    ]
  }
]

The Figure Prototype Task Object

Het Figure Prototype Task object is een werkeenheid die Meshy bijhoudt om een chibi-stijl conceptafbeelding te genereren op basis van een bronfoto. De output van deze fase wordt gekoppeld aan de build-fase via input_task_id.

Eigenschappen

  • Name
    id
    Type
    string
    Description

    Unieke identifier voor de taak. Hoewel we als implementatiedetail een k-sortable UUID gebruiken voor taak-id's, mag je geen aannames doen over het formaat van de id.

  • Name
    type
    Type
    string
    Description

    Type van de taak. De waarde is creative-lab-figure-prototype.

  • Name
    name
    Type
    string
    Description

    De taaknaam die is opgegeven bij het aanmaken van de taak. Lege string als er geen naam is opgegeven.

  • Name
    status
    Type
    string
    Description

    Status van de taak. Mogelijke waarden zijn een van PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

  • Name
    progress
    Type
    integer
    Description

    progress van de taak. Als de taak nog niet is gestart, is deze eigenschap 0. Zodra de taak is geslaagd, wordt dit 100.

  • Name
    created_at
    Type
    timestamp
    Description

    tijdstempel van wanneer de taak is aangemaakt, in milliseconden.

    Een tijdstempel geeft het aantal milliseconden weer dat is verstreken sinds 1 januari 1970 UTC, volgens de RFC 3339-standaard. Bijvoorbeeld, vrijdag 1 september 2023 12:00:00 PM GMT wordt weergegeven als 1693569600000. Dit geldt voor alle tijdstempels in de Meshy API.

  • Name
    started_at
    Type
    timestamp
    Description

    tijdstempel van wanneer de taak is gestart, in milliseconden. Als de taak nog niet is gestart, is deze eigenschap 0.

  • Name
    finished_at
    Type
    timestamp
    Description

    tijdstempel van wanneer de taak is voltooid, in milliseconden. Als de taak nog niet is voltooid, is deze eigenschap 0.

  • Name
    expires_at
    Type
    timestamp
    Description

    tijdstempel van wanneer het taakresultaat verloopt, in milliseconden.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Het aantal voorafgaande taken.

    De waarde van dit veld is alleen betekenisvol als de taakstatus PENDING is.

  • Name
    task_error
    Type
    object
    Description

    Foutdetails voor mislukte taken. Zie Fouten voor de volledige referentie van het task_error-object.

  • Name
    consumed_credits
    Type
    integer
    Description

    Het aantal credits dat door deze taak is verbruikt. Aanwezig wanneer de taakstatus PENDING, IN_PROGRESS of SUCCEEDED is. Geeft 0 terug voor FAILED-taken (credits worden bij mislukking terugbetaald).

  • Name
    image_urls
    Type
    array of strings
    Description

    Downloadbare URL's voor de conceptafbeeldingkandidaten die door deze prototypetaak zijn gegenereerd. Momenteel retourneert de API altijd precies één kandidaat; het veld is een array zodat toekomstige revisies meerdere kandidaten kunnen tonen zonder een breaking change.

Example Figure Prototype Task Object

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "creative-lab-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=***"
  ]
}

Het Figure Build Task-object

Het Figure Build Task-object is een werkeenheid die Meshy bijhoudt om een getextureerde 3D-figuur te genereren op basis van een geslaagde prototype-taak. Het draait dezelfde image-to-3D-pipeline die wordt gebruikt door Afbeelding naar 3D, dus de outputvelden komen overeen met het task-object van die endpoint.

Eigenschappen

  • Name
    id
    Type
    string
    Description

    Unieke identificatie voor de taak.

  • Name
    type
    Type
    string
    Description

    Type van de taak. De waarde is creative-lab-figure-build.

  • Name
    name
    Type
    string
    Description

    De taaknaam die is opgegeven bij het aanmaken van de taak. Lege string als er geen naam is opgegeven.

  • Name
    status
    Type
    string
    Description

    Status van de taak. Mogelijke waarden zijn PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

  • Name
    progress
    Type
    integer
    Description

    Voortgang van de taak. Als de taak nog niet is gestart, is deze eigenschap 0. Zodra de taak is geslaagd, wordt dit 100.

  • Name
    created_at
    Type
    timestamp
    Description

    Tijdstempel van wanneer de taak is aangemaakt, in milliseconden.

  • Name
    started_at
    Type
    timestamp
    Description

    Tijdstempel van wanneer de taak is gestart, in milliseconden.

  • Name
    finished_at
    Type
    timestamp
    Description

    Tijdstempel van wanneer de taak is voltooid, in milliseconden.

  • Name
    expires_at
    Type
    timestamp
    Description

    Tijdstempel van wanneer het taakresultaat verloopt, in milliseconden.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Het aantal voorafgaande taken. Alleen relevant wanneer de status PENDING is.

  • Name
    task_error
    Type
    object
    Description

    Foutdetails voor mislukte taken. Zie Fouten voor de volledige referentie van het task_error-object.

  • Name
    consumed_credits
    Type
    integer
    Description

    Het aantal credits dat door deze taak is verbruikt. Geeft 0 terug voor FAILED-taken (credits worden terugbetaald bij een mislukking).

  • Name
    prompt
    Type
    string
    Description

    Altijd leeg voor figure build. Aanwezig voor cross-endpoint compatibiliteit met de gedeelde V2ImageTo3DTaskResponse-vorm die wordt gebruikt door Afbeelding naar 3D.

  • Name
    negative_prompt
    Type
    string
    Description

    Altijd leeg voor figure build. Aanwezig voor cross-endpoint compatibiliteit.

  • Name
    texture_prompt
    Type
    string
    Description

    Altijd leeg voor figure build. Aanwezig voor cross-endpoint compatibiliteit.

  • Name
    texture_image_url
    Type
    string
    Description

    Altijd leeg voor figure build. Aanwezig voor cross-endpoint compatibiliteit.

  • Name
    model_urls
    Type
    object
    Description

    Downloadbare URL's voor het gegenereerde 3D-model. De figure build levert een getextureerde GLB plus het OBJ + MTL-paar voor pipelines die de voorkeur geven aan Wavefront OBJ. De vorm van dit veld komt overeen met het Image to 3D model_urls-object, zodat toekomstige formaattoevoegingen zonder breaking change kunnen worden ingepast.

    • Name
      glb
      Type
      string
      Description

      Downloadbare URL naar het getextureerde GLB-bestand.

    • Name
      obj
      Type
      string
      Description

      Downloadbare URL naar het Wavefront OBJ-bestand (geometrie + UV).

    • Name
      mtl
      Type
      string
      Description

      Downloadbare URL naar het bijbehorende OBJ MTL-materiaalbestand. Combineer met obj en het item uit texture_urls[0].base_color.

  • Name
    thumbnail_url
    Type
    string
    Description

    Downloadbare URL naar de thumbnail-afbeelding van het modelbestand.

  • Name
    texture_urls
    Type
    array
    Description

    Een array van door deze taak gegenereerde textuur-URL-objecten. Bevat momenteel een enkel object met de basiskleurenmap.

    • Name
      base_color
      Type
      string
      Description

      Downloadbare URL naar de afbeelding van de basiskleurenmap.

Example Figure Build Task Object

{
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "type": "creative-lab-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": 20,
  "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=***"
    }
  ]
}