Creative Lab API pro vinylové figurky

Fotografie, která se má přeměnit na vinylovou figurku s velkou hlavou, jako veřejná URL adresa nebo data URI (data:image/jpeg;base64,<vaše data obrázku zakódovaná v base64>).

Obrázek musí být soubor JPG, JPEG, PNG nebo WebP o velikosti maximálně 20 MB.

Název úkolu, maximálně 100 znaků. Vrací se v poli name úkolu. Delší název vrátí 400.

Zda odstranit pozadí z prototypového obrázku. true vrátí průhledný RGBA PNG, takže subjekt můžete umístit na libovolné pozadí. Build také začíná z obrázku bez pozadí. Pokud Meshy nedokáže pozadí odstranit, vrátí obrázek s pozadím a úkol je přesto úspěšný.

Požadavek nelze spustit. Například:

• Chybí image_url.
• Obrázek není soubor JPG, JPEG, PNG ani WebP.
• Obrázek je příliš malý, přesahuje 20 MB nebo přesahuje maximální počet pixelů.
• Meshy nemůže obrázek stáhnout, například protože URL vrací 404 nebo vyprší časový limit.
• Data URI není platný base64.
• Obrázek byl označen jako NSFW.

Chybová zpráva uvádí, jaký problém byl nalezen. Opravte požadavek a odešlete jej znovu.

Chybí API klíč nebo je neplatný. Zkontrolujte hlavičku Authorization.

Platí jedno z následujícího:

• Účet nemá dostatek kreditů.
• API klíč, pracovní prostor nebo člen dosáhl svého limitu kreditů.
• Účet je na bezplatném plánu.

Zkontrolujte své kredity a plán a zkuste to znovu.

Váš tým má zapnuté IP Filtering a Meshy obrázek označilo kvůli duševnímu vlastnictví třetí strany. Odešlete obrázek, ke kterému máte práva.

Byl dosažen jeden z těchto limitů:

• Odeslali jste více požadavků, než povoluje váš limit rychlosti. Počkejte několik sekund a zkuste to znovu. Viz Limity rychlosti.
• Příliš mnoho vašich úkolů čeká ve frontě nebo běží. Počkejte, až se některé z nich dokončí, a zkuste to znovu.
• V neomezeném plánu bez zbývajících kreditů jste dosáhli počtu úkolů, které mohou běžet bez kreditů. Počkejte na dokončení úkolu nebo přidejte kredity.

Meshy narazilo na chybu serveru, například proto, že nemohlo u obrázku provést kontrolu duševního vlastnictví. Meshy úkol nevytvoří a vrátí veškeré účtované kredity. Zkuste požadavek odeslat znovu.

ID úlohy prototypu, která se má sestavit. Musí jít o úlohu vytvořenou vaším účtem pomocí POST /openapi/creative-lab/vinyl-figure/v1/prototype se stavem SUCCEEDED.

ID, které neodpovídá žádné z vašich úloh prototypu Vinyl Figure z API, vrátí 404, včetně prototypu vytvořeného ve webové aplikaci.

Název úlohy, maximálně 100 znaků. Vrací se zpět v poli name dané úlohy. Delší název vrátí 400.

Požadavek nelze provést. Například:

• input_task_id chybí nebo neobsahuje platné ID úlohy.
• Stav úlohy prototypu není SUCCEEDED. Pokud ještě běží, počkejte a zkuste to znovu. Pokud selhala nebo byla zrušena, vytvořte novou úlohu prototypu.
• Úloha prototypu byla úspěšná, ale neobsahuje žádný obrázek. Vytvořte novou úlohu prototypu.

Chybová zpráva uvádí, jaký problém byl zjištěn.

Chybí nebo je neplatný API klíč. Zkontrolujte hlavičku Authorization.

Platí jedno z následujícího:

• Účet nemá dostatek kreditů.
• API klíč, pracovní prostor nebo člen dosáhl svého limitu kreditů.
• Účet používá bezplatný plán.

Zkontrolujte své kredity a plán a zkuste to znovu.

input_task_id neodpovídá žádné úloze prototypu Vinyl Figure vytvořené vaším účtem přes API. Prototyp vytvořený ve webové aplikaci rovněž vrátí 404. Odešlete ID result z odpovědi na vytvoření prototypu.

Byl dosažen jeden z těchto limitů:

• Odeslali jste více požadavků, než povoluje váš limit rychlosti. Počkejte několik sekund a zkuste to znovu. Viz Limity rychlosti.
• Příliš mnoho vašich úloh je zařazeno do fronty nebo probíhá. Počkejte, až se některé dokončí, a zkuste to znovu.
• Pokud máte neomezený plán bez zbývajících kreditů, dosáhli jste počtu úloh, které lze spustit bez kreditů. Počkejte na dokončení úlohy nebo přidejte kredity.

ID úlohy z odpovědi při vytvoření.

id není platné ID úlohy. Odešlete ID result z odpovědi při vytvoření.

Váš tým má zapnuté IP Filtering a Meshy označilo obrázek úlohy jako obsahující duševní vlastnictví třetí strany. Týmy v plánu Enterprise tuto chybu nedostávají. Vytvořte úlohu prototypu z obrázku, ke kterému máte práva k použití.

Vašemu účtu nepatří žádná úloha Vinyl Figure s tímto ID, nebo fáze úlohy neodpovídá cestě. Zkontrolujte ID a použijte /prototype nebo /build tak, aby odpovídalo úloze.

Meshy nemohlo provést kontrolu duševního vlastnictví. Zopakujte požadavek.

ID úlohy, kterou chcete zrušit.

Platí jedna z těchto možností:

