Graydient AI rendering API
Jeśli tworzysz aplikację, narzędzie wewnętrzne lub pipeline renderujący, Graydient daje Ci otwarte modele obrazów, wideo i LLM na dedykowanych GPU, za jednym API, w stałej miesięcznej cenie.
W którym planie jest dostępne
Osobiste API jest dostępne tylko z Video Max. Images i Video Plus nie mają dostępu do API. Możesz zmieniać plan lub anulować w dowolnym momencie w portal rozliczeniowy, z rozliczeniem proporcjonalnym. Ceny planu Business i API są pod business.graydient.ai.
Osobiste API jest kluczem dla jednego użytkownika, a automatyczny ruch nie jest dozwolony w żadnym planie osobistym. Oznacza to brak botów, skryptów, harmonogramów, zadań wsadowych, scraperów, aplikacji wieloużytkownikowych ani odsprzedawanego dostępu. Limit wywołań to około jedno co 10 sekund. Klucze wysyłające automatyczny lub nadmierny ruch są cofane bez powiadomienia.
Tworzenie produktu wieloużytkownikowego lub white-label
Wirtualni użytkownicy i logowanie white-label to funkcje biznesowe dla wdrożonych aplikacji z wieloma użytkownikami. Działają na osobistym API, więc możesz budować i testować takie funkcje na Video Max podczas rozwoju.
Uruchomienie produktu wieloużytkownikowego, automatycznego ruchu lub odsprzedaży wymaga planu Business: dedykowanego serwera GPU. business.graydient.ai wyjaśnia, co jest w pakiecie, podaje ceny i umożliwia zakup.
| Osobiste API (Video Max) | Wdrożenie biznesowe | |
|---|---|---|
| Użytkownicy | Jeden użytkownik (ty) | Użytkownicy twojego produktu |
| Odsprzedaż | Nie dozwolona | Dozwolona |
| Wirtualni użytkownicy i logowanie white-label | Buduj i testuj | Uruchom na żywo |
| Jak to zdobyć | Subskrybuj Video Max | Dedykowany serwer GPU lub umowa biznesowa |
Jak działa API
Aktualna wersja to V3, na https://cloud.graydient.ai/api/v3/. Stosuje specyfikację JSON:API: wysyłaj i odbieraj application/vnd.api+json, uwierzytelniaj się standardowym tokenem HTTP Bearer ze strony tokenów API i czytaj wyniki z obiektu data zawierającego członka attributes.
Renderowanie jest asynchroniczne. Wysyłasz POST na POST /api/v3/render/ z promptem i wymaganym callback_url. Graydient odpowiada od razu render_hash oraz szacowanym czasem oczekiwania i renderowania. Po zakończeniu zadania wysyła wyniki na twój webhook. Opcjonalne pola to:
- error_url: webhook na błędy
- init_image i mask_image: do image-to-image i inpaintingu
- placeholders: nazwane URL-e obrazów dla trybów ControlNet lub adapterów IP
- progressive_return: jedno wywołanie zwrotne na obraz
- session_id: powiąż rendery z własnymi użytkownikami
Workflowy działają przez ten sam endpoint z komendą workflow w promptcie.
Status bez odpytywania: GET GET /api/v3/render/{render_hash} zwraca status renderu, ale dokumentacja prosi, by go nie odpytywać. Użyj webhooka lub strumienia WebSocket pod wss://cloud.graydient.ai/render-events/{render_hash}, który wysyła zdarzenia started, image_done, done i error.
Inne rodziny endpointów
- Chat: czat LLM z personą. Odpowiedzi trafiają do callbacka lub wracają inline z sync: true, a modele wizji akceptują image_url.
- Concepts: lista dostępnych modeli i LoRA.
- Workflows: lista workflowów i co każdy obsługuje, np. txt2img, img2img, txt2vid i img2vid.
- Knowledge base: twórz domenę, dodawaj fakty, przeszukuj URL-e, potem wyszukuj lub czatuj.
- Skills: zamieniaj zapytania w języku naturalnym na komendy workflow.
- Wirtualni użytkownicy: mapuj swoich użytkowników końcowych na rekordy na twoim koncie. Buduj i testuj na osobistym API, potem uruchom na biznesowym wdrożeniu.
Pełna referencja: dokumentacja API. Dokumentacja mówi, że jest wciąż rozwijana.
Typowe zastosowania
- Zasilanie własnej aplikacji: użyj Graydient jako backendu renderowania dla funkcji obrazu, wideo lub czatu. Rozwijaj na osobistym API, potem przejdź na biznesowe wdrożenie, gdy pojawią się prawdziwi użytkownicy.
- Używanie własnych hostowanych modeli: renderuj z LoRA i checkpointami, które masz zainstalowane. Zobacz hostuj własne modele AI.
- Zdalne uruchamianie workflowów w stylu ComfyAPI: wywołuj zmapowane workflowy ze swojego kodu.
- Obrazy produktów i katalogów: powiększaj, edytuj lub zmieniaj styl obrazów z pipeline’u, w ramach limitu osobistego API.
- Renderowanie wsadowe: do ciągłych, dużych partii używaj dedykowanego serwera GPU zamiast osobistego API.
- Czat bazy wiedzy: buduj asystenta wsparcia lub dokumentacji na endpointach knowledge base i chat.
Dedykowane serwery GPU
Jeśli planujesz uruchamiać automatyczny ruch, produkt wieloużytkownikowy, odsprzedaż API lub renderowanie wsadowe przez cały dzień, potrzebujesz planu Business: dedykowanego serwera GPU, z własną maszyną i bez współdzielonej kolejki. Ceny, zawartość i formularz zamówienia są pod business.graydient.ai.
Ceny za renderowanie na dedykowanym serwerze, wideo wliczone, są podane na business.graydient.ai. Cena za renderowanie dotyczy tylko planu Business. Images, Video Plus i Video Max mają stałą cenę bez opłat za renderowanie.
Automatyczny ruch nie jest dozwolony w planach osobistych. Images, Video Plus i Video Max to plany o stałej cenie dla jednego użytkownika, a klucze wysyłające automatyczny ruch są cofane.
Pierwsze kroki
- Subskrybuj Video Max. Możesz zmieniać lub anulować plan w dowolnym momencie w portal rozliczeniowy.
- Utwórz token na stronie tokenów API.
- Przeczytaj dokumentacja API i sprawdź na GitHub przykłady użycia Graydient API.
- Skonfiguruj endpoint webhook, potem wyślij pierwsze żądanie renderu.
- Zrób kopię i miniaturę obrazów wynikowych zanim udostępnisz je użytkownikom, jak zaleca dokumentacja.
Wsparcie API dostępne jest mailowo pod info@graydient.ai. Wszystkie użycia podlegają zasady akceptowalnego użytkowania i warunki użytkowania.