APIAI Beeldgeneratie API

Genereer beelden
en werk ze af in dezelfde reeks calls

Eén POST draait een beeld-agent - GPT Image, Imagen, Nano Banana, Grok of Leonardo - en de stappen die er meestal op volgen, uitknippen, bewerken en herkadreren, liggen één call verderop met dezelfde sleutel.

POSThttps://autostud.ai/api/v1/actions/images.generate
Haal een API-sleutelAPI-referentie

Drie calls, van prompt tot afgewerkte asset

Kies de engine één keer, genereer zo vaak je wilt en werk daarna het bestand af.

  1. 1

    Kies een beeld-agent

    Een agent is een opgeslagen configuratie: engine, formaat, stijl en het prompt-sjabloon waar je team het over eens is. Vraag die van je workspace op en bewaar het 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. 2

    Genereer

    Stuur de prompt plus de variabelen die het sjabloon verwacht. Het antwoord draagt het beeld en de verbruikte credits.

    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. 3

    Werk het bestand af

    Knip de achtergrond weg, pas een bewerking op instructie toe of herkadreer naar een ander formaat. Zelfde sleutel, zelfde grootboek, geen tweede integratie.

    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"
  }'

Wat je kunt meesturen

Drie velden om te genereren, één om na te bewerken.

agent_id

De beeld-agent die draait. Engine, formaat en stijl komen met hem mee.

prompt

Wat er getekend moet worden, geschreven zoals je agent-sjabloon het verwacht.

variables

De waarden voor de plaatshouders in dat sjabloon, zodat één agent een hele catalogus bedient.

image_url

Voor de afwerkingstools: het beeld dat uitgeknipt, bewerkt of bijgesneden wordt. Alles wat publiek bereikbaar is.

Engines achter het endpoint

Elke engine is als agent beschikbaar, dus van model wisselen is een ander id, geen andere integratie. Nieuwe engines verschijnen als nieuwe agents.

GPT ImageImagenNano BananaGrokLeonardo

De tools die erna komen

Genereren is zelden de laatste stap. Achtergrond verwijderen, bewerkingen op instructie en herkadreren zijn acties op dezelfde API, gelijk afgerekend en begrensd door dezelfde sleutel.

tools.remove_backgroundtools.image_modificationtools.image_crop

Wat ontwikkelaars het eerst vragen

Hoe weet ik wat een beeld kostte?

Elk antwoord meldt de verbruikte credits en de historie blijft leesbaar op /api/v1/generations. Prijzen gelden per engine en staan in de workspace, nooit in het verzoek.

Kan één agent veel prompts bedienen?

Daar zijn variabelen voor: de agent houdt het sjabloon en de stijl vast, de call vult in wat verandert. Een productcatalogus is één agent en N calls, geen N agents.

Komen beelden ook via webhook binnen?

generation.completed vuurt voor beelden precies zoals voor video en audio, dus één abonnement dekt de hele generatie-familie.

Kan ik een gegenereerd beeld in een video gebruiken?

Ja. De gegenereerde URL gaat rechtstreeks in een tijdlijnlaag, en renders.create maakt van de hele compositie een mp4 met dezelfde sleutel.

OpenAPI-specFoutcodesBekijk de API

Klaar om te maken?

Maak virale video's in enkele minuten. Geen creditcard nodig voor de gratis proefperiode.

Gratis beginnen
ofBekijk demo's
Veilig betalen
Direct toegang
Altijd opzegbaar