Genera immagini
e finiscile nella stessa catena di chiamate
Un POST esegue un agente immagine - GPT Image, Imagen, Nano Banana, Grok o Leonardo - e i passaggi che di solito vengono dopo, scontorno, ritocco e riquadratura, sono a una chiamata di distanza con la stessa chiave.
POSThttps://autostud.ai/api/v1/actions/images.generateTre chiamate, dal prompt all'asset finito
Scegli il motore una volta, genera quanto vuoi, poi rifinisci il file.
- 1
Scegli un agente immagine
Un agente è una configurazione salvata: motore, dimensione, stile e il template di prompt concordato dal tuo team. Elenca quelli del tuo spazio di lavoro e tieni l'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
Genera
Manda il prompt e le variabili che il template si aspetta. La risposta porta l'immagine e i crediti spesi.
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
Rifinisci il file
Scontorna lo sfondo, applica un ritocco a istruzione o riquadra in un altro formato. Stessa chiave, stesso registro, nessuna seconda integrazione.
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" }'
Cosa puoi passare
Tre campi per generare, uno per la post-produzione.
agent_idL'agente immagine da eseguire. Motore, dimensione e stile arrivano con lui.
promptCosa disegnare, scritto come lo attende il template del tuo agente.
variablesI valori dei segnaposto di quel template, così un solo agente può servire un intero catalogo.
image_urlPer gli strumenti di finitura: l'immagine da scontornare, ritoccare o ritagliare. Qualsiasi immagine pubblicamente raggiungibile.
I motori dietro l'endpoint
Ogni motore è esposto come agente, quindi cambiare modello è un id diverso, non un'integrazione diversa. I motori nuovi arrivano come agenti nuovi.
Gli strumenti che vengono dopo
Generare è raramente l'ultimo passo. Scontorno, ritocchi a istruzione e riquadratura sono azioni della stessa API, fatturate allo stesso modo e limitate dalla stessa chiave.
tools.remove_backgroundtools.image_modificationtools.image_cropLe domande che gli sviluppatori fanno per prime
Come faccio a sapere quanto è costata un'immagine?
Ogni risposta riporta i crediti spesi e lo storico resta leggibile su /api/v1/generations. I prezzi sono per motore e si impostano nello spazio di lavoro, mai nella richiesta.
Un solo agente può servire molti prompt?
È esattamente il ruolo delle variabili: l'agente tiene template e stile, la chiamata riempie ciò che cambia. Un catalogo prodotti è un agente e N chiamate, non N agenti.
Anche le immagini arrivano via webhook?
generation.completed scatta per le immagini esattamente come per video e audio, quindi una sola sottoscrizione copre l'intera famiglia delle generazioni.
Posso usare un'immagine generata in un video?
Sì. L'URL generato entra diretto in un livello della timeline, e renders.create trasforma l'intera composizione in mp4 con la stessa chiave.
Pronto a creare?
Inizia a generare video virali in pochi minuti. Nessuna carta di credito richiesta per la prova gratuita.