• id není platné ID úlohy. Odešlete ID result z odpovědi na vytvoření.
• Úloha už má konečný stav (SUCCEEDED, FAILED nebo CANCELED), takže ji nelze zrušit.

Úloha Vinyl Figure s tímto ID nepatří k vašemu účtu, nebo fáze úlohy neodpovídá cestě. Zkontrolujte ID a použijte /prototype nebo /build tak, aby odpovídalo úloze.

ID úkolu z odpovědi vytvoření.

Fáze, kterou chcete vypsat, prototype nebo build.

Stránka, která se má vrátit, od 1 do 255. 0 vrátí první stránku. Hodnota mimo rozsah 0 až 255 vrátí 400.

Počet úkolů na stránku, maximálně 100. Hodnota od 101 do 255 vrátí 100 úkolů a 0 použije výchozí hodnotu. Hodnota mimo rozsah 0 až 255 vrátí 400.

Pořadí řazení.

Dostupné hodnoty:

• -created_at: nejnovější jako první
• +created_at: nejstarší jako první

ID úkolu. Nespoléhejte se na jeho formát.

Typ úkolu, vždy creative-lab-vinyl-figure-prototype.

name, který jste odeslali při vytváření úkolu, nebo "", pokud jste žádný neodeslali.

Stav úkolu.

Dostupné hodnoty:

• PENDING: čeká ve frontě
• IN_PROGRESS: generuje se výsledek
• SUCCEEDED: konečný stav, s výsledkem
• FAILED: konečný stav, s důvodem v task_error
• CANCELED: konečný stav, bez výsledku

Procento dokončené práce, od 0 do 100. Je 0, dokud úkol nezačne, a 100, když je úspěšný.

Čas vytvoření úkolu, v milisekundách unixového času.

Čas, kdy worker úkol zahájil, v milisekundách unixového času. Do té doby null.

Čas, kdy úkol dosáhl konečného stavu, v milisekundách unixového času. Do té doby null.

Čas, kdy vyprší platnost výsledku úkolu, v milisekundách unixového času. Je to 3 dny po finished_at, nebo 3 dny po created_at, dokud úkol neskončí. U podnikových (Enterprise) účtů, které uchovávají výsledky API neomezeně dlouho, je to přibližně o 100 let později. Viz Uchování assetů.

Pozice úkolu ve frontě, dokud je PENDING. 1 znamená, že začne jako další. 0 poté, co úkol opustí frontu, a vždy 0 ve výsledcích seznamu.

Důvod selhání úkolu. null, pokud status není FAILED. Viz Chyby.

Počet kreditů účtovaných za úkol, po případném vrácení. Požadavek, který vrátí chybu, se neúčtuje. U neúspěšného úkolu je to 0, protože Meshy jej vrátí. Zrušení vrátí kredity za úkol pouze tehdy, pokud je ve stavu PENDING. Pokud Meshy nedokáže zjistit účtovanou částku, odpověď typu get nebo stream toto pole vynechá a požadavek na seznam vrátí 500. V takovém případě požadavek zopakujte.

Adresy URL ke stažení koncepčního obrázku. Pole obsahuje jednu adresu URL po úspěšném dokončení úkolu, do té doby je prázdné.

ID úlohy. Nespoléhejte se na jeho formát.

Typ úlohy, vždy creative-lab-vinyl-figure-build.

name, který jste odeslali při vytváření úlohy, nebo "", pokud jste žádný neodeslali.

Stav úlohy.

Dostupné hodnoty:

• PENDING: čeká ve frontě
• IN_PROGRESS: generuje výsledek
• SUCCEEDED: konečný stav, s výsledkem
• FAILED: konečný stav, s důvodem v task_error
• CANCELED: konečný stav, bez výsledku

Procento dokončené práce, od 0 do 100. Je 0, dokud úloha nezačne, a 100, když uspěje.

Čas vytvoření úlohy, v milisekundách Unix.

Čas, kdy worker úlohu zahájil, v milisekundách Unix. Do té doby null.

Čas, kdy úloha dosáhla konečného stavu, v milisekundách Unix. Do té doby null.

Čas, kdy vyprší platnost výsledku úlohy, v milisekundách Unix. Je to 3 dny po finished_at, nebo 3 dny po created_at, dokud úloha neskončí. U podnikových (Enterprise) účtů, které uchovávají výsledky API neomezeně dlouho, je to přibližně o 100 let později. Viz Uchování assetů.

Pozice úlohy ve frontě, dokud je PENDING. 1 znamená, že se spustí jako další. 0 poté, co úloha opustí frontu, a vždy 0 ve výsledcích seznamu.

Důvod selhání úlohy. null, pokud status není FAILED. Viz Chyby.

Počet kreditů účtovaných za úlohu, po případném vrácení. Požadavek, který vrátí chybu, se neúčtuje. Neúspěšná úloha má hodnotu 0, protože Meshy ji vrací zpět. Zrušení vrací kredity za úlohu pouze tehdy, pokud je ve stavu PENDING. Pokud Meshy nemůže přečíst účtovanou částku, odpověď na get nebo stream toto pole vynechá a požadavek na seznam vrátí 500. V takovém případě požadavek zopakujte.

U úlohy sestavení Vinyl figurky vždy "".

U úlohy sestavení Vinyl figurky vždy "", stejně jako prompt.

U úlohy sestavení Vinyl figurky vždy "", stejně jako prompt.

U úlohy sestavení Vinyl figurky vždy "", stejně jako prompt.

URL ke stažení 3D modelu, jako texturovaný GLB a jako soubor OBJ s jeho souborem MTL.

URL ke stažení náhledového obrázku modelu.

Textury, jako pole s jedním objektem, který obsahuje mapu základní barvy.