Tekst na 3D API

To pole powinno mieć wartość „preview” podczas tworzenia zadania podglądu.

Opisz, jaki obiekt reprezentuje model 3D. Maksymalnie 800 znaków.

Określa typ generowania siatki 3D.

Dostępne wartości:

• standard: Standardowe generowanie siatki 3D o wysokiej szczegółowości.
• smart-topology: Wybierz model Smart Topology za pomocą ai_model (meshy-t2).
• lowpoly (przestarzałe): Generuje siatkę low-poly zoptymalizowaną pod kątem czystszych wielokątów. Zalecamy używanie smart-topology.

ID modelu, który ma zostać użyty. Dostępne wartości zależą od model_type.

Generowanie standardowe (model_type: standard):

• meshy-6-lite, meshy-6, meshy-7.1, latest (Meshy 7.1)
• meshy-7 (przestarzałe): użyj meshy-7.1 zamiast tej wartości.

Generowanie Smart Topology (model_type: smart-topology):

• meshy-t2 (domyślnie): model Smart Topology — czystsza topology, natywnie oddzielone części, wynik w postaci trójkątów oraz liczba ścianek, którą można ustawić za pomocą target_polycount.

Przebieg generowania geometrii. 2k uruchamia przebieg Ultra przy 2048³; 4k uruchamia go przy 4096³ dla najlepszej szczegółowości powierzchni.

Dostępne wartości: standard, 2k, 4k

Użyj geometry_resolution zamiast tego parametru. ultra_mode: true jest równoważne geometry_resolution: "2k".

Określa, czy włączyć fazę remesh. W przypadku modelu o najwyższej jakości zalecamy ustawienie should_remesh na false.

Docelowa liczba wielokątów (ścianek) w wyniku. Rzeczywista liczba może odbiegać od wartości docelowej w zależności od geometrii.

target_polycount ma zastosowanie w dwóch niezależnych przypadkach:

• Remesh — z should_remesh: true w modelu standard. Siatka zostaje poddana remesh (decymacji) do wartości zbliżonej do tej liczby. Zakres od 100 do 300 000, wartość domyślna 30 000. Jeśli ustawiono decimation_mode, ma on priorytet, a target_polycount jest ignorowany.
• Smart Topology — z model_type: smart-topology i ai_model: meshy-t2. Model jest generowany bezpośrednio z tą liczbą ścianek; remesh nie jest wykonywany, a should_remesh nie jest wymagany. Zakres od 100 do 15 000, wartość domyślna 4 000.

Przestarzałe. Ten parametr nie ma już wpływu na wynik.

Pole symmetry_mode kontroluje zachowanie symetrii w procesie generowania modelu.

Dostępne wartości:

• off: Wyłącza symetrię.
• auto: Automatycznie określa i stosuje symetrię na podstawie geometrii wejściowej.
• on: Wymusza symetrię podczas generowania.

Określa pose_mode dla generowanego modelu.

Dostępne wartości:

• a-pose: Generuje model w pozycji A.
• t-pose: Generuje model w pozycji T.
• "" (pusty ciąg): Nie stosuje żadnej konkretnej pozycji.

Użyj pose_mode zamiast tego parametru. Określa, czy generować model w pozycji A/T.

Nieobsługiwane przez Meshy-6. Żądania korzystające z Meshy-6 zignorują art_style, a niektóre kombinacje mogą powodować błędy. Dostępne wartości: realistic, sculpture.

Gdy ustawione na true, treść wejściowa zostanie automatycznie sprawdzona pod kątem potencjalnie szkodliwej zawartości. Jeśli zostanie wykryta szkodliwa treść, zadanie nie przejdzie do etapu generowania.

Sprawdzana będzie treść pola prompt.

Określa, które formaty plików 3D mają być zawarte w wyniku. Zostaną wygenerowane i zwrócone tylko żądane formaty, co może zmniejszyć czas realizacji zadania. Gdy pole jest pominięte, uwzględniane są wszystkie obsługiwane formaty.

Dostępne wartości: glb, obj, fbx, stl, usdz, 3mf

Gdy ustawione na true, zadanie dodatkowo renderuje wersję podglądu z przezroczystym tłem (RGBA) i zwraca ją jako alpha_thumbnail_url w odpowiedzi GET. Istniejące pole thumbnail_url pozostaje niezmienione.

