API Tekst na 3D

To pole powinno być ustawione na "preview" podczas tworzenia zadania podglądu.

Opisz, jakiego rodzaju obiektem jest model 3D. Maksymalnie 600 znaków.

Określ typ generowania siatki 3D.

Dostępne wartości:

• standard: Zwykłe generowanie siatki 3D o wysokim poziomie szczegółowości.
• lowpoly: Generuje siatkę low-poly zoptymalizowaną pod kątem czystszych wielokątów.

ID modelu do użycia. Dostępne wartości: meshy-5, meshy-6, latest (Meshy 6).

Kontroluje, czy włączyć fazę Remesh. Po ustawieniu na false API bezpośrednio zwróci trójkątną siatkę o najwyższej precyzji.

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

Pole symmetry_mode kontroluje zachowanie symetrii podczas procesu generowania modelu.

Prawidłowe wartości to:

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

Określ pose_mode dla wygenerowanego modelu.

Dostępne wartości:

• a-pose: Generuje model w pozie A.
• t-pose: Generuje model w pozie T.
• "" (pusty ciąg): Nie zastosowano konkretnej pozy.

Zamiast tego użyj pose_mode. Określa, czy wygenerować model w pozie A/T.

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

Po ustawieniu na true treść wejściowa zostanie automatycznie sprawdzona pod kątem potencjalnie szkodliwych treści. Jeśli zostaną wykryte szkodliwe treści, zadanie nie przejdzie do generowania.

Tekst z prompt zostanie sprawdzony.

Określa, które formaty plików 3D uwzględnić w wyniku. Wygenerowane i zwrócone zostaną tylko żądane formaty, co może skrócić czas ukończenia zadania. Jeśli pominięto, uwzględniane są wszystkie obsługiwane formaty.

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

Po ustawieniu 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 bez zmian.

Po ustawieniu na true usługa używa widzenia AI do automatycznego oszacowania rzeczywistej wysokości obiektu i odpowiedniego zmienienia rozmiaru modelu. Punkt początkowy domyślnie będzie ustawiony na bottom, chyba że origin_at zostanie jawnie ustawione.

Żądanie było nieakceptowalne. Typowe przyczyny:

• Brakujący parametr: Brakuje wymaganego parametru (np. prompt, mode).
• Nieprawidłowy parametr: art_style nie jest jedną z dozwolonych wartości.
• Zbyt długi prompt: prompt przekracza limit znaków.

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

Niewystarczające kredyty do wykonania tego zadania.

Przekroczono limit szybkości.

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

ID odpowiadającego zadania podglądu.

Status podanego zadania podglądu musi być SUCCEEDED.

Generuj mapy PBR (metaliczność, chropowatość, normalna) oprócz koloru bazowego. Mapa emisji jest również dołączana, gdy ai_model to meshy-6 lub latest.

Generuj teksturę koloru bazowego w rozdzielczości 4K (4096×4096), aby uzyskać większą szczegółowość.

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

Podaj obraz 2D, aby ukierunkować proces teksturowania. Obecnie obsługujemy 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 dopracowania. Dostępne wartości: meshy-5, meshy-6, latest (Meshy 6).

Po ustawieniu na true treści wejściowe będą automatycznie sprawdzane pod kątem potencjalnie szkodliwej zawartości. Jeśli zostanie wykryta szkodliwa zawartość, zadanie nie przejdzie do generowania.

Sprawdzane będą zarówno tekst z texture_prompt, jak i obraz z texture_image_url.

Usuwa rozświetlenia i cienie z tekstury koloru bazowego, tworząc czystszy wynik, który działa lepiej przy niestandardowych konfiguracjach oświetlenia.

Określa, które formaty plików 3D uwzględnić w danych wyjściowych. Wygenerowane i zwrócone zostaną tylko żądane formaty, co może skrócić czas ukończenia zadania. Gdy pominięte, uwzględniane są wszystkie obsługiwane formaty.

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

Po ustawieniu 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 bez zmian.

Po ustawieniu na true usługa używa wizji AI do automatycznego oszacowania rzeczywistej wysokości obiektu i odpowiedniego zmienienia rozmiaru modelu. Punkt początkowy będzie domyślnie ustawiony na bottom, chyba że origin_at zostanie jawnie ustawiony.

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

• Nieprawidłowy ID zadania: preview_task_id jest nieprawidłowy lub nie istnieje.
• Zadanie nie jest gotowe: Zadanie podglądu nie zakończyło się jeszcze powodzeniem.
• Niezgodność modelu: Model AI zadania podglądu jest niezgodny z żądanym modelem dopracowania.

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

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

Nie znaleziono zadania podglądu określonego przez preview_task_id.

Przekroczono limit szybkości.

Unikalny identyfikator zadania Tekst na 3D do pobrania.

Identyfikator zadania Tekst na 3D do usunięcia.

Numer strony dla stronicowania.

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

Pole, według którego sortować.

Dostępne wartości:

• +created_at: Sortuj według czasu utworzenia w kolejności rosnącej.
• -created_at: Sortuj według czasu utworzenia w kolejności malejącej.

Unikalny identyfikator zadania Tekst na 3D do strumieniowania.

Unikalny identyfikator zadania. Chociaż jako szczegół implementacyjny używamy identyfikatora UUID sortowalnego k dla identyfikatorów zadań, nie należy przyjmować żadnych założeń dotyczących formatu identyfikatora.

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

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

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

Utrzymywane w celu zachowania zgodności wstecznej. To pole nie ma wpływu funkcjonalnego na wygenerowane modele.

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

Utrzymywane w celu zachowania zgodności wstecznej. To pole nie ma wpływu funkcjonalnego na wygenerowane modele.

Dodatkowy prompt tekstowy dostarczony w celu pokierowania procesem teksturowania na etapie udoskonalania.

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

Adres URL do pobrania obrazu 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 przezroczysty podgląd został pomyślnie wyrenderowany; w przeciwnym razie to pole jest pomijane.

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

Progress zadania. Jeśli zadanie nie zostało jeszcze rozpoczęte, ta właściwość będzie miała wartość 0. Gdy zadanie zakończy się powodzeniem, wartość ta stanie się 100.

Znacznik czasu rozpoczęcia zadania, w milisekundach. Jeśli zadanie nie zostało jeszcze rozpoczęte, ta właściwość będzie miała wartość 0.

Znacznik czasu utworzenia zadania, w milisekundach.

Znacznik czasu zakończenia zadania, w milisekundach. Jeśli zadanie nie zostało jeszcze zakończone, 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. Zwykle zawiera tylko jeden obiekt adresu URL tekstury. Każdy adres URL tekstury ma następujące właściwości:

Liczba poprzedzających zadań.

Szczegóły błędu dla zadań zakończonych niepowodzeniem. Zobacz Błędy, aby uzyskać pełną dokumentację obiektu task_error.

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