Creative Lab Brickfigur-API

Omvandla ett foto till en samlarfigur i tegelstensstil – en 3D-minifigur – i två steg. En prototypuppgift genererar en konceptbild utifrån fotot. En bygguppgift omvandlar den bilden till en texturerad 3D-modell och använder prototypuppgiftens ID som input_task_id.

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

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

Skapa en Brick Figure-prototyptask

Genererar en konceptbild i tegelstensstil från ett foto. För att bygga 3D-modellen skickar du den här taskens ID till build-endpointen som input_task_id. För taskens fält, se Brick Figure-prototyptaskobjektet.

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

Parametrar

Name
image_url
Type
string
Obligatorisk
Description
Fotot som ska omvandlas till en LEGO-minifigur, som en offentlig URL eller en data-URI (data:image/jpeg;base64,<dina base64-kodade bilddata>).
Bilden måste vara en JPG-, JPEG-, PNG- eller WebP-fil på högst 20 MB.
Name
name
Type
string
Description
Ett namn för tasken, på upp till 100 tecken. Det returneras i taskens fält name. Ett längre namn returnerar 400.
Name
remove_background
Type
boolean
standard false
Description
Huruvida bakgrunden ska tas bort från prototypbilden. true returnerar en transparent RGBA PNG, så att du kan placera motivet på valfri bakgrund. Bygget utgår också från bilden utan dess bakgrund. Om Meshy inte kan ta bort bakgrunden returneras bilden med sin bakgrund, och tasken lyckas ändå.

Returer

Fältet result innehåller ID:t för den nya prototyptasken. Hämta tasken eller strömma den tills status är SUCCEEDED. Skicka sedan ID:t till build-endpointen som input_task_id.

Felscenarier

Name
400 - Bad Request
Description
Begäran kan inte köras. Till exempel:
- image_url saknas.
- Bilden är inte en JPG-, JPEG-, PNG- eller WebP-fil.
- Bilden är för liten, över 20 MB, eller över det maximala antalet pixlar.
- Meshy kan inte ladda ner bilden, till exempel för att URL:en returnerar 404 eller tidsgränsen överskrids.
- Data-URI:n är inte giltig base64.
- Bilden flaggades som NSFW.
Felmeddelandet anger vilket problem som hittades. Åtgärda begäran och skicka den sedan igen.
Name
401 - Unauthorized
Description
API-nyckeln saknas eller är ogiltig. Kontrollera Authorization-huvudet.
Name
402 - Payment Required
Description
Något av följande gäller:
- Kontot har inte tillräckligt med credits.
- API-nyckeln, arbetsytan eller medlemmen nådde sin creditgräns.
- Kontot använder den kostnadsfria planen.
Kontrollera dina credits och din plan, och försök sedan igen.
Name
403 - Forbidden
Description
Ditt team har IP Filtering aktiverat, och Meshy flaggade bilden för tredjeparts immateriella rättigheter. Skicka en bild som du har rättigheterna att använda.
Name
429 - Too Many Requests
Description
En av dessa gränser nåddes:
- Du skickade fler begäranden än vad din hastighetsgräns tillåter. Vänta några sekunder och försök sedan igen. Se Hastighetsgränser.
- För många av dina tasks köas eller körs. Vänta tills några är klara och försök sedan igen.
- På en obegränsad plan utan kvarvarande credits nådde du antalet tasks som kan köras utan credits. Vänta tills en task är klar, eller lägg till credits.
Name
500 - Internal Server Error
Description
Meshy stötte på ett serverfel, till exempel för att det inte kunde köra kontrollen av immateriella rättigheter på bilden. Meshy skapar inte tasken, och återbetalar eventuella credits som debiterats. Försök igen med begäran.

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

Skapa en Brick Figure-byggtask

Genererar den texturerade 3D-minifiguren från en lyckad prototyptask. För dess fält, se Brick Figure-byggtaskobjektet.

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

Parametrar

Name
input_task_id
Type
string
Obligatorisk
Description
ID:t för prototyptasken som ska byggas. Den måste vara en task som ditt konto skapat med POST /openapi/creative-lab/brick-figure/v1/prototype, med statusen SUCCEEDED.
Ett ID som inte är en av dina Brick Figure-prototyptasker från API:et returnerar 404, inklusive en prototyp som skapats i webbappen.
Name
name
Type
string
Description
Ett namn för tasken, upp till 100 tecken. Det kommer tillbaka i taskens name-fält. Ett längre namn returnerar 400.

Returnerar

