Creative Lab — Brickfigur API

Källfoto för Meshy att stilisera som en Legofigur. Vi stödjer för närvarande .jpg, .jpeg, .png och .webp format.

Det finns två sätt att tillhandahålla bilden:

• Publikt tillgänglig URL: En URL som är tillgänglig från det publika internet.
• Data URI: En base64-kodad data URI av bilden. Exempel på en data URI: data:image/jpeg;base64,<dina base64-kodade bilddata>.

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

Begäran var oacceptabel. Vanliga orsaker:

• Saknad parameter: image_url krävs.
• Ogiltigt bildformat: Den angivna image_url är inte ett stödformat (.jpg, .jpeg, .png, .webp).
• Bilddimensioner utanför gränserna: Bilden är för liten, överskrider maximum filstorlek eller maksimum pixelantal.
• Onåbar URL: Den image_url kunde inte laddas ner (404 eller timeout).
• Ogiltig Data URI: Base64-strängen är felaktig.
• Innehåll flaggat: Ingångsbilden var flaggad av NSFW eller immateriell moderator.

Autentisering misslyckades. Kontrollera din API-nyckel.

Otillräckliga credits för att utföra denna uppgift.

Indatabilden flaggades för immaterialrättsintrång.

Du har överskridit din hastighetsgräns.

Uppgifts-ID för en prototypuppgift skapad via denna samma OpenAPI-endpoint. Prototypen måste ha skapats med samma API-nyckel, måste ha uppnått SUCCEEDED, och måste ha producerat exakt en kandidatbild.

Prototypuppgifter skapade genom webappen accepteras inte — bygg-endpoint accepterar endast prototypuppgifter producerade av POST /openapi/creative-lab/brick-figure/v1/prototype och avvisar andra källor med 404.

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

Förfrågan var oacceptabel. Vanliga orsaker:

• Saknad parameter: input_task_id krävs.
• Ogiltig UUID: input_task_id är inte en giltig UUID.
• Förälder inte lyckad: Den refererade prototypuppgiften har ännu inte nått SUCCEEDED.
• Ingen kandidat: Prototypuppgiften lyckades men producerade ingen kandidatbild.

Autentiseringen misslyckades. Vänligen kontrollera din API-nyckel.

Otillräckliga credits för att utföra denna uppgift.

Den refererade prototypuppgiften existerar inte, tillhör en annan användare, eller skapades genom webappen (endast API-läge prototypuppgifter kedjas till bygg).

Du har överskridit din hastighetsgräns.

Unik identifierare för brick figuruppgiften att hämta.

Unikt identifierare för brick figure-uppgiften som ska avbrytas.

Uppgiften är redan i ett slutligt tillstånd och kan inte avbrytas.

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

Unik identifierare för legofiguruppgiften att strömma.

Antingen prototype eller build. Samlingen returnerar endast uppgifter vars steg matchar URL-sökvägen — att hämta /prototype returnerar aldrig bygguppgifter och vice versa.

Sidnummer för paginering.

Begränsning 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.

Unikt identifierare för uppgiften. Även om vi använder ett k-sorterbart UUID för uppgifts-id som en implementeringsdetalj, bör du inte göra några antaganden om formatet av id.

Typ av uppgift. Värdet är creative-lab-brick-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 en av PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Uppgiftens framsteg. Om uppgiften inte har påbörjats än, kommer denna egenskap att vara 0. När uppgiften har lyckats kommer detta bli 100.

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

Tidsstämpeln för när uppgiften startades, i millisekunder. Om uppgiften inte har startats än, kommer denna egenskap att vara null.

Tidsstämpeln för när uppgiften avslutades, i millisekunder. Om uppgiften inte har avslutats än, kommer denna egenskap att vara null.

Tidsstämpeln för när uppgiftens resultat går ut, i millisekunder.

Antalet tidigare uppgifter.

Felinformation för misslyckade uppgifter. Se Fel för den fulla referens för task_error-objektet.

Antalet credits förbrukade av denna uppgift. Närvarande när uppgiftens status är PENDING, IN_PROGRESS, eller SUCCEEDED. Återgår 0 för FAILED-uppgifter (credits återbetalas vid misslyckande).

Nedladdningsbara URL:er för konceptbildskandidaterna som genereras av denna prototypuppgift. För närvarande returnerar API alltid exakt en kandidat; fältet är en array så att framtida revideringar kan hantera flera kandidater utan att bryta kompatibilitet.

Unikt identifierare för uppgiften.

Typ av uppgift. Värdet är creative-lab-brick-figure-build.

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

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

Framsteg för uppgiften. Om uppgiften inte har startat än kommer denna egenskap att vara 0. När uppgiften har lyckats kommer denna att bli 100.

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

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

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

Tidsstämpel för när uppgiftsresultatet går ut, i millisekunder.

Antal föregående uppgifter. Meningsfullt endast när status är PENDING.

Felinformation för misslyckade uppgifter. Se Fel för full task_error objektreferens.

Antalet poäng som används av denna uppgift. Returnerar 0 för FAILED uppgifter (poäng återbetalas vid misslyckande).

Alltid tom för tegel figur byggen. Finns för kompatibilitet mellan endpoints med den delade V2ImageTo3DTaskResponse formen använd av Bild till 3D.

Alltid tom för tegel figur byggen. Finns för kompatibilitet mellan endpoints.

Alltid tom för tegel figur byggen. Finns för kompatibilitet mellan endpoints.

Alltid tom för tegel figur byggen. Finns för kompatibilitet mellan endpoints.

Nedladdningsbara URL:er för den genererade 3D-modellen. Tegel figur bygget avger en texturerad GLB plus OBJ + MTL-paret för pipelines som föredrar Wavefront OBJ. Fältformen matchar Bild till 3D model_urls objektet så att framtida formatläggningar kan ske utan att bryta förändringar.

Nedladdningsbar URL till miniatyrbilden av modelfilen.

En lista med URL-objekt för texturer genererade av denna uppgift. Innehåller för närvarande ett enda objekt med basfärgkartan.