Creative Lab — Fidget Pixel API

Källfoto som Meshy ska pixelisera. Vi stöder för närvarande formaten .jpg, .jpeg, .png och .webp.

Formatet identifieras genom att avkoda bilddatan, inte utifrån URL:ens filändelse — en URL utan filändelse, eller en som omdirigerar, fungerar så länge byten avkodas till ett format som stöds. HTTP-omdirigeringar följs.

Det finns två sätt att ange bilden:

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

Vad fotot visar. Väljer pixeliseringsstilen, så välj medvetet — de två ger märkbart olika resultat. Tillgängliga värden:

• person — motivet är en person (porträtt eller helkropp). Genererar en chibi-stiliserad pixelsprite av motivet.
• other — allt annat: husdjur, föremål, maskotar, logotyper, landskap. Genererar en pärlplatte-stiliserad pixelikon av motivet.

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

Begäran kunde inte accepteras. Vanliga orsaker:

• Saknad parameter: Både image_url och type krävs.
• Ogiltig type: type måste vara person eller other.
• 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 hämtas (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.

Otillräckligt med credits för att utföra denna task, eller så tillhör API-nyckeln ett konto med gratisplan.

Den angivna bilden flaggades av moderation för immaterialrätt (Content flagged for intellectual property violation). Endast Enterprise-konton med immaterialrättsfiltrering aktiverad blockeras; ingenting debiteras.

Du har överskridit din hastighetsgräns.

Själva immaterialrättskontrollen kunde inte slutföras (Unable to perform intellectual property check, please try again). Enterprise-konton med immaterialrättsfiltrering aktiverad misslyckas restriktivt vid denna kontroll; ingenting debiteras — försök igen.

Task-ID för en prototyptask skapad via samma OpenAPI-endpoint. Prototypen måste ha skapats av samma Meshy-konto och måste ha nått SUCCEEDED.

Prototyptasks som skapats via webbappen accepteras inte — byggendpointen accepterar endast prototyptasks som producerats av POST /openapi/creative-lab/fidget-pixel/v1/prototype och avvisar alla andra källor med 404.

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

Fotavtryck för varje del. Tillgängliga värden:

• square (standard) — kvadratiska delar på ett kvadratiskt rutnät.
• hex — hexagonala delar på ett hexagonalt rutnät. Hexagonala delar finns endast i 6 och 8 mm.

Antal delar längs varje sida av brädan. Tillgängliga värden: 16 eller 32. Ett 32-rutnät bevarar mer detalj; ett 16-rutnät innebär färre, större delar för samma motiv.

Kantlängd för varje del, i millimeter. Tillgängliga värden: 6, 8 eller 10. Tillsammans med grid_size bestämmer detta den utskrivna brädans storlek — till exempel 32 × 8 mm ≈ 26 cm per sida. 10 är inte tillgängligt för shape: "hex" (den sluttande hexagonala ytan skapar överhäng på de flesta konsument-FDM-skrivare).

Maximalt antal färger i paletten som bilden kvantiseras till. Intervall: [1, 8]. Varje färg blir ett filament i din slicer.

Höjd för varje del, i millimeter. Intervall: [10, 80].

Artefakt som returneras av byggprocessen. Tillgängliga värden:

• 3mf (standard) — returnerar en enda model.3mf under model_urls.3mf, med ett objekt per del och delens färg kopplad till varje objekt.

Begäran var inte godtagbar. Vanliga orsaker:

• Saknad parameter: input_task_id krävs.
• Ogiltig UUID: input_task_id är inte en giltig UUID.
• Överordnad task ej lyckad: Den refererade prototyptasken har inte nått SUCCEEDED ännu.
• Ingen kandidat: Prototyptasken lyckades men producerade ingen pixelbaserad bild; skapa en ny prototyp.
• Alternativ utanför intervall: Ett av fälten i options är utanför sin tillåtna uppsättning eller intervall — till exempel options.grid_size must be 16 or 32, eller options.piece_size_mm=10 is not supported for shape=hex; hex pieces are available in 6 and 8 mm.
• Format som inte stöds: output.format måste vara 3mf.

Autentiseringen misslyckades. Kontrollera din API-nyckel.

Otillräckliga credits för att utföra denna task, eller så tillhör API-nyckeln ett konto med gratisplan.

Den refererade prototypens bild flaggades av moderation för immateriella rättigheter. Endast Enterprise-konton med filtrering av immateriella rättigheter aktiverad blockeras; inget debiteras.

Den refererade prototyptasken finns inte, tillhör en annan användare eller skapades via webbappen (endast prototyptasks i API-mode kedjas vidare till bygge).

Du har överskridit din hastighetsgräns.

Den refererade prototypens utslag för immateriella rättigheter kunde inte fastställas (Unable to perform intellectual property check, please try again). Enterprise-konton med filtrering av immateriella rättigheter aktiverad misslyckas i stängt läge vid denna kontroll; inget debiteras — försök igen med begäran.

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

id är inte ett giltigt UUID (Invalid ID).

Uppgiftens bild flaggades av moderation för immateriella rättigheter. Endast Enterprise-konton med filtrering av immateriella rättigheter aktiverad blockeras.

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

Kontrollen av immateriella rättigheter kunde inte slutföras (Unable to perform intellectual property check, please try again); Enterprise-konton med filtrering av immateriella rättigheter aktiverad misslyckas i låst läge (fail closed). Försök igen med begäran.

Unik identifierare för fidget pixel-uppgiften som ska avbrytas.

Förfrågan kunde inte accepteras. Vanliga orsaker:

• Ogiltigt ID: id är inte ett giltigt UUID.
• Slutgiltigt tillstånd: Uppgiften är redan SUCCEEDED, FAILED eller CANCELED 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 fidget pixel-uppgift som ska strömmas.

Antingen prototype eller build. Samlingen returnerar endast uppgifter vars steg matchar URL:en — att hämta /prototype returnerar aldrig byggnadsuppgifter 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 ett k-sorterbart 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-fidget-pixel-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 inte har startat ännu 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 inte har startat ännu kommer denna egenskap att vara null.

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

Tidsstämpel för när uppgiftens resultat upphör att gälla, i millisekunder — 3 dagar efter att uppgiften avslutades. Enterprise-konton behåller API-resultat på obestämd tid (se Tillgångslagring); för dem sätts denna tidsstämpel till omkring 100 år framåt.

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. En uppgift som når SUCCEEDED debiteras hela beloppet för sitt steg. En uppgift som aldrig skapas (ett 4xx-fel vid förfrågningstillfället, inklusive en avvisning av moderation) debiteras inte alls. En uppgift som når FAILED returnerar 0 — avgiften återbetalas. Avbrytning via DELETE återbetalas endast medan uppgiften fortfarande är PENDING; en uppgift som redan är IN_PROGRESS förblir debiterad, eftersom arbetet redan har utförts.

Nedladdningsbara URL:er för pixelkonstbilden som genererats av denna prototypuppgift. Just nu returnerar API:et alltid exakt en bild; fältet är en array så att framtida revisioner kan visa flera kandidater utan en brytande ändring. Tomt tills uppgiften når SUCCEEDED.

Dessa är signerade URL:er: hämta dem utan en Authorization-header. De förblir giltiga fram till expires_at, vilket är 3 dagar efter finished_at, och att läsa uppgiften igen inom detta tidsfönster returnerar samma URL istället för en nysignerad. Ladda ner och spara filerna själv innan dess — det finns inget sätt att förnya en utgången länk.

Unik identifierare för tasket.

Typ av task. Värdet är creative-lab-fidget-pixel-build.

Tasknamnet som angavs när tasket skapades. Tom sträng om inget namn angavs.

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

Progress för tasket. Om tasket inte har startats ännu är denna egenskap 0. När tasket har lyckats blir den 100.

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

Tidsstämpel för när tasket startades, i millisekunder. null tills tasket startar.

Tidsstämpel för när tasket avslutades, i millisekunder. null tills tasket avslutas.

Tidsstämpel för när taskresultatet upphör att gälla, i millisekunder — 3 dagar efter att tasket avslutades. Enterprise-konton behåller API-resultat på obestämd tid (se tillgångslagring); för dem är denna tidsstämpel satt cirka 100 år framåt.

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

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

Antalet credits som förbrukats av detta task. Ett task som når SUCCEEDED debiteras hela beloppet för sitt steg. Ett task som aldrig skapas (ett 4xx-fel vid begäranstillfället, inklusive en moderation-avvisning) debiteras inte alls. Ett task som når FAILED returnerar 0 — avgiften återbetalas. Avbrytande via DELETE återbetalar endast medan tasket fortfarande är PENDING; ett task som redan är IN_PROGRESS förblir debiterat, eftersom arbetet redan har utförts.

Nedladdningsbara URL:er för den genererade tillgången, sorterade efter format. Innehåller exakt en post — formatet som begärdes via build-begärans output.format. Tom tills tasket når SUCCEEDED.

Dessa är signerade URL:er: hämta dem utan en Authorization-header. De förblir giltiga fram till expires_at, vilket är 3 dagar efter finished_at, och att läsa tasket igen inom detta fönster returnerar samma URL istället för en nysignerad. Ladda ner och spara filerna själv innan dess — det finns inget sätt att uppdatera en utgången länk.