Fältet result innehåller ID:t för den nya byggtasken. Hämta tasken eller strömma den tills status är SUCCEEDED. Ladda sedan ner den texturerade GLB-filen från model_urls.glb. För en OBJ istället, ladda ner model_urls.obj med dess materialfil från model_urls.mtl.

Felscenarier

Name
400 - Bad Request
Description
Förfrågan kan inte köras. Till exempel:
- input_task_id saknas eller är inte ett giltigt task-ID.
- Prototyptaskens status är inte SUCCEEDED. Om den fortfarande körs, vänta och försök igen. Om den misslyckades eller avbröts, skapa en ny prototyptask.
- Prototyptasken lyckades men har ingen bild. Skapa en ny prototyptask.
Felmeddelandet anger vilket problem det hittade.
Name
401 - Unauthorized
Description
API-nyckeln saknas eller är ogiltig. Kontrollera Authorization-headern.
Name
402 - Payment Required
Description
Något av följande gäller:
- Kontot har inte tillräckligt med credits.
- API-nyckeln, arbetsytan eller medlemmen nådde sin creditgräns.
- Kontot använder gratisplanen.
Kontrollera dina credits och din plan, försök sedan igen.
Name
404 - Not Found
Description
input_task_id matchar ingen Brick Figure-prototyptask som ditt konto skapat med API:et. En prototyp som skapats i webbappen returnerar också 404. Skicka result-ID:t från ett svar vid skapande av prototyp.
Name
429 - Too Many Requests
Description
En av dessa gränser nåddes:
- Du skickade fler förfrågningar än din hastighetsgräns tillåter. Vänta några sekunder och försök sedan igen. Se Hastighetsgränser.
- För många av dina tasker köas eller körs. Vänta tills några är klara, försök sedan igen.
- På en obegränsad plan utan kvarvarande credits nådde du antalet tasker som kan köras utan credits. Vänta tills en task är klar, eller lägg till credits.

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

Hämta en Brick Figure-uppgift

Returnerar en prototyp- eller bygguppgift. Sökvägen måste matcha uppgiftens steg. En bygguppgift som begärs via /prototype/:id returnerar 404, och likaså returnerar en prototypuppgift som begärs via /build/:id 404.

För fälten, se The Brick Figure prototype task object och The Brick Figure build task object.

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

Parametrar

Name
id
Type
path
Description
Uppgifts-ID:t från skapande-svaret.

Returnerar

Prototypuppgiftsobjektet eller byggningsuppgiftsobjektet, beroende på vilket steg som anges i sökvägen.

Felscenarier

Name
400 - Bad Request
Description
id är inte ett giltigt uppgifts-ID. Skicka result-ID:t från skapande-svaret.
Name
403 - Forbidden
Description
Ditt team har IP Filtering aktiverat, och Meshy har flaggat uppgiftens bild för tredjeparts immateriella rättigheter. Team med Enterprise-plan får inte detta fel. Skapa en prototypuppgift från en bild som du har rättigheter att använda.
Name
404 - Not Found
Description
Ingen Brick Figure-uppgift med detta ID tillhör ditt konto, eller så matchar inte uppgiftens steg sökvägen. Kontrollera ID:t, och använd /prototype eller /build för att matcha uppgiften.
Name
500 - Internal Server Error
Description
Meshy kunde inte köra kontrollen av immateriella rättigheter. Försök igen med förfrågan.

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

Ta bort en Brick Figure-uppgift

Avbryter en Brick Figure-uppgift. Att avbryta en PENDING-uppgift återbetalar dess credits. En IN_PROGRESS-uppgift avbryts utan återbetalning, eftersom en worker redan har påbörjat den. En uppgift med en slutgiltig status (SUCCEEDED, FAILED eller CANCELED) kan inte avbrytas.

Sökvägen måste matcha uppgiftens steg. Till exempel returnerar DELETE på /prototype/:id med ett build-uppgifts-ID 404.

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).

Sökvägsparametrar

Name
id
Type
path
Description
ID:t för uppgiften som ska avbrytas.

Returnerar

204 No Content med en tom brödtext.

Felscenarier

Name
400 - Bad Request
Description
Något av följande gäller:
- id är inte ett giltigt uppgifts-ID. Skicka result-ID:t från skapande-svaret.
- Uppgiften har redan en slutgiltig status (SUCCEEDED, FAILED eller CANCELED), så den kan inte avbrytas.
Name
404 - Not Found
Description
Ingen Brick Figure-uppgift med detta ID tillhör ditt konto, eller så matchar uppgiftens steg inte sökvägen. Kontrollera ID:t och använd /prototype eller /build för att matcha uppgiften.

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

