Obraz na 3DO modelu Seed3D 2.0
Bogato teksturowane modele 3D z jednego obrazu, świetne do postaci.
Wywołujesz go nazwą modelu bytedance/seed3d-2.0/image-to-3d w POST /jobs/createTask, od 0,48 USD.
Wprowadzenie
Seed3D 2.0 to model zasobów 3D z zespołu Seed firmy ByteDance, wydany w kwietniu 2026 roku. Odczytuje pojedynczy obraz i buduje znajdujący się na nim obiekt jako pełną siatkę 3D z materiałami, dzięki czemu zdjęcie produktu albo render postaci staje się czymś, co można obrócić, oświetlić i umieścić w scenie. Żądanie przyjmuje jeden obraz (image_url) i opcjonalny przełącznik gęstości (mesh_detail); nie ma pól promptu, seed ani stylu. Wynikiem jest jeden binarny plik glTF (.glb) z teksturami zapakowanymi w środku.
Najważniejsze cechy
Geometria i materiały z jednego obrazu
Seed3D 2.0 generuje kształt i materiał oparty na fizyce jednocześnie. W naszych testach każdy model wrócił z dwiema teksturami 4096×4096: mapą koloru bazowego i mapą metal-roughness, więc skóra wyglądała na zużytą i matową, a mosiężne oczka i przyłbica hełmu łapały refleksy. Nie ma osobnej mapy normalnych; detal powierzchni znajduje się w samej siatce.
Gęsta, zamknięta siatka
Na domyślnym poziomie medium oba modele testowe wróciły z jedną siatką i jednym materiałem, nieco poniżej 500 000 trójkątów; na poziomie low ten sam but miał 99 977 ścian. Według twórców poziomy odpowiadają około 100 000, 500 000 i 1 000 000 ścian. Gęstsza siatka lepiej oddaje drobne elementy, jak sznurówki, szwy i palce; lżejsza szybciej się ładuje w przeglądarce.
Co zmierzyliśmy
Wysłaliśmy studyjne zdjęcie skórzanego buta w rozdzielczości 1024×1024 oraz render zabawkowego astronauty 682×1024. Oba zwróciły poprawne pliki GLB: 37,2 MB i 28,6 MB, 499 998 i 499 992 trójkąty, przetworzone w 356 i 340 sekund. Astronauta zachował twarz, przyłbicę, panel na piersi i pomarańczowe wykończenia ze wszystkich stron. But wysłany jako prosty widok z przodu wrócił z tylną połową odbitą z przodu.
Parametry żądania
| Parametr | Wymagany | Opis |
|---|---|---|
image_url | Tak | Obraz, od którego zaczynasz. |
mesh_detail | Nie | Gęstość siatki: low (około 100 tys. ścian), medium (około 500 tys.) lub high (około 1 mln). low · medium · high · Domyślnie: medium |
Ceny
Ceny podano w USD. API korzysta z oddzielnego salda w dolarach amerykańskich. Kredytów strony nie można używać w API ani zamieniać na saldo API. Nie można też zamieniać salda API na kredyty strony. Po przyjęciu zadania rezerwujemy maksymalną kwotę wyceny na saldzie API. Po zakończeniu naliczamy opłatę za rzeczywiste użycie, nie wyższą niż rezerwacja, i zwalniamy resztę. Jeśli zadanie się nie powiedzie, rezerwacja zostaje zwolniona.
| Opcja | USD za generację |
|---|---|
| Standard | 0,48 USD |
Przed uruchomieniem wyślij tę samą treść żądania do POST /jobs/quote, aby zobaczyć szacowaną i maksymalną opłatę w USD. Wycena nie uruchamia zadania ani nie obciąża salda.
Zastosowania
E-commerce i podglądy produktów
Zdjęcie packshot staje się interaktywnym modelem do strony produktu lub podglądu AR. Sfotografuj albo wyrenderuj produkt pod kątem trzech czwartych na jednolitym tle, trzymaj cały obiekt w kadrze i użyj poziomu medium, aby zrównoważyć szczegółowość i rozmiar pobieranego pliku.
Postacie, zabawki i kolekcjonerskie figurki
Renderowane postacie i zdjęcia figurek dobrze się konwertują, bo ich kształty są proste, a kolory wyraziste. Tekstura przenosi namalowane detale, jak twarze, odznaki i pasy; tył jest wnioskowany, więc wybierz pozę, w której widać większość postaci.
Poradnik promptów i porady dla zaawansowanych
Przygotuj obraz
Jeden podmiot, wyśrodkowany, z pewnym marginesem i bez dotykania krawędzi kadru. Jasne, jednolite tło wyraźnie oddziela obiekt. Przyjmowane są JPEG, PNG lub WebP do 10 MB, a proporcje obrazu powinny mieścić się w przybliżeniu między 2:5 a 5:2.
Wybierz kąt celowo
Model widzi tylko jedną stronę. Prosty widok z przodu buta lub samochodu nie pokazuje długości obiektu, a ukryta połowa może zostać uzupełniona lustrzanym odbiciem przodu. Widok pod kątem trzech czwartych, pokazujący przód i jeden bok, daje znacznie bardziej wiarygodny wynik.
Wybierz poziom szczegółowości pod miejsce użycia
Użyj low do podglądów mobilnych i scen z wieloma rekwizytami, medium do większości przeglądarek webowych, a high, gdy model będzie oglądany z bliska albo drukowany w 3D.
Sprawdź wynik przed wdrożeniem
Otwórz GLB w przeglądarce, obróć go w pełni i obejrzyj stronę, której nie pokazałeś. Jeśli tył wygląda źle, spróbuj innego kąta zdjęcia zamiast innego poziomu szczegółowości.
Szybki start z API
Wywołaj API Seed3D 2.0 w trzech krokach
- Utwórz klucz API. Zaloguj się do PopNow i utwórz klucz w konsoli API. Klucze zaczynają się od sk-popnow-. Wywołania korzystają z oddzielnego salda w dolarach amerykańskich.
- Wyślij żądanie. Wyślij POST /jobs/createTask z model bytedance/seed3d-2.0/image-to-3d i obiektem input zgodnym z tabelą parametrów. Odpowiedź od razu zwraca ID zadania.
- Odbierz wynik. Odpytuj GET /jobs/recordInfo po ID zadania albo podaj callBackUrl, a wyślemy tam wynik. Gdy zadanie się powiedzie, pobierz pliki z linków wyjściowych.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seed3d-2.0/image-to-3d",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"mesh_detail": "medium"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Podmień prompt i linki na własne. Odniesienie do odpowiedzi, odpytywania i callbacku znajdziesz na karcie API.
Pytania o API Seed3D 2.0
Ile kosztuje API Seed3D 2.0?
Seed3D 2.0 kosztuje 0,48 USD za generację. API korzysta z oddzielnego salda w dolarach amerykańskich. Kredytów strony nie można używać w API ani zamieniać na saldo API. Nie można też zamieniać salda API na kredyty strony. Po przyjęciu zadania rezerwujemy maksymalną kwotę wyceny na saldzie API. Po zakończeniu naliczamy opłatę za rzeczywiste użycie, nie wyższą niż rezerwacja, i zwalniamy resztę. Jeśli zadanie się nie powiedzie, rezerwacja zostaje zwolniona.
Jaka jest nazwa modelu Seed3D 2.0 w API?
Wpisz bytedance/seed3d-2.0/image-to-3d do zadania Obraz na 3D w polu model żądania POST /jobs/createTask.
Co dostanę?
Jeden plik .glb (binarny glTF 2.0) z osadzonymi teksturami: mapą koloru bazowego i mapą metal-roughness, w naszych próbach obie jako PNG 4096×4096. Blender, three.js, model-viewer, Unity i Unreal importują go bezpośrednio.
Czy potrzebny jest prompt?
Nie. Wymagany jest tylko obraz. mesh_detail jest opcjonalny i zmienia wyłącznie gęstość siatki.
Jaki obraz działa najlepiej?
Jeden obiekt w całości w kadrze, na jednolitym tle, widziany w trzech czwartych. Zatłoczone sceny, ucięte przedmioty i ujęcia z frontu zmuszają model do zgadywania tego, czego nie widzi.
Jakie limity ma API Seed3D 2.0?
Największy przesyłany plik: 10 MB. Żądania poza tymi limitami są odrzucane, zanim cokolwiek zostanie pobrane.
Czy mogę wypróbować Seed3D 2.0 bez pisania kodu?
Uruchom Seed3D 2.0 w Playground z salda API w USD, bez klucza API. Każde uruchomienie trafia do historii dewelopera wraz z odpowiednim kodem.