Seedream v4.5 Edit API: Programmatische afbeeldingsbewerking

Het uitvoeren van Seedream v4.5 Edit via de Arteza UI werkt voor eenmalige bewerkingen en kleine batches. Voor workflows met hoog volume - catalogi met duizenden SKU's, dynamische afbeeldingsgeneratie per gebruiker, CMS-gestuurde asset pipelines - wil je API-toegang. Deze gids loopt je door de eindpuntstructuur, requestparameters, responseverwerking en productiepatronen voor het bouwen van geautomatiseerde afbeeldingsbewerkingssystemen op Seedream v4.5.

Samengevat

• Seedream v4.5 Edit is beschikbaar via het fal-ai/bytedance/seedream/v4.5/edit eindpunt
• Dezelfde 8 credits ($0,08) per afbeelding prijsstelling als de UI
• Accepteert tot 10 afbeeldings-URL's plus een tekstprompt
• 4MP (2048×2048) output geretourneerd als afbeeldings-URL
• 30-60 seconden typische generatietijd - gebruik async patronen voor productie

Waarom de API gebruiken

De API ontgrendelt automatiseringspatronen die de UI niet kan evenaren:

• Batching met hoog volume. Verwerk 1.000+ bewerkingen in een enkele pipelinerun.
• Dynamische generatie. Bouw afbeeldingen on-demand uit gebruikersgegevens of databaserecords.
• Geplande workflows. Nachtelijke catalogusupdates, event-geactiveerde regeneratie.
• Integratie met bestaande stacks. Node.js, Python, Go, Ruby - elke HTTP-client.
• Reproduceerbare productie. Versiecontrolescripts in plaats van handmatige klikken.

Als je use case meer dan 20-50 gelijkaardige bewerkingen omvat, is de API de moeite van het instellen waard.

Eindpuntstructuur

Het Seedream v4.5 Edit-model is beschikbaar op:

fal-ai/bytedance/seedream/v4.5/edit

Dit is een standaard fal.ai modeleindpunt dat rechtstreeks kan worden aangeroepen of via het Arteza-creditsysteem.

Authenticatie

Arteza API-verzoeken authentificeren via een API-sleutel die in de Authorization header wordt doorgegeven als een Bearer token.

Je API-sleutel verkrijgen

1. Meld je aan op arteza.ai
2. Navigeer naar je accountinstellingen
3. Zoek de API-sectie
4. Genereer een nieuwe API-sleutel
5. Bewaar deze veilig - behandel het als een wachtwoord

Commit nooit je API-sleutel naar versiecontrole. Gebruik omgevingsvariabelen:

export SEEDANCE_API_KEY="your_api_key_here"

Authenticatieheader

Authorization: Bearer your_api_key_here

Requeststructuur

Een basisverzoek voor Seedream v4.5 Edit ziet er als volgt uit:

{
  "prompt": "Vervang de achtergrond door een gepolijst marmeren oppervlak. Behoud de productpositie, kleur en verlichting exact. Voeg een subtiele contactschaduw toe.",
  "image_urls": [
    "https://your-bucket.com/product-shot.jpg"
  ],
  "num_images": 1,
  "output_format": "png"
}

Parameterreferentie

Tot 10 afbeeldings-URL's kunnen worden doorgegeven. Het model behandelt de eerste afbeelding als primair en volgende afbeeldingen als referenties.

Voorbeeldverzoek: Node.js

const response = await fetch("https://api.arteza.ai/v1/seedream/v4.5/edit", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.SEEDANCE_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    prompt: "Vervang de achtergrond door een gepolijst marmeren oppervlak. Behoud de productpositie, kleur en verlichting exact.",
    image_urls: [
      "https://your-bucket.com/product-shot.jpg"
    ],
    num_images: 1,
    output_format: "png"
  })
});

const result = await response.json();
console.log(result.images[0].url);

Voorbeeldverzoek: Python

import os
import requests

response = requests.post(
    "https://api.arteza.ai/v1/seedream/v4.5/edit",
    headers={
        "Authorization": f"Bearer {os.environ['SEEDANCE_API_KEY']}",
        "Content-Type": "application/json"
    },
    json={
        "prompt": "Vervang de achtergrond door een gepolijst marmeren oppervlak. Behoud de productpositie, kleur en verlichting exact.",
        "image_urls": [
            "https://your-bucket.com/product-shot.jpg"
        ],
        "num_images": 1,
        "output_format": "png"
    }
)

result = response.json()
print(result["images"][0]["url"])

Responsestructuur

Een geslaagd antwoord bevat de gegenereerde afbeeldings-URL's:

{
  "images": [
    {
      "url": "https://storage.arteza.ai/output/abc123.png",
      "width": 2048,
      "height": 2048,
      "content_type": "image/png"
    }
  ],
  "seed": 123456789,
  "credits_used": 8
}

Download de afbeelding van de geretourneerde URL - output-URL's zijn 24 uur geldig.

Async generatiepatroon

Seedream v4.5 Edit duurt 30-60 seconden per verzoek. Voor productie wil je waarschijnlijk async generatie met webhooks of polling in plaats van blokkerende verzoeken.

Op webhook gebaseerde async

Geef een webhook_url door in je verzoek en Arteza POST het resultaat ervan naar die URL wanneer de generatie voltooid is:

