Creative Lab — kylskåpsmagnet-API

Källfoto som Meshy ska färglägga till en konceptbild redo för kylskåpsmagnet. Vi stöder för närvarande formaten .jpg, .jpeg, .png och .webp.

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

• Publikt tillgänglig URL: En URL som är tillgänglig från det öppna 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 uppgiftsnamn för visningsändamål. Max 100 tecken.

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

Detta styr endast bilden som denna endpoint returnerar. Det är separat från build-alternativet med samma namn (standard true), som styr bakgrundsborttagning innan reliefbearbetning.

Begäran kunde inte accepteras. 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).
• Bilddimensioner utanför intervallet: Bilden är för liten, överskrider maximal filstorlek eller överskrider maximalt antal pixlar.
• Onåbar URL: image_url kunde inte laddas ner (404 eller timeout).
• Ogiltig Data URI: Base64-strängen är felaktigt utformad.
• Innehåll flaggat: Den angivna bilden flaggades av moderation för NSFW eller immateriella rättigheter.

Autentiseringen misslyckades. Kontrollera din API-nyckel.

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

Du har överskridit din hastighetsgräns.

Uppgifts-ID för en prototypuppgift skapad 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.

Prototypuppgifter skapade via webappen accepteras inte — byggändpunkten accepterar endast prototypuppgifter som producerats av POST /openapi/creative-lab/fridge-magnet/v1/prototype och avvisar alla andra källor med 404.

Valfritt uppgiftsnamn för visningssyften. Maximalt 100 tecken.

Konturform för kylskåpsmagneten. Tillgängliga värden:

• circle
• rounded-rect (standard)
• hexagon
• shield
• star

Sidlängd för den avgränsande kvadraten för kylskåpsmagneten, i millimeter. Intervall: (0, 400].

Maximal relieffhöjd ovanför basen, i millimeter. Intervall: [0, 20].

Vertikal förskjutning som tillämpas på reliefen före extrudering, i millimeter. Intervall: [0, 20].

Tjocklek på den platta baskonstruktionen bakom reliefen, i millimeter. Standardvärdet för kylskåpsmagneten är en robustare bas på 2 mm — det ger magneten tillräcklig kropp för att greppa kylskåpet utan att reliefen känns skör. Intervall: [0, 20].

Om baksidan av kylskåpsmagneten är förseglad som en sluten yta (sidan du limmar magneten på). Sätt till false för ett öppet skal.

Överföringskurva som mappar djupkartsvärden till relieffhöjd. Tillgängliga värden:

• linear (standard)
• gamma
• s-curve

Formparameter för överföringskurvan (endast meningsfull när relief_curve är gamma). Intervall: (0, 10].

Inverterar tolkningen av djupkartan så att mörkare områden blir högre relief.

Utjämningsstyrka som tillämpas på djupkartan innan reliefen extraheras. Intervall: [0, 10].

Vertikal skalfaktor som tillämpas utöver relief_height_mm. Intervall: (0, 10].

Lågpassgräns för djupkartsvärden; allt under detta klipps av till noll. Intervall: [0, 1].

Tar automatiskt bort bakgrunden från prototypens konceptbild innan reliefen skapas.

Skild från prototypparametern med samma namn (standard false), som styr om själva prototypbilden returneras med transparens.

Nätupplösning som används för export. Intervall: [64, 2048].

Artefaktpaket som returneras av byggåtgärden. Tillgängliga värden:

• glb (standard) — returnerar en enda model.glb under model_urls.glb.
• obj — zippar model.obj + model.mtl + texture.png och returnerar paketet under model_urls.obj.
• zip — zippar varje artefakt som generatorn skapar och returnerar paketet under model_urls.bundle_zip.

Begäran var oacceptabel. Vanliga orsaker:

• Saknad parameter: input_task_id krävs.
• Ogiltig UUID: input_task_id är inte en giltig UUID.
• Överordnad uppgift ej lyckad: Den refererade prototypuppgiften har ännu inte nått SUCCEEDED.
• Ingen kandidat: Prototypuppgiften lyckades men producerade ingen kandidatbild.
• Alternativ utanför intervall: Ett av fälten i options låg utanför sitt tillåtna intervall eller enum-uppsättning.

Autentiseringen misslyckades. Kontrollera din API-nyckel.

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

Den refererade prototypuppgiften finns inte, tillhör en annan användare, eller skapades via webappen (endast prototypuppgifter i API-mode kan kedjas till en byggåtgärd).

Du har överskridit din hastighetsgräns.

Unik identifierare för kylskåpsmagnet-uppgiften som ska hämtas.

Unik identifierare för den kylskåpsmagnet-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 den kylskåpsmagnet-uppgift som ska streamas.

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 skapelsetid i stigande ordning.
• -created_at: Sortera efter skapelsetid 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.

Uppgiftens typ. Värdet är creative-lab-fridge-magnet-prototype.

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

Uppgiftens status. Möjliga värden är ett av PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Uppgiftens progress. Om uppgiften ännu inte har startat kommer denna egenskap 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.

Felinformation för misslyckade uppgifter. Se Fel för den fullständiga referensen för task_error-objektet.

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 prototypuppgift. För närvarande returnerar API:et alltid exakt en kandidat; fältet är en array så att framtida revisioner kan tillhandahålla flera kandidater utan en bakåtkompatibilitetsbrytande ändring.

Unik identifierare för tasken.

Typ av task. Värdet är creative-lab-fridge-magnet-build.

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

Förlopp (progress) för tasken. Om tasken ännu inte har startat blir denna egenskap 0. När tasken har lyckats blir den 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. Endast meningsfullt när status är PENDING.

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

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

Nedladdningsbara URL:er för den genererade artefakten, med artefaktnamn som nyckel. Innehåller alltid exakt en post — formatet som begärdes via byggbegärans output.format. Nyckeln matchar det begärda formatet: