Seedream 5.0 Edit API: programmatische beeldbewerking

Web-UI's zijn prima voor losse bewerkingen. API's zijn hoe je 10.000 afbeeldingen in één nacht bewerkt. De Seedream 5.0 Edit API geeft je programmatische toegang tot hetzelfde model voor bewerkingen op basis van natuurlijke taal dat het Arteza-platform aandrijft, tegen dezelfde $0,10 per bewerking. Deze gids behandelt authenticatie, endpoints, Python- en JavaScript-voorbeelden, batchpatronen en best practices voor productie.

Wanneer gebruik je de API en wanneer de web-UI?

Gebruik de web-UI wanneer:

• Je 1-20 afbeeldingen handmatig bewerkt
• Je visueel wilt itereren
• Je creatieve richtingen verkent

Gebruik de API wanneer:

• Je 50 of meer afbeeldingen bewerkt
• Je een product bouwt dat afbeeldingen bewerkt
• Je consistente prompts over een batch wilt toepassen
• Je bewerkingen wilt integreren in een bestaande pipeline (Lightroom-export, Shopify, CMS, enz.)

Authenticatie

De API gebruikt bearer-tokenauthenticatie. Haal je API-sleutel op via het Arteza dashboard nadat je je hebt aangemeld.

# Sla je sleutel op als omgevingsvariabele
export SEEDANCE_API_KEY="your_api_key_here"

Commit API-sleutels nooit naar git. Gebruik omgevingsvariabelen, secret managers of .env-bestanden.

Het bewerkingseindpunt

Eindpunt: POST https://api.arteza.ai/v1/edit

Verplichte parameters:

Optionele parameters:

Bij elke succesvolle aanroep worden 1 credits in mindering gebracht.

Python-voorbeeld

import os
import requests

API_KEY = os.environ["SEEDANCE_API_KEY"]
API_URL = "https://api.arteza.ai/v1/edit"

def edit_image(image_path: str, prompt: str) -> bytes:
    with open(image_path, "rb") as f:
        files = {"image": f}
        data = {
            "prompt": prompt,
            "model": "seedream-5-lite-edit",
            "output_format": "png",
        }
        headers = {"Authorization": f"Bearer {API_KEY}"}
        response = requests.post(
            API_URL, files=files, data=data, headers=headers, timeout=60
        )
        response.raise_for_status()
        return response.content

# Gebruik
edited = edit_image(
    "product.jpg",
    "Replace background with seamless white studio, add soft shadow"
)
with open("product_edited.png", "wb") as f:
    f.write(edited)

JavaScript / Node.js-voorbeeld

import fs from "fs";
import FormData from "form-data";
import axios from "axios";

const API_KEY = process.env.SEEDANCE_API_KEY;
const API_URL = "https://api.arteza.ai/v1/edit";

async function editImage(imagePath, prompt) {
  const form = new FormData();
  form.append("image", fs.createReadStream(imagePath));
  form.append("prompt", prompt);
  form.append("model", "seedream-5-lite-edit");
  form.append("output_format", "png");

  const response = await axios.post(API_URL, form, {
    headers: {
      ...form.getHeaders(),
      Authorization: `Bearer ${API_KEY}`,
    },
    responseType: "arraybuffer",
    timeout: 60000,
  });

  return response.data;
}

// Gebruik
const edited = await editImage(
  "product.jpg",
  "Apply warm golden-hour cinematic color grade"
);
fs.writeFileSync("product_edited.png", edited);

cURL-voorbeeld

curl -X POST https://api.arteza.ai/v1/edit \
  -H "Authorization: Bearer $SEEDANCE_API_KEY" \
  -F "image=@product.jpg" \
  -F "prompt=Replace background with clean white studio" \
  -F "model=seedream-5-lite-edit" \
  -o product_edited.png

Wil je dit soort resultaten? Probeer Seedream 5.0 Edit gratis →

Batchverwerkingspatroon

Het sterkste gebruik van de API is batch. Hier is een productieklaar Python-patroon:

import os
import concurrent.futures
from pathlib import Path

def process_batch(image_dir: str, prompt: str, output_dir: str, workers: int = 4):
    Path(output_dir).mkdir(parents=True, exist_ok=True)
    images = list(Path(image_dir).glob("*.jpg"))

    def process_one(img_path: Path):
        try:
            result = edit_image(str(img_path), prompt)
            output_path = Path(output_dir) / f"{img_path.stem}_edited.png"
            with open(output_path, "wb") as f:
                f.write(result)
            return (img_path.name, "success")
        except Exception as e:
            return (img_path.name, f"error: {e}")

    with concurrent.futures.ThreadPoolExecutor(max_workers=workers) as executor:
        results = list(executor.map(process_one, images))

    for name, status in results:
        print(f"{name}: {status}")