{
  "prompt": "...",
  "image_urls": ["..."],
  "webhook_url": "https://your-app.com/webhooks/seedream"
}

Je webhook-handler ontvangt:

{
  "request_id": "req_abc123",
  "status": "completed",
  "images": [
    {
      "url": "https://storage.arteza.ai/output/xyz.png"
    }
  ]
}

Webhook-verwerking is het aanbevolen productiepatroon.

Begin met bouwen. Probeer het gereedschap eerst.

Op polling gebaseerde async

Als je infrastructuur geen webhooks kan ontvangen, poll voor status:

const initResponse = await fetch("https://api.arteza.ai/v1/seedream/v4.5/edit", {
  method: "POST",
  headers: { "Authorization": `Bearer ${key}`, "Content-Type": "application/json" },
  body: JSON.stringify({ prompt, image_urls, async: true })
});

const { request_id } = await initResponse.json();

// Poll voor voltooiing
let result;
while (!result) {
  await new Promise(r => setTimeout(r, 5000));
  const statusResponse = await fetch(
    `https://api.arteza.ai/v1/requests/${request_id}`,
    { headers: { "Authorization": `Bearer ${key}` } }
  );
  const status = await statusResponse.json();
  if (status.status === "completed") result = status;
}

Poll elke 5-10 seconden. Totale wachttijd is meestal 30-60 seconden.

Productiepatronen

Patroon 1: Batch-generatie van catalogus

Voer de API uit over je productcatalogus om consistente achtergrondswaps voor elke SKU te genereren:

for product in catalog:
    response = requests.post(
        API_URL,
        headers=HEADERS,
        json={
            "prompt": PROMPT_TEMPLATE.format(product_name=product.name),
            "image_urls": [product.source_image_url],
            "webhook_url": WEBHOOK_URL
        }
    )
    log_request(product.id, response.json()["request_id"])

Combineer met een webhook-handler die outputs naar je CDN opslaat en het productrecord bijwerkt.

Patroon 2: On-demand gebruikersbewerkingen

Laat gebruikers afbeeldingen uploaden en krijg AI-bewerkde resultaten on-demand:

1. Gebruiker uploadt afbeelding naar je bucket
2. Je backend roept Seedream v4.5 Edit aan met een door de gebruiker gekozen prompt
3. Poll of wacht op webhook
4. Retourneer de resultaat-URL naar de client van de gebruiker

Budget voor ongeveer 60 seconden wachttijd per bewerking in je UX.

Patroon 3: CMS-gestuurde asset pipeline

Wanneer inhoud in je CMS wordt gepubliceerd, auto-genereer gerelateerde afbeeldingen:

1. CMS zendt een publishevent uit
2. Serverless-functie wordt geactiveerd
3. Roept Seedream v4.5 Edit aan met een sjabloonprompt
4. Slaat resultaat op CDN op
5. Werkt CMS-record bij met afbeeldings-URL

Dit patroon elimineert handmatige afbeeldingcreatie voor high-volume publicatie.

Foutafhandeling

Veelvoorkomende foutresponsen:

Wrap altijd API-aanroepen in try/except met herhaalopenlogica voor 429 en 500-responses.

Snelheidslimieten

Arteza biedt redelijke snelheidslimieten op de API. Voor de meeste productiewerkstromen zul je ze niet bereiken, maar voor bulkbatches van 1.000+ verzoeken, implementeer:

• Exponentiële backoff op 429-responses
• Limiteringen voor gelijktijdige verzoeken (begin met 5 parallel, stem af)
• Verzoekwachtrij voor voorspelbare doorvoer

Neem contact op met ondersteuning voor hogere snelheidslimieten op zware productiewerkbelastingen.

Kosten bij API-volume

API-aanroepen kosten hetzelfde als UI-aanroepen: 8 credits ($0,08) per afbeelding. Voor planningsdoeleinden:

• 100 API-aanroepen = 800 credits (Starter-tier, $10)
• 1.000 API-aanroepen = 8.000 credits (Pro-tier, $50)
• 10.000 API-aanroepen = 80.000 credits (meerdere Studio-tiers, ongeveer $650)

Voor volumes boven 10.000/maand, neem contact op met het team voor aangepaste prijzen.

Best practices

1. Gebruik webhooks in productie. Polling werkt maar verspilt bronnen.
2. Sla prompts op in versiecontrole. Behandel prompts zoals code.
3. Log alles. Verzoek-ID's, prompts, outputs, fouten.
4. Valideer invoer voordat je aanroept. Slechte afbeeldings-URL's verspillen credits.
5. Controleer creditsaldo. Waarschuw wanneer je onder een drempel valt.
6. Test promptwijzigingen in staging. Valideer op 3-5 afbeeldingen voordat je een volledige batch uitvoert.
7. Cache resultaten. Als invoer identiek is, hergebruik vorige outputs.

Verder lezen

• Volledige Seedream v4.5 bewerkingsgids
• Batchbewerkingshandleiding
• Prijsbreaking

Aan de slag

Genereer je API-sleutel in het Arteza-dashboard, pak 50 gratis credits en voer het bovenstaande Node.js-voorbeeld uit met een productshot. De API ontgrendelt het volledige productiepotentieel van Seedream v4.5 Edit - zodra je het hebt ingesteld, is al het andere prompt engineering. Voor hands-on testen eerst, open het webgereedschap en valideer je prompts voordat je automatiseert.