Seedream 5.0 Edit API: Programmatische Bildbearbeitung

Web-UIs eignen sich hervorragend für einzelne Bearbeitungen. APIs sind das Mittel der Wahl, wenn du 10.000 Bilder über Nacht bearbeitest. Die Seedream 5.0 Edit API bietet programmatischen Zugriff auf dasselbe Modell für natürlichsprachige Bearbeitung, das die Arteza-Plattform antreibt, zum gleichen Preis von $0,10 pro Bearbeitung. Dieser Leitfaden führt dich durch Authentifizierung, Endpunkte, Python- und JavaScript-Beispiele, Batch-Muster und Best Practices für den Produktionseinsatz.

Kurzzusammenfassung

• Programmatischer Zugriff auf Seedream 5.0 Edit für $0,10 pro Bearbeitung (1 Credits)
• REST-API mit JSON-Antworten, 5-15 Sekunden Generierungszeit
• Python- und JavaScript-Beispiele inklusive
• Für Batch-Workflows konzipiert, verarbeite Tausende von Bildern pro Job
• 10 Gratis-Credits zum Testen auf arteza.ai

Wann die API und wann die Web-UI einsetzen

Nutze die Web-UI, wenn:

• Du 1-20 Bilder manuell bearbeitest
• Du visuell iterieren möchtest
• Du kreative Richtungen erkundest

Nutze die API, wenn:

• Du 50+ Bilder bearbeitest
• Du ein Produkt entwickelst, das Bilder bearbeitet
• Du einheitliche Prompts über einen Batch hinweg benötigst
• Du die Bildbearbeitung in eine bestehende Pipeline integrieren möchtest (Lightroom-Export, Shopify, CMS usw.)

Authentifizierung

Die API verwendet Bearer-Token-Authentifizierung. Hole dir deinen API-Schlüssel aus dem Arteza-Dashboard nach der Registrierung.

# Schlüssel als Umgebungsvariable speichern
export SEEDANCE_API_KEY="your_api_key_here"

Committe niemals API-Schlüssel in Git. Verwende Umgebungsvariablen, Secret-Manager oder .env-Dateien.

Der Bearbeitungs-Endpunkt

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

Pflichtparameter:

Optionale Parameter:

Jeder erfolgreiche Aufruf zieht 1 Credits ab.

Python-Beispiel

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

# Verwendung
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-Beispiel

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;
}

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

cURL-Beispiel

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

Solche Ergebnisse gewünscht? Seedream 5.0 Edit kostenlos testen →

Batch-Verarbeitungsmuster

Der wichtigste Anwendungsfall für die API ist die Batch-Verarbeitung. Hier ist ein produktionsreifes Python-Muster:

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

# 100 Produktfotos mit demselben Prompt bearbeiten
process_batch(
    image_dir="./raw_products",
    prompt="Replace background with pure white studio, soft shadow beneath",
    output_dir="./edited_products",
    workers=4,
)

Leistung: Mit 4 Workern dauern 100 Bilder insgesamt etwa 3-5 Minuten. Kosten: 100 x 1 Credit = 100 Credits = insgesamt $10.

Fehlerbehandlung

Die API gibt standardmäßige HTTP-Statuscodes zurück:

Wiederholungsmuster

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  # exponentielles Backoff: 1s, 2s, 4s
                time.sleep(wait)
                continue
            raise
    raise Exception("Max retries exceeded")

Webhook-Workflow für große Batches

Verwende bei Jobs mit Tausenden von Bildern Webhooks, um langes Polling zu vermeiden:

# Job mit einer Webhook-URL einreichen
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 sendet die Ergebnisse per POST an deinen Webhook, wenn der Job abgeschlossen ist

Rate-Limits

Wenn du höhere Limits benötigst, wende dich über dein Dashboard an den Support.

Häufige Produktionsmuster

1. Shopify-Produkt-Pipeline

# Neue Produkte aus Shopify ziehen → bearbeiten → zurückspielen
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)

Prompt-Ideen findest du im Leitfaden für Produktfotos.

2. Automatisierung von Immobilienanzeigen

# Neue Anzeigenfotos automatisch aufwerten
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)

Prompt-Vorlagen findest du im Leitfaden für virtuelles Staging.

3. Social-Media-Content-Pipeline

# Mehrere Plattformvarianten jedes Beitrags generieren
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)

Mehr dazu im Leitfaden für soziale Medien.

Kostenüberwachung

Jeder API-Aufruf zieht 1 Credits ab. Verfolge deine Ausgaben programmatisch:

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"Verbleibende Credits: {get_credit_balance()}")

Preise

Monatliche Credits erneuern sich mit jedem Abrechnungszeitraum. Aufgeladene Credits verfallen nie. Vollständige Preisübersicht.

Checkliste für den Produktionseinsatz

• API-Schlüssel sicher gespeichert (Umgebungsvariable oder Secret-Manager)
• Wiederholungslogik mit exponentiellem Backoff
• Fehlerprotokollierung und Benachrichtigungen
• Überwachung des Credit-Guthabens
• Rate-Limit-bewusste Parallelverarbeitung
• Validierung der Eingabebildgröße (<2048px)
• Ausgabe-Speicherung (CDN, S3 usw.)
• Prompt-Vorlagen versioniert in Git

Nächste Schritte

• Vollständiger Leitfaden zu Seedream 5.0 Edit
• Workflows für die Produktfotografie
• Automatisierung in der Immobilienbranche
• Variationen in großem Maßstab erstellen

API-Schlüssel kostenlos holen →, Gratis-Credits bei der Anmeldung, keine Kreditkarte erforderlich.