PopNowDokumentacja API
Integracje
Treść główna

Dodatek do renderowania AI w Blenderze

Zamieniaj widok kamery lub glinianą prewizualizację z Blendera w rendery AI, wideo AI i bezszwowe tekstury za pomocą bezpłatnego dodatku PopNow. Instalacja, klucz API, modele, ceny w USD i wywołania REST.

Bezpłatny dodatek PopNow do Blendera dodaje kartę PopNow do panelu bocznego widoku 3D. Zbuduj zarys sceny z szarych brył, ustaw kadr kamery, a PopNow nada jej wygląd: gotowy obraz zachowujący kompozycję, krótki film podążający za ruchem kamery albo bezszwową teksturę dla wybranego obiektu. Dodatek korzysta z twojego klucza API PopNow i osobnego salda API w USD, początkowo wynoszącego 0 USD. Doładuj je w rozliczeniach API; kredyty strony nie opłacają uruchomień dodatku.

Pobierz go ze strony dodatku do Blendera na popnow.ai (aktualna wersja 0.1.0, około 58 KB, Windows, macOS i Linux, Blender 4.2 lub nowszy).

Szary render gliniany dwóch postaci przy stoliku w kawiarni
Ta sama scena wyrenderowana jako słoneczna kawiarnia z dwiema osobami
Od renderu glinianego do gotowej klatki: Seedream 5.0 Pro z dwoma zdjęciami referencyjnymi, 0,036 USD.

Co potrafi

Tryb pracyWejścieWynik
Render with AIWidok kamery lub widok roboczy wyrenderowany jako jednolita szara glina, opcjonalnie przebieg głębi lub linii, do trzech zdjęć referencyjnychGotowy obraz w edytorze obrazów; opcjonalnie ustawiony jako tło kamery lub rzutowany na siatki
Animate with AISzybki podgląd animacji kamery z WorkbenchMP4 zachowujący ruch kamery, rozstawienie obiektów i rytm animacji, gotowy do umieszczenia w Video Sequencer
Seamless textureOpis materiału i stylu (skan fotograficzny, ręcznie malowany, kreskówkowy)Kwadratowa tekstura ze zblendowanymi krawędziami oraz materiał z projekcją sześcienną, nałożony na wybrane obiekty

Instalacja w trzech krokach

Pobierz ZIP

Pobierz popnow-blender-0.1.0.zip z popnow.ai/blender. Nie rozpakowuj go. Dodatek ma otwarty kod źródłowy: znajdziesz go w popnow-blender na GitHubie, skąd możesz też zbudować ten sam ZIP.

Zainstaluj w Blenderze

W Blenderze 4.2 lub nowszym przeciągnij ZIP do okna programu. Możesz też otworzyć Edit › Preferences › Get Extensions, kliknąć menu w prawym górnym rogu, wybrać Install from Disk i wskazać ZIP. Przy pierwszym uruchomieniu Blender prosi o zgodę na dostęp do internetu; PopNow potrzebuje go do wysyłania renderów i pobierania wyników.

Wklej klucz API

Naciśnij N w widoku 3D, otwórz kartę PopNow, kliknij Get API key, utwórz klucz w konsoli API i wklej go. Saldo pojawi się od razu.

Jak przebiega renderowanie

  1. Ustaw kadr kamery lub przełącz panel na Viewport.
  2. Opisz oczekiwany obraz, wybierz styl i model. Cena pojawi się na przycisku.
  3. Dodatek wyrenderuje obraz gliniany, prześle go i pobierze dokładną wycenę.
  4. Kliknij Start. Blender pozostaje responsywny podczas pracy; postęp widać w panelu Tasks.
  5. Wynik otworzy się w edytorze obrazów i zapisze w folderze popnow obok pliku .blend.
Szara gliniana butelka na postumencie
Butelka wyrenderowana jako zdjęcie produktowe
Gliniana butelka na postumencie zamieniona w zdjęcie produktowe: Nano Banana 2.1 z jednym zdjęciem produktu, 0,048 USD.

Modele i ceny