Strömma en Brick Figure-uppgift

Strömmar uppdateringar för en Brick Figure-uppgift som Server-Sent Events (SSE). Sökvägen måste matcha uppgiftens stadie. Om den inte gör det, till exempel om en build-uppgifts ID anges vid /prototype/:id/stream, skickar strömmen ett error-event med status_code: 404 och stängs.

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

Parametrar

Name
id
Type
path
Description
Uppgifts-ID:t från skapandesvaret.

Returnerar

En ström av prototype- eller build-uppgiftsobjekt. Varje event innehåller hela uppgiftsobjektet, så som Hämta en Brick Figure-uppgift returnerar det. Medan uppgiften är PENDING eller IN_PROGRESS är dess utdatafält fortfarande tomma (null, [] eller {}), och finished_at är null.

Om IP-filtrering blockerar uppgiftens resultat skickar strömmen ett error-event i dess ställe, med den status_code som en get-förfrågan skulle returnera.

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

Lista figur-uppgifter för Brick Figure

Returnerar dina Brick Figure-uppgifter för ett stadium, en sida åt gången. Sökvägen väljer stadiet. /prototype returnerar endast prototypuppgifter, och /build returnerar endast bygguppgifter.

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

Sökvägsparametrar

Name
stage
Type
path
Obligatorisk
Description
Stadiet som ska listas, prototype eller build.

Frågeparametrar

Name
page_num
Type
integer
standard 1
Description
Sidan som ska returneras, från 1 till 255. 0 returnerar den första sidan. Ett värde utanför 0 till 255 returnerar 400.
Name
page_size
Type
integer
standard 10
Description
Antal uppgifter per sida, upp till 100. Ett värde från 101 till 255 returnerar 100 uppgifter, och 0 använder standardvärdet. Ett värde utanför 0 till 255 returnerar 400.
Name
sort_by
Type
string
standard -created_at
Description
Sorteringsordningen.
Tillgängliga värden:
- -created_at: nyaste först
- +created_at: äldsta först

Returnerar

En array med prototyp-uppgiftsobjekt eller bygg-uppgiftsobjekt, beroende på stadiet i sökvägen.

The Brick Figure prototype-tasksobjekt

Ett prototype-uppgift genererar en konceptbild i tegelstensstil från ett foto. För att omvandla bilden till en 3D-modell skickar du uppgiftens ID till build-endpointen som input_task_id.

Egenskaper

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
Uppgiftens ID. Förlita dig inte på dess format.
Name
type
Type
string
Description
Uppgiftstypen, alltid creative-lab-brick-figure-prototype.
Name
name
Type
string
Description
Det name du skickade när du skapade uppgiften, eller "" om du inte skickade något.
Name
status
Type
string
Description
Uppgiftens status.
Tillgängliga värden:
- PENDING: väntar i kön
- IN_PROGRESS: genererar resultatet
- SUCCEEDED: slutgiltig, med resultatet
- FAILED: slutgiltig, med orsaken i task_error
- CANCELED: slutgiltig, utan resultat
Name
progress
Type
integer
Description
Procentandel av arbetet som är klart, från 0 till 100. Den är 0 tills uppgiften startar och 100 när den lyckas.
Name
created_at
Type
timestamp
Description
Tidpunkt då uppgiften skapades, i Unix-millisekunder.
Name
started_at
Type
timestamp
Description
Tidpunkt då en arbetare startade uppgiften, i Unix-millisekunder. null fram till dess.
Name
finished_at
Type
timestamp
Description
Tidpunkt då uppgiften nådde en slutgiltig status, i Unix-millisekunder. null fram till dess.
Name
expires_at
Type
timestamp
Description
Tidpunkt då uppgiftens resultat upphör att gälla, i Unix-millisekunder. Det är 3 dagar efter finished_at, eller 3 dagar efter created_at tills uppgiften är klar. För Enterprise-konton, som behåller API-resultat på obestämd tid, är det ungefär 100 år senare. Se Tillgångslagring.
Name
preceding_tasks
Type
integer
Description
Uppgiftens position i kön medan den är PENDING. 1 betyder att den startar härnäst. 0 efter att uppgiften lämnat kön, och alltid 0 i listresultat.
Name
task_error
Type
object
Description
Varför uppgiften misslyckades. null om inte status är FAILED. Se Fel.
Name
consumed_credits
Type
integer
Description
Antal credits som debiterats för uppgiften, efter eventuell återbetalning. En förfrågan som returnerar ett fel debiteras inte. En misslyckad uppgift är 0, eftersom Meshy återbetalar den. Att avbryta en uppgift återbetalar den endast medan den är PENDING. Om Meshy inte kan läsa debiteringen utelämnas fältet i ett get- eller stream-svar, och en listförfrågan returnerar 500. Försök i så fall igen med förfrågan.
Name
image_urls
Type
array of strings
Description
Nedladdnings-URL:er för konceptbilden. Arrayen har en URL efter att uppgiften lyckats, och är tom fram till dess.

