Generuj obrazy
i wykańczaj je w tym samym łańcuchu wywołań
Jeden POST uruchamia agenta obrazu - GPT Image, Imagen, Nano Banana, Grok lub Leonardo - a kroki, które zwykle następują potem: wycinanie tła, edycja i kadrowanie, są o jedno wywołanie stąd, na tym samym kluczu.
POSThttps://autostud.ai/api/v1/actions/images.generateTrzy wywołania, od promptu do gotowego zasobu
Wybierz silnik raz, generuj ile chcesz, a potem wykończ plik.
- 1
Wybierz agenta obrazu
Agent to zapisana konfiguracja: silnik, rozmiar, styl i szablon promptu uzgodniony przez twój zespół. Wypisz te z twojej przestrzeni roboczej i zachowaj id.
export AUTOSTUD_API_KEY="sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" # An image agent is a saved configuration, not a model name. curl "https://autostud.ai/api/v1/agents?agent_type=image&limit=10" \ -H "Authorization: Bearer $AUTOSTUD_API_KEY" - 2
Generuj
Wyślij prompt i zmienne, których oczekuje szablon. Odpowiedź niesie obraz i zużyte kredyty.
curl -X POST https://autostud.ai/api/v1/actions/images.generate \ -H "Authorization: Bearer $AUTOSTUD_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: sku-4471-packshot" \ -d '{ "agent_id": "a91d5f27-6c0b-4e83-97aa-2b1e4d70c6f9", "prompt": "A ceramic mug seen three-quarter, soft studio light", "variables": { "product": "ceramic mug", "color": "matte navy" } }' - 3
Wykończ plik
Wytnij tło, zastosuj edycję opisaną instrukcją albo przekadruj do innego formatu. Ten sam klucz, ten sam rejestr, żadnej drugiej integracji.
curl -X POST https://autostud.ai/api/v1/actions/tools.remove_background \ -H "Authorization: Bearer $AUTOSTUD_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "image_url": "https://cdn.autostud.ai/generations/b6c30a19.../image.png" }'
Co możesz przekazać
Trzy pola do generowania, jedno do obróbki.
agent_idAgent obrazu do uruchomienia. Silnik, rozmiar i styl przychodzą razem z nim.
promptCo narysować, zapisane tak, jak oczekuje tego szablon twojego agenta.
variablesWartości dla pól szablonu, dzięki czemu jeden agent obsłuży cały katalog.
image_urlDla narzędzi wykończeniowych: obraz do wycięcia, edycji lub kadrowania. Dowolny publicznie dostępny.
Silniki za endpointem
Każdy silnik jest wystawiony jako agent, więc zmiana modelu to inne id, a nie inna integracja. Nowe silniki pojawiają się jako nowi agenci.
Narzędzia, które przychodzą potem
Generowanie rzadko jest ostatnim krokiem. Usuwanie tła, edycje instrukcją i kadrowanie to akcje tego samego API, rozliczane tak samo i ograniczone tym samym kluczem.
tools.remove_backgroundtools.image_modificationtools.image_cropO co programiści pytają najpierw
Skąd wiem, ile kosztował obraz?
Każda odpowiedź raportuje zużyte kredyty, a historia pozostaje czytelna pod /api/v1/generations. Ceny są per silnik i ustawiane w przestrzeni roboczej, nigdy w żądaniu.
Czy jeden agent obsłuży wiele promptów?
Właśnie po to są zmienne: agent trzyma szablon i styl, a wywołanie uzupełnia to, co się zmienia. Katalog produktów to jeden agent i N wywołań, a nie N agentów.
Czy obrazy też przychodzą webhookiem?
generation.completed wyzwala się dla obrazów dokładnie tak jak dla wideo i audio, więc jedna subskrypcja pokrywa całą rodzinę generacji.
Czy mogę użyć wygenerowanego obrazu w wideo?
Tak. Wygenerowany adres wchodzi wprost w warstwę osi czasu, a renders.create zamienia całą kompozycję w mp4 na tym samym kluczu.
Gotowy do tworzenia?
Zacznij generować wiralowe filmy w kilka minut. Karta kredytowa nie jest wymagana do bezpłatnej wersji próbnej.