Ceny API są podawane w USD, według tych samych stawek modeli co na stronie. Poniższe kwoty to orientacyjne szacunki; pobierz aktualną wycenę dla konkretnego modelu, ustawień i obowiązującej ceny. Panel pokazuje szacunek dla twoich ustawień, a przed rozpoczęciem zatwierdzasz dokładną wycenę.

Tryb pracyModelZastosowaniePrzykładowa cena w USD
RenderowanieSeedream 5.0 ProDobry kompromis; wiernie zachowuje układ scenyokoło 0,036 USD za obraz 1K
RenderowanieSeedream 5.0 FlashSzybciej i taniejokoło 0,029 USD
RenderowanieNano Banana 2.1Najlepszy przy wielu obrazach referencyjnychokoło 0,048 USD
RenderowanieGPT Image 2Dobrze odwzorowuje tekst i drobne szczegółyokoło 0,04254 USD (kwadrat, medium, 1K)
RenderowanieQwen-Image 2.1 TurboNajtańsze szkiceokoło 0,0144 USD
RenderowanieFLUX.1 dev ControlNetDokładne kształty z przebiegu głębi lub linii; bez obrazów referencyjnychokoło 0,036 USD
AnimacjaSeedance 2.0 MiniNajtańszy, dobry do szkicówAktualna wycena dla twojego klipu
AnimacjaSeedance 2.0 FastRównowaga ceny i jakościAktualna wycena dla twojego klipu
AnimacjaSeedance 2.0Wyższa jakość, do 4KAktualna wycena dla twojego klipu
AnimacjaSeedance 2.5Najwierniej odtwarza glinianą prewizualizacjęAktualna wycena dla twojego klipu
AnimacjaWan 3.0Dobre odwzorowanie ruchu, do 1080pAktualna wycena dla twojego klipu
AnimacjaKling O3 RestyleNadaje klipowi nowy wygląd klatka po klatce, od 3 do 10 sAktualna wycena dla twojego klipu
AnimacjaWan 2.2 AnimateSterowanie ruchem: twoja postać naśladuje glinianą figuręAktualna wycena dla twojego klipu
TeksturaSeedream 5.0 FlashSzybko i taniookoło 0,029 USD za obraz 1K
TeksturaQwen-Image 2.1 TurboNajtaniejokoło 0,0144 USD
TeksturaSeedream 5.0 ProNajwięcej szczegółówokoło 0,036 USD
TeksturaNano Banana 2.1Do 4Kokoło 0,048 USD

Jeśli generowanie się nie powiedzie, zablokowane środki API zostaną automatycznie zwolnione, o czym poinformuje panel Tasks. Zobacz Saldo API i zwroty.

Wywołania API używane przez dodatek

Dodatek jest zwykłym klientem API: przesyła render gliniany, pobiera wycenę, tworzy zadanie i je odpytuje. Jeśli piszesz własne skrypty do Blendera lub chcesz uzyskać ten sam wynik z farmy renderującej, wywołaj API bezpośrednio. Tak działa Render with AI z Seedream 5.0 Pro:

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: $(uuidgen)" \
  -d '{"model": "bytedance/seedream-5.0-pro/edit", "input": {"prompt": "Turn this clay render into a sunlit cafe photo. Keep the camera, layout and silhouettes exactly.", "image_urls": ["popnow://f/fil_clay_render"], "aspect_ratio": "16:9", "resolution": "1k"}}'
Python (bpy scripts can use the same code)
import os, time, uuid, requests

API = "https://api.popnow.ai/api/v1"
H = {"Authorization": f"Bearer {os.environ['POPNOW_API_KEY']}"}

def upload(path):
    data = open(path, "rb").read()
    ticket = requests.post(f"{API}/common/upload-url", headers=H, json={"contentType": "image/png", "bytes": len(data)}, timeout=30).json()["data"]
    requests.put(ticket["uploadUrl"], data=data, headers=ticket.get("headers", {}), timeout=120).raise_for_status()
    return requests.post(f"{API}/files/{ticket['fileId']}/commit", headers=H, timeout=30).json()["data"]["uri"]

