Creative Lab — Vinyl Figure API

Bronfoto die Meshy stileert als een big-head vinyl figuur. We ondersteunen momenteel de formaten .jpg, .jpeg, .png en .webp.

Er zijn twee manieren om de afbeelding aan te leveren:

• Publiek toegankelijke URL: Een URL die toegankelijk is vanaf het publieke internet.
• Data URI: Een base64-gecodeerde data URI van de afbeelding. Voorbeeld van een data URI: data:image/jpeg;base64,<your base64-encoded image data>.

Optionele taaknaam voor weergavedoeleinden. Maximaal 100 tekens.

Wanneer ingesteld op true, wordt de prototype-afbeelding geretourneerd als een transparante RGBA PNG met de achtergrond verwijderd, zodat je het onderwerp op elke achtergrond kunt samenstellen.

Het verzoek was onaanvaardbaar. Veelvoorkomende oorzaken:

• Ontbrekende parameter: image_url is verplicht.
• 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 gevormd.
• Content gemarkeerd: De invoerafbeelding is gemarkeerd door NSFW- of intellectuele-eigendom-moderation.

Authenticatie mislukt. Controleer je API-sleutel.

Onvoldoende credits om deze taak uit te voeren.

Je hebt je rate limit overschreden.

De taak-ID van een prototype-taak die via dit zelfde OpenAPI-endpoint is aangemaakt. Het prototype moet zijn aangemaakt met dezelfde API-sleutel, moet SUCCEEDED hebben bereikt en moet precies één kandidaatafbeelding hebben opgeleverd.

Prototype-taken die via de webapp zijn aangemaakt worden niet geaccepteerd — de build-endpoint accepteert alleen prototype-taken die zijn geproduceerd door POST /openapi/creative-lab/vinyl-figure/v1/prototype en wijst elke andere bron af met 404.

Optionele taaknaam voor weergavedoeleinden. Maximaal 100 tekens.

Het verzoek was onacceptabel. Veelvoorkomende oorzaken:

• Ontbrekende parameter: input_task_id is verplicht.
• Ongeldige UUID: De input_task_id is geen geldige UUID.
• Bovenliggende taak niet geslaagd: De verwezen prototype-taak heeft SUCCEEDED nog niet bereikt.
• Geen kandidaat: De prototype-taak is geslaagd, maar heeft geen kandidaatafbeelding opgeleverd.

Authenticatie is mislukt. Controleer je API-sleutel.

Onvoldoende credits om deze taak uit te voeren.

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

Je hebt je rate limit overschreden.

Unieke identificatie voor de op te halen vinyl figure-taak.

Unieke identificatie voor de vinyl figure-taak die geannuleerd moet worden.

De taak bevindt zich al in een eindtoestand 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 vinyl figure task om te streamen.

Ofwel prototype ofwel build. De verzameling geeft alleen taken terug waarvan de fase overeenkomt met de URL — het opvragen van /prototype geeft nooit build-taken terug en vice versa.

Paginanummer voor paginering.

Paginagroottelimiet. Maximaal toegestaan zijn 100 items.

Veld om op te sorteren. Beschikbare waarden:

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

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

Type van de task. De waarde is creative-lab-vinyl-figure-prototype.

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

Status van de task. Mogelijke waarden zijn een van 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. Als de task nog niet is gestart, is deze eigenschap 0.

Tijdstempel van wanneer de task is voltooid, in milliseconden. Als de task nog niet is voltooid, is deze eigenschap 0.

Tijdstempel van wanneer het taakresultaat verloopt, in milliseconden.

Het aantal voorafgaande tasks.

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

Het aantal credits dat door deze task is verbruikt. Aanwezig wanneer de taakstatus PENDING, IN_PROGRESS, of SUCCEEDED is. Geeft 0 terug voor FAILED-tasks (credits worden bij mislukking terugbetaald).

Downloadbare URL's voor de conceptafbeeldingkandidaten die door deze prototype-task zijn gegenereerd. Momenteel geeft de API altijd precies één kandidaat terug; het veld is een array zodat toekomstige revisies meerdere kandidaten kunnen aanbieden zonder een breaking change.

Unieke identifier voor de taak.

Type van de taak. De waarde is creative-lab-vinyl-figure-build.

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

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

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

Tijdstempel van wanneer de taak is voltooid, in milliseconden.

Tijdstempel van wanneer het resultaat van de taak verloopt, in milliseconden.

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

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

Het aantal credits dat door deze taak is verbruikt. Geeft 0 terug voor FAILED-taken (credits worden terugbetaald bij een mislukking).

Altijd leeg voor vinyl figure build. Aanwezig voor compatibiliteit tussen endpoints met de gedeelde V2ImageTo3DTaskResponse-vorm die wordt gebruikt door Afbeelding naar 3D.

Altijd leeg voor vinyl figure build. Aanwezig voor compatibiliteit tussen endpoints.

Altijd leeg voor vinyl figure build. Aanwezig voor compatibiliteit tussen endpoints.

Altijd leeg voor vinyl figure build. Aanwezig voor compatibiliteit tussen endpoints.

Downloadbare URL's voor het gegenereerde 3D-model. De vinyl figure build levert een getextureerde GLB plus het OBJ + MTL-paar voor pipelines die de voorkeur geven aan Wavefront OBJ. De vorm van dit veld komt overeen met het Image to 3D model_urls-object, zodat toekomstige formaattoevoegingen zonder breaking change kunnen worden ingepast.

Downloadbare URL naar de thumbnail-afbeelding van het modelbestand.

Een array van texture-URL-objecten die door deze taak zijn gegenereerd. Bevat momenteel een enkel object met de basiskleurenkaart.