Creative Lab — Vinylfigur API

Källfoto för Meshy att stilisera som en storhuvud-vinylfigur. Vi stöder för närvarande .jpg, .jpeg, .png och .webp format.

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

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

Valfritt uppgiftsnamn för visningsändamål. Max 100 tecken.

Förfrågan var oacceptabel. Vanliga orsaker:

• Saknad parameter: image_url krävs.
• Ogiltigt bildformat: Den angivna image_url är inte ett stödt format (.jpg, .jpeg, .png, .webp).
• Bilddimensioner utanför området: Bilden är för liten, överskrider maximal filstorlek, eller överskrider maximalt antal pixlar.
• Otillgänglig URL: image_url kunde inte laddas ned (404 eller timeout).
• Ogiltig Data URI: Base64-strängen är felaktigt formad.
• Innehållet flaggat: Ingångsbilden flaggades av NSFW eller immateriell rättighetsmoderation.

Autentisering misslyckades. Kontrollera din API-nyckel.

Otillräckliga credits för att utföra denna uppgift.

Du har överskridit din hastighetsgräns.

Uppgifts-ID för en prototypuppgift skapad via samma OpenAPI endpoint. Prototypen måste ha skapats med samma API-nyckel, måste ha nått SUCCEEDED och måste ha producerat exakt en kandidatbild.

Prototypuppgifter skapade via webappen accepteras inte — bygg-endpoint accepterar endast prototypuppgifter producerade av POST /openapi/creative-lab/vinyl-figure/v1/prototype och vägrar alla andra källor med 404.

Valfritt uppgiftsnamn för visningsändamål. Max 100 tecken.

Begäran var oacceptabel. Vanliga orsaker:

• Saknad parameter: input_task_id krävs.
• Ogiltig UUID: input_task_id är inte en giltig UUID.
• Förälder inte lyckad: Den refererade prototypuppgiften har inte nått SUCCEEDED än.
• Ingen kandidat: Prototypuppgiften lyckades men producerade ingen kandidatbild.

Autentisering misslyckades. Kontrollera din API-nyckel.

Otillräckliga credits för att utföra denna uppgift.

Den refererade prototypuppgiften existerar inte, tillhör en annan användare eller skapades genom webappen (endast API-mode prototypuppgifter kan kedja in i bygg).

Du har överskridit din hastighetsgräns.

Unikt identifierare för vinylfigur uppgiften som ska hämtas.

Unik identifierare för vinyl figure-uppgiften som ska avbrytas.

Uppgiften är redan i ett terminalt tillstånd och kan inte avbrytas.

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

Unikt identifierare för vinylfigur-uppgiften att strömma.

Antingen prototype eller build. Samlingen returnerar endast uppgifter vars steg matchar URL:en — hämtning av /prototype returnerar aldrig byggkeenden och vice versa.

Sidnummer för paginering.

Gräns för sidstorlek. Maximalt tillåtna är 50 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 implementeringsdetalj, bör du inte anta något om formatet på id.

Typ av uppgift. Värdet är creative-lab-vinyl-figure-prototype.

Det uppgiftsnamn som angavs när uppgiften skapades. Tom sträng om inget namn angavs.

Uppgiftens status. Möjliga värden är en av PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Uppgiftens framsteg. Om uppgiften inte har startat ännu, kommer denna egenskap att vara 0. När uppgiften har lyckats, kommer detta att bli 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 0.

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

Tidsstämpel för när uppgiftsresultatet upphör, i millisekunder.

Antalet tidigare uppgifter.

Feldetaljer för misslyckade uppgifter. Se Fel för hela task_error objektreferensen.

Antalet credits som förbrukats av denna uppgift. Detta visas när uppgiftsstatusen är PENDING, IN_PROGRESS eller SUCCEEDED. Returnerar 0 för FAILED uppgifter (credits återbetalas vid fel).

Nedladdningsbara URL:er för konceptbildkandidater genererade av denna prototypuppgift. För närvarande returnerar API:et alltid exakt en kandidat; fältet är en array så framtida versioner kan visa flera kandidater utan en brytande förändring.

Unik identifierare för uppgiften.

Typ av uppgift. Värdet är creative-lab-vinyl-figure-build.

Uppgiftsnamnet 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 framsteg. Om uppgiften ännu inte har startat kommer denna egenskap att vara 0. När uppgiften har lyckats blir detta 100.

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

Tidsstämpel för när uppgiften startades, i millisekunder.

Tidsstämpel för när uppgiften avslutades, i millisekunder.

Tidsstämpel för när uppgiftens resultat går ut, i millisekunder.

Antalet föregående uppgifter. Meningsfullt endast när status är PENDING.

Felformation för misslyckade uppgifter. Se Fel för fullständig task_error objektreferens.

Antal krediter som förbrukats av denna uppgift. Returnerar 0 för FAILED uppgifter (krediter återbetalas vid fel).

Alltid tomt för vinylfigurbyggnad. Närvarande för kompatibilitet mellan endpoint med den delade V2ImageTo3DTaskResponse strukturen som används av Bild till 3D.

Alltid tomt för vinylfigurbyggnad. Närvarande för kompatibilitet mellan endpoint.

Alltid tomt för vinylfigurbyggnad. Närvarande för kompatibilitet mellan endpoint.

Alltid tomt för vinylfigurbyggnad. Närvarande för kompatibilitet mellan endpoint.

Nedladdningsbara URL:er för den genererade 3D-modellen. Vinylfigurbyggnaden ger en texturerad GLB plus OBJ + MTL-paret för pipeline som föredrar Wavefront OBJ. Fältets form matchar Bild till 3D model_urls objektet så framtida formatläggningar kan ske utan brytande förändring.

Nedladdningsbar URL till miniatyrbilden av modellfilen.

En array av textur URL-objekt som genereras av denna uppgift. Innehåller för närvarande ett enda objekt med baskartans färg.