clay = upload("/tmp/clay_render.png")
task = requests.post(
    f"{API}/jobs/createTask",
    headers={**H, "Idempotency-Key": str(uuid.uuid4())},
    json={
        "model": "bytedance/seedream-5.0-pro/edit",
        "input": {"prompt": "Turn this clay render into a sunlit cafe photo. Keep the camera, layout and silhouettes exactly.", "image_urls": [clay], "aspect_ratio": "16:9"},
    },
    timeout=30,
).json()["data"]

while task["state"] in ("queued", "running"):
    time.sleep(3)
    task = requests.get(f"{API}/jobs/recordInfo", headers=H, params={"taskId": task["taskId"]}, timeout=30).json()["data"]
print(task["state"], task.get("output", {}).get("assets", [{}])[0].get("url"))
JavaScript
const res = await fetch('https://api.popnow.ai/api/v1/jobs/quote', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.POPNOW_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    model: 'bytedance/seedream-5.0-pro/edit',
    input: { prompt: 'Turn this clay render into a sunlit cafe photo.', image_urls: ['https://media.popnow.ai/movie/lighthouse.webp'], aspect_ratio: '16:9' },
  }),
});
console.log((await res.json()).data.maxChargeUsd, 'USD at most');

Zastąp popnow://f/fil_clay_render URI zwróconym po przesłaniu własnego pliku; zobacz Media.

Co opuszcza twój komputer

  • Tylko wyrenderowany obraz gliniany lub klip podglądowy oraz wybrane zdjęcia referencyjne. Plik .blend, siatki i tekstury pozostają na twoim komputerze.
  • Klucz API jest przechowywany w preferencjach Blendera, nigdy w pliku .blend, więc udostępnienie projektu nie udostępnia klucza.
  • Wyniki są pobierane do folderu popnow obok pliku .blend lub do wskazanego folderu.

Typowe błędy

Co widziszPrzyczynaRozwiązanie
Karta PopNow prosi o kluczKlucz nie został jeszcze zapisany albo został unieważnionyUtwórz klucz w konsoli API i wklej go
Dodatek nie może połączyć się z PopNowWyłączone Allow Online Access w Blenderze lub zapora blokuje api.popnow.aiWłącz dostęp w Preferences › System › Network
Za mało środków na saldzie APIWycena przekracza twoje saldoDoładuj API w rozliczeniach API albo wybierz tańszy model, niższą rozdzielczość lub krótszy klip
Wideo ignoruje gliniane postacieModel mocniej kieruje się promptem niż prewizualizacjąUżyj Seedance 2.5 lub Wan 2.2 Animate dla postaci
Kształty odbiegają od układu scenyModele obrazu interpretują kontury na nowoUżyj FLUX.1 dev ControlNet z przebiegiem głębi lub konturów
„Stop waiting”, ale zadanie nadal trwaRozpoczęte zadanie działa w PopNow do końcaWróć do niego później w panelu Tasks, by pobrać wynik

Czy dodatek do Blendera jest bezpłatny?

Tak. Sam dodatek nic nie kosztuje; każde generowanie zużywa osobne saldo API w USD, a cenę widzisz przed rozpoczęciem.

Które wersje Blendera obsługuje?

Blender 4.2 i nowszy na Windows, macOS i Linux. Instaluje się jako rozszerzenie Blendera, bez dodatkowych pakietów Pythona.

Czy potrzebuję GPU?

Nie. Generowanie odbywa się w PopNow. Twój komputer tworzy tylko szybki render gliniany w Workbench oraz przebieg Cycles z jedną próbką, jeśli poprosisz o głębię, normalne lub kontury.

Czy mogę zamiast tego użyć lokalnego modelu Stable Diffusion?

Nie. Dodatek wywołuje modele hostowane przez PopNow. Jeśli chcesz lokalny graf korzystający również z modeli w chmurze, użyj węzła ComfyUI.

Blender jest zastrzeżonym znakiem towarowym Blender Foundation. PopNow nie jest powiązany z Blender Foundation ani przez nią rekomendowany.

Na tej stronie