Gdy ustawione na true, usługa wykorzystuje wizję AI do automatycznego oszacowania rzeczywistej wysokości obiektu i odpowiedniego zmienienia rozmiaru modelu. Punkt początkowy domyślnie będzie ustawiony na bottom, o ile origin_at nie zostanie jawnie ustawiony.

Żądanie było niepoprawne. Częste przyczyny:

• Brakujący parametr: Wymagany parametr (np. prompt, mode) jest brakujący.
• Nieprawidłowy parametr: art_style nie jest jedną z dozwolonych wartości.
• Prompt zbyt długi: prompt przekracza limit znaków.
• Nieobsługiwany model dla low poly: ai_model: "meshy-6-lite" nie obsługuje model_type: "lowpoly".
• Nieobsługiwany model dla Ultra: geometry_resolution wymaga meshy-7.1 lub latest.

Uwierzytelnianie nie powiodło się. Sprawdź swój klucz API.

Niewystarczająca liczba kredytów do wykonania tego zadania.

Przekroczono limit szybkości.

To pole powinno być ustawione na "refine" podczas tworzenia zadania refine.

Odpowiadające id zadania preview.

Status podanego zadania preview musi być SUCCEEDED.

Generuje mapy PBR (metallic, roughness, normal) oprócz podstawowego koloru. Mapa emisji jest również dołączana, gdy ai_model to meshy-6, z wyjątkiem texture_resolution: 8k (mapa emisji nie jest wtedy generowana). meshy-6-lite, meshy-7.1 i latest nie generują mapy emisji.

Rozdzielczość tekstury podstawowego koloru. Jedna z: 2k (2048×2048), 4k (4096×4096) lub 8k (8192×8192). Wyższe rozdzielczości pozwalają uchwycić więcej szczegółów powierzchni. Ma zastosowanie tylko w mode refine.

Użyj texture_resolution — jest to równoważne texture_resolution: "4k". Gdy ustawiono oba parametry, texture_resolution ma pierwszeństwo.

Podaj dodatkowy prompt tekstowy, aby ukierunkować proces teksturowania. Maksymalnie 800 znaków.

Podaj obraz 2D, aby ukierunkować proces teksturowania. Obecnie wspieramy formaty .jpg, .jpeg i .png.

Istnieją dwa sposoby podania obrazu:

• Publicznie dostępny URL: URL dostępny z publicznego internetu
• Data URI: Zakodowany w base64 data URI obrazu. Przykład data URI: data:image/jpeg;base64,<your base64-encoded image data>

ID modelu używanego do refine.

Dostępne wartości:

• meshy-6-lite, meshy-6, meshy-7.1, latest (Meshy 7.1)
• meshy-7 (przestarzałe): użyj meshy-7.1 zamiast tego.

Pomiń ten parametr, aby dziedziczyć model użyty przez zadanie preview, co zapewnia, że preview i jego refine korzystają z tego samego modelu od początku do końca. Podaj wartość jawnie, aby zastąpić to dziedziczenie.

Gdy ustawione na true, treść wejściowa zostanie automatycznie przeskanowana pod kątem potencjalnie szkodliwej treści. Jeśli wykryto szkodliwą treść, zadanie nie przejdzie do etapu generowania.

Skanowany będzie zarówno tekst z texture_prompt, jak i obraz z texture_image_url.

Usuwa światła i cienie z tekstury podstawowego koloru, tworząc czystszy rezultat, który lepiej działa w niestandardowych konfiguracjach oświetlenia.

Określa, które formaty plików 3D mają zostać uwzględnione w wyniku. Zostaną wygenerowane i zwrócone tylko żądane formaty, co może zmniejszyć czas zakończenia zadania. Gdy pominięte, uwzględniane są wszystkie wspierane formaty.

Dostępne wartości: glb, obj, fbx, stl, usdz, 3mf

Gdy ustawione na true, zadanie dodatkowo renderuje wersję preview z przezroczystym tłem (RGBA) i zwraca ją jako alpha_thumbnail_url w odpowiedzi GET. Istniejące pole thumbnail_url pozostaje bez zmian.

Gdy ustawione na true, usługa wykorzystuje wizję AI do automatycznego oszacowania rzeczywistej wysokości obiektu i odpowiedniego przeskalowania modelu. Punkt początkowy domyślnie ustawiony jest na bottom, o ile origin_at nie zostanie wyraźnie określony.

Żądanie było niepoprawne. Typowe przyczyny:

• Nieprawidłowy identyfikator zadania: preview_task_id jest nieprawidłowy lub nie istnieje.
• Zadanie nie jest gotowe: Zadanie preview jeszcze nie zakończyło się powodzeniem.
• Niezgodność modelu: Model AI zadania preview jest niekompatybilny z żądanym modelem refine.

Uwierzytelnianie nie powiodło się. Sprawdź swój klucz API.

Niewystarczająca liczba kredytów do wykonania tego zadania.

Zadanie preview określone przez preview_task_id nie zostało znalezione.

Przekroczono limit szybkości.

Unikalny identyfikator zadania Tekst na 3D do pobrania.

ID zadania Tekst na 3D do usunięcia.

Numer strony do stronicowania.

Limit rozmiaru strony. Maksymalna dozwolona wartość to 100 elementów.

Pole, według którego ma nastąpić sortowanie.

Dostępne wartości:

• +created_at: Sortowanie według czasu utworzenia rosnąco.
• -created_at: Sortowanie według czasu utworzenia malejąco.

Unikalny identyfikator zadania Tekst na 3D, które ma być przesyłane strumieniowo.

Unikalny identyfikator zadania. Chociaż jako szczegół implementacyjny używamy identyfikatorów zadań w formacie UUID z sortowaniem k, nie należy zakładać niczego na temat formatu identyfikatora.

Typ zadania Tekst na 3D. Możliwe wartości to text-to-3d-preview dla zadań etapu preview oraz text-to-3d-refine dla zadań etapu refine.

Adres URL do pobrania pliku teksturowanego modelu 3D wygenerowanego przez Meshy. Właściwość dla danego formatu zostanie pominięta, jeśli format nie został wygenerowany, zamiast zwracać pusty ciąg znaków.

To jest niezmodyfikowany prompt, który został użyty do utworzenia zadania.

Utrzymywane dla zachowania zgodności wstecznej. To pole nie ma żadnego wpływu funkcjonalnego na generowane modele.

Niezmodyfikowany art_style, który został użyty do utworzenia zadania etapu preview. Nieobsługiwane przez Meshy-6.

Utrzymywane dla zachowania zgodności wstecznej. To pole nie ma żadnego wpływu funkcjonalnego na generowane modele.

Dodatkowy prompt tekstowy dostarczony w celu ukierunkowania procesu teksturowania podczas etapu refine.

Przestarzałe; zamiast tego odczytuj geometry_resolution.

Poziom Ultra, w którym uruchomiono zadanie preview (2k lub 4k); pomijane dla standard.

Adres URL do pobrania obrazu tekstury, który został użyty do ukierunkowania procesu teksturowania.

Adres URL do pobrania miniatury pliku modelu.

Adres URL do pobrania wersji thumbnail_url z przezroczystym tłem (RGBA). Obecny tylko wtedy, gdy zadanie zostało utworzone z alpha_thumbnail: true, a podgląd z przezroczystością został pomyślnie wyrenderowany; w przeciwnym razie to pole jest pomijane.

Adres URL do pobrania wideo podglądowego. Zostanie usunięty w przyszłej wersji.

Postęp zadania. Jeśli zadanie jeszcze się nie rozpoczęło, ta właściwość będzie miała wartość 0. Gdy zadanie zakończy się powodzeniem, wartość ta zmieni się na 100.

Znacznik czasu wskazujący, kiedy zadanie zostało rozpoczęte, w milisekundach. Jeśli zadanie jeszcze się nie rozpoczęło, ta właściwość będzie miała wartość 0.

Znacznik czasu wskazujący, kiedy zadanie zostało utworzone, w milisekundach.

Znacznik czasu wskazujący, kiedy zadanie zostało zakończone, w milisekundach. Jeśli zadanie jeszcze się nie zakończyło, ta właściwość będzie miała wartość 0.

Status zadania. Możliwe wartości to jedna z: PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Tablica obiektów adresów URL tekstur wygenerowanych z zadania. Zazwyczaj zawiera ona tylko jeden obiekt adresu URL tekstury. Każdy adres URL tekstury posiada następujące właściwości:

Liczba poprzedzających zadań.

Szczegóły błędu dla nieudanych zadań. Zobacz Błędy, aby uzyskać pełną specyfikację obiektu task_error.

Liczba kredytów zużytych przez to zadanie. Obecna, gdy status zadania to PENDING, IN_PROGRESS lub SUCCEEDED. Zwraca 0 dla zadań FAILED (kredyty są zwracane w przypadku niepowodzenia).