Creative Lab — Collapsible Fidget API

Källfoto som Meshy ska omvandla till en hopfällbar fidget. Vi stödjer för närvarande formaten .jpg, .jpeg, .png och .webp.

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

• Offentligt 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,<din base64-kodade bilddata>.

Ett motiv med en tydlig, sluten kontur fungerar bäst — det är silhuetten som blir till ringarna. Röriga bakgrunder, flera separata motiv eller mycket tunna former kan lämna för lite yta för de nästlade väggarna, och uppgiften misslyckas med ett uppgiftsfel.

Valfritt uppgiftsnamn för visningsändamål. Max 100 tecken. Detta är endast en etikett för uppgiften; ingenting graveras på modellen.

Begäran var inte godtagbar. 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 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 felaktigt formaterad.
• Innehåll flaggat: Den angivna bilden flaggades av NSFW-moderation.

Autentiseringen misslyckades. Kontrollera din API-nyckel.

Antingen har ditt konto en gratisplan — att skapa uppgifter på denna endpoint kräver en betalplan — eller så har du otillräckligt med credits.

Den angivna bilden flaggades för intrång i immateriella rättigheter.

Du har överskridit din hastighetsgräns.

Unik identifierare för den collapsible fidget-uppgift som ska hämtas.

Unik identifierare för den hopfällbara fidget-uppgift som ska avbrytas.

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

Uppgiften finns inte, tillhör en annan användare eller skapades inte via denna endpoint.

Unik identifierare för den collapsible fidget-uppgift som ska streamas.

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 ett implementationsdetalj, bör du inte göra några antaganden om formatet på id:t.

Typ av uppgift. Värdet är creative-lab-fidget-collapsible.

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 är denna egenskap 0. Så snart 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 är denna egenskap null.

Tidsstämpel för när uppgiften avslutades, i millisekunder. Om uppgiften ännu inte är avslutad är denna egenskap null.

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 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 den genererade 3D-modellen. Fylls i när uppgiften har SUCCEEDED: stl finns alltid med, glb endast när förhandsgranskningsrenderingen lyckades.