Creative Lab Vinylfigur-API
Omvandla ett foto till en vinylsamlarfigur med stort huvud i 3D i två steg. En prototypuppgift genererar en konceptbild utifrån fotot. En byggnadsuppgift omvandlar den bilden till en texturerad 3D-modell och använder prototypuppgiftens ID som input_task_id.
POST /openapi/creative-lab/vinyl-figure/v1/prototypePOST /openapi/creative-lab/vinyl-figure/v1/build
Skapa en prototyp-task för Vinyl Figure
Genererar en konceptbild i vinyl-figure-stil från ett foto. För att bygga 3D-modellen skickar du denna tasks ID till build-endpoint som input_task_id. För taskens fält, se The Vinyl Figure prototype task object.
Request
# Stage 1: generate a vinyl-figure-style concept image
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"
}
Parametrar
- Name
- image_url
- Type
- string
- Obligatorisk
- Description
Fotot som ska omvandlas till en stor-huvad vinyl-figur, 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, upp till 100 tecken. Det returneras i taskens
name-fält. Ett längre namn returnerar400.
- Name
- remove_background
- Type
- boolean
- standard false
- Description
Om bakgrunden ska tas bort från prototypbilden.
truereturnerar en transparent RGBA-PNG, så att du kan placera motivet på valfri bakgrund. Bygget startar också från bilden utan dess bakgrund. Om Meshy inte kan ta bort bakgrunden returneras bilden med sin bakgrund, och tasken lyckas ändå.
Returvärden
Fältet result innehåller ID:t för den nya prototyp-tasken. Hämta tasken eller strömma den tills status är SUCCEEDED. Skicka sedan ID:t till build-endpoint som input_task_id.
Felscenarier
- Name
400 - Bad Request- Description
Begäran kan inte köras. Till exempel:
image_urlsaknas.- 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 ned bilden, till exempel för att URL:en returnerar
404eller tidsgränsen överskrids. - Data-URI:n är inte giltig base64.
- Bilden flaggades som NSFW.
Felmeddelandet anger vilket problem det hittade. Åtgärda begäran och skicka den igen.
- Name
401 - Unauthorized- Description
API-nyckeln saknas eller är ogiltig. Kontrollera
Authorization-huvudet.
- Name
402 - Payment Required- Description
Ett av följande gäller:
- Kontot har inte tillräckligt med credits.
- API-nyckeln, arbetsytan eller medlemmen nådde sin creditgräns.
- Kontot är på 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 du har rättighet att använda.
- Name
429 - Too Many Requests- Description
En av följande 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 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 återstående 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.
Skapa en Vinyl Figure-byggtask
Genererar den texturerade 3D-vinylfiguren från en lyckad prototype-task. För dess fält, se The Vinyl Figure build task object.
Request
# Stage 2: chain build off a succeeded prototype task
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"
}
Parametrar
- Name
- input_task_id
- Type
- string
- Obligatorisk
- Description
ID:t för prototype-tasken som ska byggas. Det måste vara en task som ditt konto skapade med
POST /openapi/creative-lab/vinyl-figure/v1/prototype, med statusenSUCCEEDED.Ett ID som inte är en av dina Vinyl Figure-prototype-tasks från API:et returnerar
404, inklusive en prototyp skapad 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 returnerar400.
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
Begäran kan inte köras. Till exempel:
input_task_idsaknas eller är inte ett giltigt task-ID.- Prototype-taskens 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 prototype-task. - Prototype-tasken lyckades men saknar bild. Skapa en ny prototype-task.
Felmeddelandet anger vilket problem som hittades.
- 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, och försök sedan igen.
- Name
404 - Not Found- Description
input_task_idmatchar inte någon Vinyl Figure-prototype-task som ditt konto skapade med API:et. En prototyp skapad i webbappen returnerar också404. Skickaresult-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 vad din hastighetsgräns tillåter. Vänta några sekunder och försök igen. Se Rate limits.
- För många av dina tasks köar eller körs. Vänta tills några är klara och försök 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.
Hämta en Vinyl 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 detsamma gäller för en prototypuppgift som begärs via /build/:id.
För fälten, se The Vinyl Figure prototype task object och The Vinyl Figure build task object.
Request
# Prototype
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de \
-H "Authorization: Bearer ${YOUR_API_KEY}"
# Build
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef \
-H "Authorization: Bearer ${YOUR_API_KEY}"
Prototype Response
{
"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=***"
]
}
Build Response
{
"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=***"
}
]
}
Parametrar
- Name
- id
- Type
- path
- Description
Uppgifts-ID:t från skapandesvaret.
Returnerar
Prototypuppgiftsobjektet eller byggobjektet, beroende på steget i sökvägen.
Felscenarier
- Name
400 - Bad Request- Description
idär inte ett giltigt uppgifts-ID. Skickaresult-ID:t från skapandesvaret.
- Name
403 - Forbidden- Description
Ditt team har IP Filtering aktiverat, och Meshy flaggade uppgiftens bild för tredjeparts immateriella rättigheter. Team på Enterprise-planen 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 Vinyl Figure-uppgift med detta ID tillhör ditt konto, eller så matchar inte uppgiftens steg sökvägen. Kontrollera ID:t, och använd
/prototypeeller/buildfö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.
Ta bort en Vinyl Figure-uppgift
Avbryter en Vinyl Figure-uppgift. Att avbryta en PENDING-uppgift återbetalar dess credits. En IN_PROGRESS-uppgift avbryts utan återbetalning, eftersom en arbetare 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 ID för en byggnadsuppgift 404.
Request
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
// 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 kropp.
Felscenarier
- Name
400 - Bad Request- Description
Något av följande gäller:
idär inte ett giltigt uppgifts-ID. Skickaresult-ID:t från skapandesvaret.- Uppgiften har redan en slutgiltig status (
SUCCEEDED,FAILEDellerCANCELED), så den kan inte avbrytas.
- Name
404 - Not Found- Description
Ingen Vinyl Figure-uppgift med detta ID tillhör ditt konto, eller så matchar inte uppgiftens steg sökvägen. Kontrollera ID:t och använd
/prototypeeller/buildför att matcha uppgiften.
Strömma en Vinyl Figure-uppgift
Strömmar uppdateringar för en Vinyl Figure-uppgift som Server-Sent Events (SSE). Sökvägen måste matcha uppgiftens steg. Om den inte gör det, till exempel ett build-uppgifts-ID på /prototype/:id/stream, skickar strömmen en error-händelse med status_code: 404 och stängs.
Request
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
// 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": "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=***"
}
]
}
Parametrar
- Name
- id
- Type
- path
- Description
Uppgifts-ID:t från skapandesvaret.
Returnerar
En ström av prototype- eller build-uppgiftsobjekt. Varje händelse innehåller hela uppgiftsobjektet, så som Hämta en Vinyl 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 Filtering blockerar uppgiftens resultat skickar strömmen istället en error-händelse, med den status_code som en get-förfrågan skulle returnera.
Lista Vinyl Figure-uppgifter
Returnerar dina Vinyl Figure-uppgifter för ett steg, en sida åt gången. Sökvägen väljer steget. /prototype returnerar endast prototyp-uppgifter, och /build returnerar endast build-uppgifter.
Request
# List prototype tasks
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype?page_size=10 \
-H "Authorization: Bearer ${YOUR_API_KEY}"
# List build tasks
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=***"
]
}
]
Sökvägsparametrar
- Name
- stage
- Type
- path
- Obligatorisk
- Description
Steget att lista,
prototypeellerbuild.
Frågeparametrar
- Name
- page_num
- Type
- integer
- standard 1
- Description
Sidan att returnera, från
1till255.0returnerar den första sidan. Ett värde utanför0till255returnerar400.
- Name
- page_size
- Type
- integer
- standard 10
- Description
Antal uppgifter per sida, upp till
100. Ett värde från101till255returnerar 100 uppgifter, och0använder standardvärdet. Ett värde utanför0till255returnerar400.
- 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 build-uppgiftsobjekt, beroende på steget i sökvägen.
Prototyp-uppgiftsobjektet för Vinyl Figure
En prototyp-uppgift genererar en vinyl-figure-stil koncept-bild från ett foto. För att omvandla bilden till en 3D-modell, skicka uppgiftens ID till build-endpointen som input_task_id.
Egenskaper
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=***"
]
}
- Name
- id
- Type
- string
- Description
Uppgiftens ID. Förlita dig inte på dess format.
- Name
- type
- Type
- string
- Description
Uppgiftstypen, alltid
creative-lab-vinyl-figure-prototype.
- Name
- name
- Type
- string
- Description
namedu skickade när du skapade uppgiften, eller""om du inte skickade någon.
- Name
- status
- Type
- string
- Description
Uppgiftens status.
Tillgängliga värden:
PENDING: väntar i könIN_PROGRESS: genererar resultatetSUCCEEDED: slutgiltig, med resultatetFAILED: slutgiltig, med orsaken itask_errorCANCELED: slutgiltig, utan resultat
- Name
- progress
- Type
- integer
- Description
Procentandel av arbetet som utförts, från
0till100. Den är0tills uppgiften startar och100nä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 worker startade uppgiften, i Unix-millisekunder.
nullfram till dess.
- Name
- finished_at
- Type
- timestamp
- Description
Tiden då uppgiften nådde en slutgiltig status, i Unix-millisekunder.
nullfram till dess.
- Name
- expires_at
- Type
- timestamp
- Description
Tiden då uppgiftens resultat upphör att gälla, i Unix-millisekunder. Det är 3 dagar efter
finished_at, eller 3 dagar eftercreated_attills uppgiften slutförs. 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.1betyder att den startar härnäst.0efter att uppgiften lämnat kön, och alltid0i listresultat.
- Name
- task_error
- Type
- object
- Description
Varför uppgiften misslyckades.
nullom intestatusärFAILED. 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 återbetalar en uppgift endast medan den ärPENDING. Om Meshy inte kan läsa debiteringen utelämnas fältet i ett get- eller stream-svar, och en listförfrågan returnerar500. Försök i så fall igen med förfrågan.
- Name
- image_urls
- Type
- array of strings
- Description
Nedladdnings-URL:er för koncept-bilden. Arrayen innehåller en URL när uppgiften lyckats, och är tom fram till dess.
Objektet för Vinyl Figure-byggtask
Ett byggtask genererar en texturerad 3D-vinylfigur från ett lyckat prototyptask. Dess fält model_urls, thumbnail_url och texture_urls har samma format som i objektet för Bild till 3D-task.
Egenskaper
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=***"
}
]
}
- Name
- id
- Type
- string
- Description
Task-ID:t. Lita inte på dess format.
- Name
- type
- Type
- string
- Description
Tasktypen, alltid
creative-lab-vinyl-figure-build.
- Name
- name
- Type
- string
- Description
namesom du skickade när du skapade tasken, eller""om du inte skickade något.
- Name
- status
- Type
- string
- Description
Taskens status.
Tillgängliga värden:
PENDING: väntar i könIN_PROGRESS: genererar resultatetSUCCEEDED: slutgiltig, med resultatetFAILED: slutgiltig, med orsaken itask_errorCANCELED: slutgiltig, utan resultat
- Name
- progress
- Type
- integer
- Description
Procent av arbetet som är klart, från
0till100. Det är0tills tasken startar och100när den lyckas.
- Name
- created_at
- Type
- timestamp
- Description
Tidpunkt då tasken skapades, i Unix-millisekunder.
- Name
- started_at
- Type
- timestamp
- Description
Tidpunkt då en arbetare startade tasken, i Unix-millisekunder.
nullfram till dess.
- Name
- finished_at
- Type
- timestamp
- Description
Tidpunkt då tasken nådde en slutgiltig status, i Unix-millisekunder.
nullfram till dess.
- Name
- expires_at
- Type
- timestamp
- Description
Tidpunkt då taskens resultat upphör att gälla, i Unix-millisekunder. Det är 3 dagar efter
finished_at, eller 3 dagar eftercreated_attills tasken slutförs. 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
Taskens position i kön medan den är
PENDING.1betyder att den startar härnäst.0efter att tasken lämnat kön, och alltid0i listresultat.
- Name
- task_error
- Type
- object
- Description
Varför tasken misslyckades.
nullom intestatusärFAILED. Se Fel.
- Name
- consumed_credits
- Type
- integer
- Description
Antal credits som debiterats för tasken, efter eventuell återbetalning. En förfrågan som returnerar ett fel debiteras inte. En misslyckad task är
0, eftersom Meshy återbetalar den. Att avbryta återbetalar en task endast medan den ärPENDING. Om Meshy inte kan läsa debiteringen utelämnas fältet i ett get- eller strömsvar, och en listförfrågan returnerar500. I så fall, försök igen med förfrågan.
- Name
- prompt
- Type
- string
- Description
Alltid
""för ett Vinyl Figure-byggtask.
- Name
- negative_prompt
- Type
- string
- Description
Alltid
""för ett Vinyl Figure-byggtask, precis somprompt.
- Name
- texture_prompt
- Type
- string
- Description
Alltid
""för ett Vinyl Figure-byggtask, precis somprompt.
- Name
- texture_image_url
- Type
- string
- Description
Alltid
""för ett Vinyl Figure-byggtask, precis somprompt.
- 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 medobjoch texturen itexture_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 färgkartan (base color).
- Name
base_color- Type
- string
- Description
Nedladdnings-URL för färgkartan (base color).