Build task-objektet för Brick Figure

En build-uppgift genererar en texturerad 3D-minifigur från en lyckad prototyp-uppgift. Dess fält model_urls, thumbnail_url och texture_urls har samma format som i Bild till 3D-uppgiftsobjektet.

Egenskaper

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
Uppgifts-ID:t. Förlita dig inte på dess format.
Name
type
Type
string
Description
Uppgiftstypen, alltid creative-lab-brick-figure-build.
Name
name
Type
string
Description
Det name du skickade när du skapade uppgiften, eller "" om du inte skickade något.
Name
status
Type
string
Description
Uppgiftens status.
Tillgängliga värden:
- PENDING: väntar i kön
- IN_PROGRESS: genererar resultatet
- SUCCEEDED: slutgiltig, med resultatet
- FAILED: slutgiltig, med anledningen i task_error
- CANCELED: slutgiltig, utan resultat
Name
progress
Type
integer
Description
Procentandel av arbetet som är klart, från 0 till 100. Den är 0 tills uppgiften startar och 100 när den lyckas.
Name
created_at
Type
timestamp
Description
Tiden då uppgiften skapades, i Unix-millisekunder.
Name
started_at
Type
timestamp
Description
Tiden då en arbetare startade uppgiften, i Unix-millisekunder. null fram till dess.
Name
finished_at
Type
timestamp
Description
Tiden då uppgiften nådde en slutgiltig status, i Unix-millisekunder. null fram till dess.
Name
expires_at
Type
timestamp
Description
Tiden då uppgiftens resultat löper ut, i Unix-millisekunder. Det är 3 dagar efter finished_at, eller 3 dagar efter created_at tills uppgiften är klar. För Enterprise-konton, som behåller API-resultat på obestämd tid, är det ungefär 100 år senare. Se Tillgångslagring.
Name
preceding_tasks
Type
integer
Description
Uppgiftens position i kön medan den är PENDING. 1 betyder att den startar härnäst. 0 efter att uppgiften lämnat kön, och alltid 0 i listresultat.
Name
task_error
Type
object
Description
Varför uppgiften misslyckades. null om inte status är FAILED. Se Fel.
Name
consumed_credits
Type
integer
Description
Antal credits som debiterades för uppgiften, efter eventuell återbetalning. En förfrågan som returnerar ett fel debiteras inte. En misslyckad uppgift är 0, eftersom Meshy återbetalar den. Avbrytning återbetalar en uppgift endast medan den är PENDING. Om Meshy inte kan läsa debiteringen utelämnas fältet i ett get- eller stream-svar, och en listförfrågan returnerar 500. Försök i så fall igen med förfrågan.
Name
prompt
Type
string
Description
Alltid "" för en Brick Figure build-uppgift.
Name
negative_prompt
Type
string
Description
Alltid "" för en Brick Figure build-uppgift, precis som prompt.
Name
texture_prompt
Type
string
Description
Alltid "" för en Brick Figure build-uppgift, precis som prompt.
Name
texture_image_url
Type
string
Description
Alltid "" för en Brick Figure build-uppgift, precis som prompt.
Name
model_urls
Type
object
Description
Nedladdnings-URL:er för 3D-modellen, som en texturerad GLB och som en OBJ-fil med dess MTL-fil.
- Name
  glb
  Type
  string
  Description
  Nedladdnings-URL för den texturerade GLB-filen.
- Name
  obj
  Type
  string
  Description
  Nedladdnings-URL för OBJ-filen, med geometrin och UV:erna.
- Name
  mtl
  Type
  string
  Description
  Nedladdnings-URL för MTL-materialfilen som hör ihop med obj. Använd den tillsammans med obj och texturen i texture_urls[0].base_color.
Name
thumbnail_url
Type
string
Description
Nedladdnings-URL för en förhandsvisningsbild av modellen.
Name
texture_urls
Type
array
Description
Texturkartorna, som en array med ett objekt som innehåller basfärgskartan.
- Name
  base_color
  Type
  string
  Description
  Nedladdnings-URL för basfärgskartan.