Creative Lab — Fidget Pixel API

Bronfoto die Meshy moet pixelizeren. We ondersteunen momenteel de formaten .jpg, .jpeg, .png en .webp.

Het formaat wordt gedetecteerd door de afbeeldingsgegevens te decoderen, niet aan de hand van de bestandsextensie van de URL — een URL zonder extensie, of een die doorverwijst, werkt zolang de bytes decoderen naar een ondersteund formaat. HTTP-redirects worden gevolgd.

Er zijn twee manieren om de afbeelding aan te leveren:

• Openbaar toegankelijke URL: Een URL die vanaf het openbare internet toegankelijk is.
• Data URI: Een base64-gecodeerde data-URI van de afbeelding. Voorbeeld van een data-URI: data:image/jpeg;base64,<uw base64-gecodeerde afbeeldingsgegevens>.

Wat de foto toont. Bepaalt de pixelizatiestijl, kies dus bewust — de twee opties leveren zichtbaar verschillende resultaten op. Beschikbare waarden:

• person — het onderwerp is een persoon (portret of volledig lichaam). Produceert een chibi-stijl pixel-sprite van het onderwerp.
• other — al het overige: huisdieren, objecten, mascottes, logo's, landschappen. Produceert een bead-art stijl pixel-icoon van het onderwerp.

Optionele tasknaam voor weergavedoeleinden. Maximaal 100 tekens.

Het verzoek was onaanvaardbaar. Veelvoorkomende oorzaken:

• Ontbrekende parameter: zowel image_url als type zijn verplicht.
• Ongeldig type: type moet person of other zijn.
• Ongeldig afbeeldingsformaat: de opgegeven image_url heeft geen ondersteund formaat (.jpg, .jpeg, .png, .webp).
• Afbeeldingsafmetingen buiten bereik: de afbeelding is te klein, overschrijdt de maximale bestandsgrootte of overschrijdt het maximale aantal pixels.
• Onbereikbare URL: de image_url kon niet worden gedownload (404 of timeout).
• Ongeldige Data URI: de base64-string is onjuist opgemaakt.
• Content gemarkeerd: de invoerafbeelding is gemarkeerd door NSFW-moderation.

Authenticatie mislukt. Controleer uw API-sleutel.

Onvoldoende credits om deze task uit te voeren, of de API-sleutel behoort tot een account met een gratis abonnement.

De invoerafbeelding is gemarkeerd door moderation op intellectueel eigendom (Content flagged for intellectual property violation). Alleen Enterprise-accounts met ingeschakelde filtering op intellectueel eigendom worden geblokkeerd; er wordt niets in rekening gebracht.

U heeft uw rate limit overschreden.

De controle op intellectueel eigendom zelf kon niet worden voltooid (Unable to perform intellectual property check, please try again). Enterprise-accounts met ingeschakelde filtering op intellectueel eigendom falen bij deze controle op een veilige manier (fail closed); er wordt niets in rekening gebracht — probeer het verzoek opnieuw.

De task-ID van een prototype-task die via ditzelfde OpenAPI-endpoint is aangemaakt. Het prototype moet zijn aangemaakt door hetzelfde Meshy-account en moet SUCCEEDED hebben bereikt.

Prototype-tasks die via de webapp zijn aangemaakt, worden niet geaccepteerd — het build-endpoint accepteert alleen prototype-tasks geproduceerd door POST /openapi/creative-lab/fidget-pixel/v1/prototype en weigert elke andere bron met 404.

Optionele tasknaam voor weergavedoeleinden. Maximaal 100 tekens.

Voetafdruk van elk onderdeel. Beschikbare waarden:

• square (standaard) — vierkante onderdelen op een vierkant raster.
• hex — zeshoekige onderdelen op een zeshoekig raster. Hexagonale onderdelen zijn alleen beschikbaar in 6 en 8 mm.

Aantal onderdelen langs elke zijde van het bord. Beschikbare waarden: 16 of 32. Een raster van 32 behoudt meer detail; een raster van 16 betekent minder, grotere onderdelen voor hetzelfde onderwerp.

Randlengte van elk onderdeel, in millimeters. Beschikbare waarden: 6, 8 of 10. Samen met grid_size bepaalt dit de geprinte bordgrootte — bijvoorbeeld 32 × 8 mm ≈ 26 cm per zijde. 10 is niet beschikbaar voor shape: "hex" (het schuine hexagonale vlak veroorzaakt overhang op de meeste consumenten-FDM-printers).

