Seedream 5.0 Edit API: programmatisk billedredigering

Web-brugergrænseflader er gode til enkeltstående redigeringer. API'er er måden, du redigerer 10.000 billeder på en nat. Seedream 5.0 Edit API giver dig programmatisk adgang til den samme naturlige sprogbaserede redigeringsmodel, der driver Arteza-platformen, til den samme $0,10 per redigering. Denne guide gennemgår godkendelse, endepunkter, Python- og JavaScript-eksempler, batchmønstre og bedste praksis til produktion.

Hvornår du skal bruge API'et frem for web-brugergrænsefladen

Brug web-brugergrænsefladen, når:

• Du redigerer 1-20 billeder manuelt
• Du vil iterere visuelt
• Du udforsker kreative retninger

Brug API'et, når:

• Du redigerer 50+ billeder
• Du bygger et produkt, der redigerer billeder
• Du har brug for ensartede prompter på tværs af en batch
• Du vil integrere redigering i en eksisterende pipeline (Lightroom-eksport, Shopify, CMS osv.)

Godkendelse

API'et bruger bearer-token-godkendelse. Hent din API-nøgle fra Arteza dashboard efter tilmelding.

# Gem din nøgle som en miljøvariabel
export SEEDANCE_API_KEY="your_api_key_here"

Commit aldrig API-nøgler til git. Brug miljøvariabler, secret managers eller .env-filer.

Redigerings-endepunktet

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

Påkrævede parametre:

Valgfrie parametre:

Hvert vellykket kald trækker 1 credits.

Python-eksempel

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

# Brug
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-eksempel

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

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

cURL-eksempel

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

Vil du have resultater som dette? Prøv Seedream 5.0 Edit gratis →

Batchbehandlingsmønster

Den vigtigste anvendelse for API'et er batch. Her er et produktionsklar 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}")

# Rediger 100 produktfotos med den samme prompt
process_batch(
    image_dir="./raw_products",
    prompt="Replace background with pure white studio, soft shadow beneath",
    output_dir="./edited_products",
    workers=4,
)

Ydeevne: med 4 workers tager 100 billeder samlet ca. 3-5 minutter. Pris: 100 x 1 credit = 100 credits = $10 i alt.

Fejlhåndtering

API'et returnerer standard HTTP-statuskoder:

Genforsøgsmønster

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

Webhook-arbejdsgang til store batches

Til jobs med tusindvis af billeder kan du bruge webhooks for at undgå lang polling:

# Indsend et job 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 sender resultaterne til din webhook, når jobbet er færdigt

Ratebegrænsninger

Hvis du har brug for højere grænser, skal du kontakte support fra dit dashboard.

Almindelige produktionsmønstre

1. Shopify-produktpipeline

# Hent nye produkter fra Shopify, rediger, og send tilbage
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 til produktfotos for prompt-idéer.

2. Automatisering af ejendomsannoncer

# Forbedre automatisk nye annoncefotos
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 til virtuel boligstaging for prompt-skabeloner.

3. Pipeline til indhold på sociale medier

# Generer varianter til flere platforme af hvert opslag
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 til sociale medier.

Omkostningssporing

Hvert API-kald trækker 1 credits. Spor dit forbrug programmatisk:

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

Prissætning

Månedlige credits fornyes ved hver faktureringscyklus. Påfyldte credits udløber aldrig. Fulde priser.

Tjekliste til produktion

• API-nøgle gemt sikkert (miljøvariabel eller secret manager)
• Genforsøgslogik med eksponentiel backoff
• Fejllogning og advarsler
• Overvågning af creditbalance
• Ratebegrænsningsbevidst parallellitet
• Validering af inputbilledstørrelse (<2048px)
• Outputlagring (CDN, S3 osv.)
• Prompt-skabeloner versioneret i git

Næste skridt

• Komplet guide til Seedream 5.0 Edit
• Arbejdsgange til produktfotografering
• Automatisering til ejendomsbranchen
• Oprettelse af variationer i stor skala

Få din API-nøgle gratis → - gratis credits ved tilmelding, intet betalingskort kræves.