# Bewerk 100 productfoto's met dezelfde prompt
process_batch(
    image_dir="./raw_products",
    prompt="Replace background with pure white studio, soft shadow beneath",
    output_dir="./edited_products",
    workers=4,
)

Prestaties: met 4 workers duren 100 afbeeldingen in totaal ongeveer 3-5 minuten. Kosten: 100 x 1 credit = 100 credits = $10 totaal.

Foutafhandeling

De API retourneert standaard HTTP-statuscodes:

Herprobeervolgpatroon

import time
import requests

def edit_with_retry(image_path: str, prompt: str, max_retries: int = 3):
    for attempt in range(max_retries):
        try:
            return edit_image(image_path, prompt)
        except requests.HTTPError as e:
            if e.response.status_code in (429, 500, 502, 503, 504):
                wait = 2 ** attempt  # exponentiële backoff: 1s, 2s, 4s
                time.sleep(wait)
                continue
            raise
    raise Exception("Max retries exceeded")

Webhookworkflow voor grote batches

Voor taken met duizenden afbeeldingen gebruik je webhooks om lang polling te vermijden:

# Dien een taak in met een webhook-URL
response = requests.post(
    f"{API_URL}/batch",
    json={
        "model": "seedream-5-lite-edit",
        "images": ["s3://bucket/img1.jpg", "s3://bucket/img2.jpg", ...],
        "prompt": "Replace background with white studio",
        "webhook": "https://yourapp.com/webhook/seedance",
    },
    headers={"Authorization": f"Bearer {API_KEY}"},
)
job_id = response.json()["job_id"]

# Arteza POST de resultaten naar je webhook zodra de taak klaar is

Limieten

Als je hogere limieten nodig hebt, neem dan contact op met support via je dashboard.

Veelgebruikte productiepatronen

1. Shopify-productpipeline

# Haal nieuwe producten op uit Shopify → bewerk → zet terug
for product in new_products:
    for image_url in product.images:
        edited = edit_image_url(image_url, BRAND_PROMPT)
        upload_to_shopify(product.id, edited)

Bekijk de gids voor productfoto's voor promptideeën.

2. Automatisering van vastgoedvermeldingen

# Verbeter nieuwe listingfoto's automatisch
for photo in listing.photos:
    if photo.type == "exterior":
        edited = edit_image(photo.path, "Replace sky with blue clear sky, brighten")
    elif photo.type == "interior_empty":
        edited = edit_image(photo.path, "Stage in modern Scandinavian style")
    save_to_mls(edited)

Bekijk de gids voor virtuele staging voor prompttemplates.

3. Pipeline voor sociale-media-inhoud

# Genereer varianten voor meerdere platforms per post
for source_image in incoming_posts:
    instagram = edit_image(source_image, "Bright airy Instagram aesthetic")
    tiktok = edit_image(source_image, "High-energy saturated TikTok look")
    linkedin = edit_image(source_image, "Clean corporate LinkedIn tones")
    publish_to_platforms(instagram, tiktok, linkedin)

Bekijk de gids voor sociale media.

Kosten bijhouden

Elke API-aanroep trekt 1 credits af. Houd je uitgaven programmatisch bij:

def get_credit_balance():
    response = requests.get(
        "https://api.arteza.ai/v1/account/credits",
        headers={"Authorization": f"Bearer {API_KEY}"},
    )
    return response.json()["balance"]

print(f"Resterende credits: {get_credit_balance()}")

Prijzen

Maandelijkse credits worden vernieuwd bij elke factuurcyclus. Bijgekochte credits verlopen nooit. Volledige prijzen.

Controlelijst voor productie

• API-sleutel veilig opgeslagen (omgevingsvariabele of secret manager)
• Herprobeervolglogica met exponentiële backoff
• Foutregistratie en waarschuwingen
• Bewaking van creditsaldo
• Gelijktijdigheid rekening houdend met limieten
• Validatie van invoerbeeldgrootte (<2048px)
• Uitvoeropslag (CDN, S3, enz.)
• Prompttemplates geversioneerd in git

Volgende stappen

• Volledige gids voor Seedream 5.0 Edit
• Workflows voor productfotografie
• Automatisering voor vastgoed
• Variaties op schaal maken

Haal je API-sleutel gratis op → - gratis credits bij aanmelding, geen creditcard vereist.