Maximaal aantal kleuren in het palet waartoe de afbeelding wordt gekwantiseerd. Bereik: [1, 8]. Elke kleur wordt één filament in je slicer.

Hoogte van elk onderdeel, in millimeters. Bereik: [10, 80].

Artefact geretourneerd door de build. Beschikbare waarden:

• 3mf (standaard) — retourneert een enkel model.3mf onder model_urls.3mf, met één object per onderdeel en de kleur van het onderdeel gekoppeld aan elk object.

Het verzoek was onaanvaardbaar. Veelvoorkomende oorzaken:

• Ontbrekende parameter: input_task_id is verplicht.
• Ongeldige UUID: De input_task_id is geen geldige UUID.
• Bovenliggende task niet geslaagd: De verwezen prototype-task heeft SUCCEEDED nog niet bereikt.
• Geen kandidaat: De prototype-task is geslaagd, maar heeft geen pixel-art-afbeelding opgeleverd; maak een nieuw prototype aan.
• Opties buiten bereik: Een van de options-velden valt buiten de toegestane set of het toegestane bereik — bijvoorbeeld options.grid_size must be 16 or 32, of options.piece_size_mm=10 is not supported for shape=hex; hex pieces are available in 6 and 8 mm.
• Niet-ondersteund formaat: output.format moet 3mf zijn.

Authenticatie is mislukt. Controleer je API-sleutel.

Onvoldoende credits om deze task uit te voeren, of de API-sleutel behoort tot een account met een gratis abonnement.

De afbeelding van het verwezen prototype is gemarkeerd door moderation op intellectueel eigendom. Alleen Enterprise-accounts met ingeschakelde filtering op intellectueel eigendom worden geblokkeerd; er wordt niets in rekening gebracht.

De verwezen prototype-task bestaat niet, behoort tot een andere gebruiker, of is aangemaakt via de webapp (alleen prototype-tasks in API-mode kunnen worden doorgeschakeld naar build).

Je hebt je rate limit overschreden.

Het oordeel over intellectueel eigendom van het verwezen prototype kon niet worden vastgesteld (Unable to perform intellectual property check, please try again). Enterprise-accounts met ingeschakelde filtering op intellectueel eigendom slaan bij deze controle standaard dicht (fail closed); er wordt niets in rekening gebracht — probeer het verzoek opnieuw.

Unieke identifier voor de op te halen fidget pixel-taak.

id is geen geldige UUID (Invalid ID).

De afbeelding van de taak werd gemarkeerd door moderation voor intellectueel eigendom. Alleen Enterprise-accounts met filtering op intellectueel eigendom ingeschakeld worden geblokkeerd.

De taak bestaat niet, behoort toe aan een andere gebruiker, of de fase komt niet overeen met het URL-pad.

De controle op intellectueel eigendom kon niet worden voltooid (Unable to perform intellectual property check, please try again); Enterprise-accounts met filtering op intellectueel eigendom ingeschakeld falen gesloten. Probeer het verzoek opnieuw.

Unieke identificatie voor de fidget pixel-taak die geannuleerd moet worden.

Het verzoek was onaanvaardbaar. Veelvoorkomende oorzaken:

• Ongeldige ID: id is geen geldige UUID.
• Eindstatus: De taak is al SUCCEEDED, FAILED of CANCELED en kan niet worden geannuleerd.

De taak bestaat niet, behoort toe aan een andere gebruiker, of de fase komt niet overeen met het URL-pad.

Unieke identifier voor de fidget pixel-taak die gestreamd moet worden.

Ofwel prototype of build. De collectie retourneert alleen taken waarvan de fase overeenkomt met de URL — het ophalen van /prototype retourneert nooit build-taken en vice versa.

Paginanummer voor paginering.

Maximum aantal items per pagina. Maximaal toegestaan is 100 items.

Veld om op te sorteren. Beschikbare waarden:

• +created_at: Sorteren op aanmaaktijd in oplopende volgorde.
• -created_at: Sorteren op aanmaaktijd in aflopende volgorde.

Unieke identifier voor de taak. Hoewel we een k-sorteerbare UUID gebruiken voor taak-id's als implementatiedetail, mag je geen aannames doen over de opmaak van de id.

Type van de taak. De waarde is creative-lab-fidget-pixel-prototype.

De taaknaam die is opgegeven bij het aanmaken van de taak. Lege tekenreeks als er geen naam is opgegeven.

Status van de taak. Mogelijke waarden zijn PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Voortgang van de taak. Als de taak nog niet is gestart, is deze eigenschap 0. Zodra de taak is geslaagd, wordt dit 100.

