Creative Lab Collapsible Fidget API

De foto die omgezet moet worden in een inklapbare fidget, als een publieke URL of een data-URI (data:image/jpeg;base64,<je in base64 gecodeerde afbeeldingsgegevens>).

De afbeelding moet een JPG-, JPEG-, PNG- of WebP-bestand van maximaal 20 MB zijn.

De silhouet van het onderwerp wordt de ringen, dus een onderwerp met één duidelijke, gesloten omtrek werkt het beste. Een drukke achtergrond, meerdere afzonderlijke onderwerpen of zeer dunne vormen kunnen te weinig ruimte overlaten voor de geneste wanden. In dat geval mislukt de taak.

Een naam voor de taak, tot 100 tekens. Deze komt terug in het name-veld van de taak, en Meshy graveert deze niet op het model. Een langere naam resulteert in 400.

Het verzoek kan niet worden uitgevoerd. Bijvoorbeeld:

• image_url ontbreekt.
• De afbeelding is geen JPG-, JPEG-, PNG- of WebP-bestand.
• De afbeelding is te klein, groter dan 20 MB, of overschrijdt het maximale aantal pixels.
• Meshy kan de afbeelding niet downloaden, bijvoorbeeld omdat de URL 404 teruggeeft of time-out geeft.
• De data-URI is geen geldige base64.
• De afbeelding is gemarkeerd als NSFW.

Het foutbericht geeft aan welk probleem er is gevonden. Corrigeer het verzoek en stuur het opnieuw.

De API-sleutel ontbreekt of is ongeldig. Controleer de Authorization-header.

Een van de volgende situaties is van toepassing:

• Het account heeft niet genoeg credits.
• De API-sleutel, werkruimte of het lid heeft het creditlimiet bereikt.
• Het account gebruikt het gratis abonnement.

Controleer je credits en abonnement en probeer het opnieuw.

Je team heeft IP Filtering ingeschakeld, en Meshy heeft de afbeelding gemarkeerd vanwege intellectueel eigendom van derden. Stuur een afbeelding waarvoor je gebruiksrechten hebt.

Een van deze limieten is bereikt:

• Je hebt meer verzoeken verstuurd dan je rate limit toestaat. Wacht een paar seconden en probeer het opnieuw. Zie Rate limits.
• Er staan te veel van je taken in de wachtrij of lopen er te veel. Wacht tot er een aantal zijn voltooid en probeer het opnieuw.
• Bij een onbeperkt abonnement zonder resterende credits heb je het aantal taken bereikt dat zonder credits kan worden uitgevoerd. Wacht tot een taak is voltooid, of voeg credits toe.

Meshy is op een serverfout gestuit, bijvoorbeeld omdat de intellectueel-eigendomscontrole op de afbeelding niet kon worden uitgevoerd. Meshy maakt de taak niet aan en vergoedt eventuele in rekening gebrachte credits. Probeer het verzoek opnieuw.

Het taak-ID uit het antwoord van het aanmaken.

id is geen geldig taak-ID. Stuur het result-ID uit het antwoord van het aanmaken.

Je team heeft IP Filtering ingeschakeld, en Meshy heeft de afbeelding van de taak gemarkeerd wegens intellectueel eigendom van derden. Teams met het Enterprise-abonnement krijgen deze fout niet. Maak een taak aan met een afbeelding waarvoor je gebruiksrechten hebt.

Er is geen Collapsible Fidget-taak met dit ID die bij jouw account hoort, of de taak is niet met deze endpoint aangemaakt. Controleer het ID.

Meshy kon de controle op intellectueel eigendom niet uitvoeren. Probeer het verzoek opnieuw.

De ID van de te annuleren taak.

Een van de volgende situaties is van toepassing:

• id is geen geldige taak-ID. Stuur de result-ID uit het aanmaakverzoek-antwoord.
• De taak heeft al een definitieve status (SUCCEEDED, FAILED of CANCELED), waardoor deze niet kan worden geannuleerd.

Er bestaat geen Collapsible Fidget-taak met deze ID binnen jouw account, of de taak is niet aangemaakt met deze endpoint. Controleer de ID.

De taak-ID uit de create-respons.

De pagina die moet worden geretourneerd, van 1 tot 255. 0 retourneert de eerste pagina. Een waarde buiten 0 tot 255 retourneert 400.

Aantal taken per pagina, tot 100. Een waarde van 101 tot 255 retourneert 100 taken, en 0 gebruikt de standaardwaarde. Een waarde buiten 0 tot 255 retourneert 400.

De sorteervolgorde.

Beschikbare waarden:

• -created_at: nieuwste eerst
• +created_at: oudste eerst

De taak-ID. Vertrouw niet op het formaat ervan.

Het taaktype, altijd creative-lab-fidget-collapsible.

De name die je opgaf toen je de taak aanmaakte, of "" als je er geen hebt opgegeven.

De status van de taak.

Beschikbare waarden:

• PENDING: wacht in de wachtrij
• IN_PROGRESS: genereert het resultaat
• SUCCEEDED: definitief, met het resultaat
• FAILED: definitief, met de reden in task_error
• CANCELED: definitief, zonder resultaat

Percentage van het voltooide werk, van 0 tot 100. Het is 0 totdat de taak start en 100 wanneer deze slaagt.

Tijdstip waarop de taak is aangemaakt, in Unix-milliseconden.

Tijdstip waarop een worker de taak heeft gestart, in Unix-milliseconden. null tot dan.

Tijdstip waarop de taak een definitieve status heeft bereikt, in Unix-milliseconden. null tot dan.

Tijdstip waarop het resultaat van de taak verloopt, in Unix-milliseconden. Dit is 3 dagen na finished_at, of 3 dagen na created_at totdat de taak voltooid is. Voor Enterprise-accounts, die API-resultaten onbeperkt bewaren, is dit ongeveer 100 jaar later. Zie Asset-retentie.

De positie van de taak in de wachtrij terwijl deze PENDING is. 1 betekent dat deze als volgende start. 0 nadat de taak de wachtrij heeft verlaten, en altijd 0 in lijstresultaten.

Waarom de taak is mislukt. null tenzij status gelijk is aan FAILED. Zie Fouten.

Aantal credits dat voor de taak in rekening is gebracht, na eventuele terugbetaling. Een verzoek dat een fout retourneert, wordt niet in rekening gebracht. Een mislukte taak is 0, omdat Meshy deze terugbetaalt. Annuleren betaalt een taak alleen terug terwijl deze PENDING is. Als Meshy de kosten niet kan uitlezen, laat een get- of stream-respons het veld weg, en retourneert een lijstverzoek 500. Probeer het verzoek in dat geval opnieuw.

Download-URL's voor het 3D-model, leeg totdat de taak slaagt. Een geslaagde taak heeft altijd stl, en heeft alleen glb als Meshy de voorvertoning heeft gerenderd.