Seedream 5.0 Edit API: programmatisk bildredigering

Webgränssnitt är utmärkta för enstaka redigeringar. API:er är hur du redigerar 10 000 bilder över natten. Seedream 5.0 Edit API ger dig programmatisk åtkomst till samma modell för naturspråksredigering som driver Arteza-plattformen, till samma $0,10 per redigering. Den här guiden går igenom autentisering, endpoints, Python- och JavaScript-exempel, batchmönster och bästa praxis för produktion.

När du ska använda API:et kontra webgränssnittet

Använd webgränssnittet när:

• Du redigerar 1-20 bilder manuellt
• Du vill iterera visuellt
• Du utforskar kreativa riktningar

Använd API:et när:

• Du redigerar 50+ bilder
• Du bygger en produkt som redigerar bilder
• Du behöver konsekventa prompter över ett batch
• Du vill integrera redigering i en befintlig pipeline (Lightroom-export, Shopify, CMS osv.)

Autentisering

API:et använder bearer token-autentisering. Hämta din API-nyckel från Arteza dashboard efter registrering.

# Spara din nyckel som en miljövariabel
export SEEDANCE_API_KEY="your_api_key_here"

Lägg aldrig in API-nycklar i git. Använd miljövariabler, hemliga hanterare eller .env-filer.

Redigerings-endpointen

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

Obligatoriska parametrar:

Valfria parametrar:

Varje lyckat anrop drar av 1 krediter.

Python-exempel

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

# Användning
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-exempel

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

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

cURL-exempel

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

Vill du ha resultat som det här? Prova Seedream 5.0 Edit gratis →

Mönster för batchbearbetning

Det ultimata användningsfallet för API:et är batch. Här är ett produktionsklart Python-mönster:

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

# Redigera 100 produktfoton med samma prompt
process_batch(
    image_dir="./raw_products",
    prompt="Replace background with pure white studio, soft shadow beneath",
    output_dir="./edited_products",
    workers=4,
)

Prestanda: med 4 workers tar 100 bilder ungefär 3-5 minuter totalt. Kostnad: 100 x 1 kredit = 100 krediter = $10 totalt.

Felhantering

API:et returnerar standardiserade HTTP-statuskoder:

Mönster för återförsök

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

Webhook-arbetsflöde för stora batchar

För jobb med tusentals bilder, använd webhooks för att undvika lång polling:

# Skicka in ett jobb med en 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 POSTar resultaten till din webhook när jobbet är klart

Hastighetsgränser

Om du behöver högre gränser, kontakta support via din instrumentpanel.

Vanliga produktionsmönster

1. Shopify-produktpipeline

# Hämta nya produkter från Shopify → redigera → ladda upp tillbaka
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)

Se guide för produktfoton för promptidéer.

2. Automatisering av fastighetsannonser

# Förbättra automatiskt nya annonsfotografier
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)

Se guide för virtuell homestaging för promptmallar.

3. Pipeline för innehåll i sociala medier

# Generera varianter för flera plattformar av varje inlägg
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)

Se guide för sociala medier.

Kostnadsspårning

Varje API-anrop drar av 1 krediter. Spåra dina utgifter programmatiskt:

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"Återstående krediter: {get_credit_balance()}")

Prissättning

Månadskrediter förnyas varje faktureringscykel. Påfyllnadskrediter går aldrig ut. Fullständiga priser.

Checklista för produktion

• API-nyckel lagrad säkert (miljövariabel eller hemlig hanterare)
• Logik för återförsök med exponentiellt backoff
• Felloggning och varningar
• Övervakning av kreditsaldo
• Samtidighet anpassad till hastighetsgränser
• Validering av indatabildens storlek (<2048px)
• Lagring av utdata (CDN, S3 osv.)
• Promptmallar versionshanterade i git

Nästa steg

• Fullständig guide för Seedream 5.0 Edit
• Arbetsflöden för produktfotografering
• Automatisering för fastigheter
• Skapa varianter i stor skala

Hämta din API-nyckel gratis → - gratiskrediter vid registrering, inget kort krävs.