Tijdstempel van wanneer de taak is aangemaakt, in milliseconden.

Tijdstempel van wanneer de taak is gestart, in milliseconden. Als de taak nog niet is gestart, is deze eigenschap null.

Tijdstempel van wanneer de taak is voltooid, in milliseconden. Als de taak nog niet is voltooid, is deze eigenschap null.

Tijdstempel van wanneer het taakresultaat verloopt, in milliseconden — 3 dagen nadat de taak is voltooid. Enterprise-accounts bewaren API-resultaten voor onbepaalde tijd (zie Asset-retentie); voor hen wordt deze tijdstempel ongeveer 100 jaar vooruit ingesteld.

Het aantal voorafgaande taken.

Foutdetails voor mislukte taken. Zie Fouten voor de volledige referentie van het task_error-object.

Het aantal credits dat door deze taak is verbruikt. Een taak die de status SUCCEEDED bereikt, wordt het volledige bedrag voor die fase in rekening gebracht. Een taak die nooit wordt aangemaakt (een 4xx bij het verzoek, inclusief een moderation-afwijzing) wordt helemaal niet in rekening gebracht. Een taak die FAILED bereikt, geeft 0 terug — het bedrag wordt terugbetaald. Annuleren via DELETE betaalt alleen terug zolang de taak nog PENDING is; een taak die al IN_PROGRESS is, blijft in rekening gebracht, omdat het werk al is uitgevoerd.

Downloadbare URL's voor de pixel-art-afbeelding die door deze prototypetaak is gegenereerd. Momenteel geeft de API altijd precies één afbeelding terug; het veld is een array zodat toekomstige revisies meerdere kandidaten kunnen tonen zonder een breaking change. Leeg totdat de taak de status SUCCEEDED bereikt.

Dit zijn ondertekende URL's: haal ze op zonder een Authorization-header. Ze blijven geldig tot expires_at, dat 3 dagen na finished_at valt, en het opnieuw uitlezen van de taak binnen dat venster geeft dezelfde URL terug in plaats van een nieuw ondertekende. Download en bewaar de bestanden zelf vóór die tijd — er is geen manier om een verlopen link te vernieuwen.

Unieke identifier voor de task.

Type van de task. De waarde is creative-lab-fidget-pixel-build.

De taaknaam die is opgegeven bij het aanmaken van de task. Lege string als er geen naam is opgegeven.

Status van de task. Mogelijke waarden zijn PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Progress van de task. Als de task nog niet is gestart, is deze eigenschap 0. Zodra de task is geslaagd, wordt dit 100.

Tijdstempel van wanneer de task is aangemaakt, in milliseconden.

Tijdstempel van wanneer de task is gestart, in milliseconden. null totdat de task start.

Tijdstempel van wanneer de task is voltooid, in milliseconden. null totdat de task voltooid is.

Tijdstempel van wanneer het taakresultaat verloopt, in milliseconden — 3 dagen nadat de task is voltooid. Enterprise-accounts bewaren API-resultaten onbeperkt (zie Asset-retentie); voor hen wordt deze tijdstempel ongeveer 100 jaar vooruit ingesteld.

Het aantal voorafgaande tasks. Alleen relevant wanneer de status PENDING is.

Foutdetails voor mislukte tasks. Zie Fouten voor de volledige referentie van het task_error-object.

Het aantal credits dat door deze task is verbruikt. Een task die SUCCEEDED bereikt, wordt het volledige bedrag voor die fase in rekening gebracht. Een task die nooit wordt aangemaakt (een 4xx bij het verzoek, inclusief een moderation-afwijzing) wordt helemaal niet in rekening gebracht. Een task die FAILED bereikt, geeft 0 terug — het bedrag wordt terugbetaald. Annuleren via DELETE betaalt alleen terug zolang de task nog PENDING is; een task die al IN_PROGRESS is, blijft in rekening gebracht, omdat het werk al is verricht.

Downloadbare URL's voor het gegenereerde asset, gesleuteld op formaat. Bevat precies één item — het formaat dat is opgegeven via output.format van het build-verzoek. Leeg totdat de task SUCCEEDED bereikt.

Dit zijn ondertekende URL's: haal ze op zonder een Authorization-header. Ze blijven geldig tot expires_at, wat 3 dagen na finished_at is, en het opnieuw uitlezen van de task binnen dat venster geeft dezelfde URL terug in plaats van een nieuw ondertekende. Download en bewaar de bestanden zelf vóór die tijd — er is geen manier om een verlopen link te vernieuwen.