Creative Lab — Vinyl Figure API

Källfoto som Meshy ska stilisera som en big-head vinylfigur. Vi stöder för närvarande formaten .jpg, .jpeg, .png och .webp.

Det finns två sätt att ange bilden på:

• Offentligt tillgänglig URL: En URL som är tillgänglig från det offentliga internet.
• Data URI: En base64-kodad data-URI för bilden. Exempel på en data-URI: data:image/jpeg;base64,<your base64-encoded image data>.

Valfritt tasknamn för visningsändamål. Max 100 tecken.

När den sätts till true returneras prototypbilden som en transparent RGBA-PNG med bakgrunden borttagen, så att du kan sammanfoga motivet med valfri bakgrund.

Förfrågan var oacceptabel. Vanliga orsaker:

• Saknad parameter: image_url krävs.
• Ogiltigt bildformat: Den angivna image_url har inte ett format som stöds (.jpg, .jpeg, .png, .webp).
• Bildmått utanför tillåtet intervall: Bilden är för liten, överskrider den maximala filstorleken eller överskrider det maximala antalet pixlar.
• Onåbar URL: image_url kunde inte laddas ner (404 eller timeout).
• Ogiltig Data URI: Base64-strängen är felformaterad.
• Innehåll flaggat: Den inmatade bilden flaggades av moderation för olämpligt innehåll eller immateriella rättigheter.

Autentiseringen misslyckades. Kontrollera din API-nyckel.

Otillräckligt med credits för att utföra denna task.

Du har överskridit din hastighetsgräns.

Aktivitets-ID för en prototypåtgärd som skapats via samma OpenAPI-endpoint. Prototypen måste ha skapats med samma API-nyckel, måste ha nått SUCCEEDED, och måste ha producerat exakt en kandidatbild.

Prototypåtgärder som skapats via webbappen accepteras inte — build-endpointen accepterar endast prototypåtgärder som producerats av POST /openapi/creative-lab/vinyl-figure/v1/prototype och avvisar alla andra källor med 404.

Valfritt aktivitetsnamn för visningsändamål. Maximalt 100 tecken.

Begäran var oacceptabel. Vanliga orsaker:

• Saknad parameter: input_task_id krävs.
• Ogiltig UUID: input_task_id är inte ett giltigt UUID.
• Överordnad åtgärd ej lyckad: Den refererade prototypåtgärden har inte nått SUCCEEDED ännu.
• Ingen kandidat: Prototypåtgärden lyckades men producerade ingen kandidatbild.

Autentiseringen misslyckades. Kontrollera din API-nyckel.

Otillräckligt med credits för att utföra denna åtgärd.

Den refererade prototypåtgärden finns inte, tillhör en annan användare, eller skapades via webbappen (endast prototypåtgärder i API-mode kan kedjas vidare till build).

Du har överskridit din hastighetsgräns.

Unik identifierare för vinyl figure-uppgiften som ska hämtas.

Unik identifierare för den vinyl figure-uppgift som ska avbrytas.

Uppgiften befinner sig redan i ett sluttillstånd och kan inte avbrytas.

Uppgiften finns inte, tillhör en annan användare, eller dess steg matchar inte URL-sökvägen.

Unik identifierare för vinylfigur-uppgiften som ska strömmas.

Antingen prototype eller build. Samlingen returnerar endast uppgifter vars steg matchar URL:en — att hämta /prototype returnerar aldrig build-uppgifter och vice versa.

Sidnummer för paginering.

Gräns för sidstorlek. Maximalt tillåtet är 100 objekt.

Fält att sortera efter. Tillgängliga värden:

• +created_at: Sortera efter skapandetid i stigande ordning.
• -created_at: Sortera efter skapandetid i fallande ordning.

Unik identifierare för uppgiften. Även om vi använder en k-sorterbar UUID för uppgifts-id som implementationsdetalj bör du inte göra några antaganden om id:ts format.

Typ av uppgift. Värdet är creative-lab-vinyl-figure-prototype.

Uppgiftsnamnet som angavs när uppgiften skapades. Tom sträng om inget namn angavs.

Status för uppgiften. Möjliga värden är ett av PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Uppgiftens progress. Om uppgiften ännu inte har startat kommer den här egenskapen att vara 0. När uppgiften har lyckats blir den 100.

Tidsstämpel för när uppgiften skapades, i millisekunder.

Tidsstämpel för när uppgiften startades, i millisekunder. Om uppgiften ännu inte har startat kommer denna egenskap att vara 0.

Tidsstämpel för när uppgiften avslutades, i millisekunder. Om uppgiften ännu inte är avslutad kommer denna egenskap att vara 0.

Tidsstämpel för när uppgiftens resultat upphör att gälla, i millisekunder.

Antalet föregående uppgifter.

Feldetaljer för misslyckade uppgifter. Se Fel för fullständig referens av objektet task_error.

Antalet credits som förbrukats av denna uppgift. Finns när uppgiftens status är PENDING, IN_PROGRESS, eller SUCCEEDED. Returnerar 0 för FAILED-uppgifter (credits återbetalas vid misslyckande).

Nedladdningsbara URL:er för de konceptbildskandidater som genererats av denna prototyp-uppgift. För närvarande returnerar API:et alltid exakt en kandidat; fältet är en array så att framtida revideringar kan tillhandahålla flera kandidater utan en brytande ändring.

Unik identifierare för tasken.

Typ av task. Värdet är creative-lab-vinyl-figure-build.

Task-namnet som angavs när tasken skapades. Tom sträng om inget namn angavs.

Status för tasken. Möjliga värden är ett av PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Progress för tasken. Om tasken inte har startats än blir detta värde 0. När tasken har lyckats blir det 100.

Tidsstämpel för när tasken skapades, i millisekunder.

Tidsstämpel för när tasken startades, i millisekunder.

Tidsstämpel för när tasken avslutades, i millisekunder.

Tidsstämpel för när taskresultatet upphör att gälla, i millisekunder.

Antalet föregående tasks. Har endast betydelse när status är PENDING.

Feldetaljer för misslyckade tasks. Se Fel för den fullständiga referensen till task_error-objektet.

Antalet credits som förbrukats av denna task. Returnerar 0 för FAILED-tasks (credits återbetalas vid fel).

Alltid tom för vinyl figure build. Finns för kompatibilitet mellan endpoints med den delade V2ImageTo3DTaskResponse-formen som används av Bild till 3D.

Alltid tom för vinyl figure build. Finns för kompatibilitet mellan endpoints.

Alltid tom för vinyl figure build. Finns för kompatibilitet mellan endpoints.

Alltid tom för vinyl figure build. Finns för kompatibilitet mellan endpoints.

Nedladdningsbara URL:er för den genererade 3D-modellen. Vinyl figure build genererar en texturerad GLB plus OBJ + MTL-paret för pipelines som föredrar Wavefront OBJ. Fältets form matchar objektet Image to 3D model_urls så att framtida formattillägg passar in utan en brytande ändring.

Nedladdningsbar URL till miniatyrbilden av modellfilen.

En array med textur-URL-objekt som genererats av denna task. Innehåller för närvarande ett enda objekt med bas-färgkartan.