Seedream v4.5 Edit API: programmatisk billedredigering

At køre Seedream v4.5 Edit via Arteza-brugerfladen fungerer fint til enkeltstående redigeringer og mindre batches. Til arbejdsgange med høj volumen, kataloger med tusindvis af SKU'er, dynamisk billedgenerering pr. bruger og CMS-drevne asset-pipelines, ønsker du API-adgang. Denne guide gennemgår endpointstruktur, anmodningsparametre, responshåndtering og produktionsmønstre til at bygge automatiserede billedredigeringssystemer på Seedream v4.5.

Hvorfor bruge API'et

API'et låser automatiseringsmønstre op, som brugerfladen ikke kan matche:

• Batching i høj volumen. Behandl 1.000+ redigeringer i én enkelt pipeline-kørsel.
• Dynamisk generering. Byg billeder on-demand fra brugerdata eller databaseposter.
• Planlagte arbejdsgange. Nattlige katalogopdateringer, hændelsestriggeret regenerering.
• Integration med eksisterende systemer. Node.js, Python, Go, Ruby, enhver HTTP-klient.
• Reproducerbar produktion. Versionsstyrede scripts i stedet for manuelle klik.

Hvis dit use case involverer mere end 20-50 lignende redigeringer, er API'et investeringen værd.

Endpointstruktur

Seedream v4.5 Edit-modellen er tilgængelig på:

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

Dette er et standard fal.ai-modelendpoint, der kan kaldes direkte eller via Arteza-kreditsystemet.

Godkendelse

Arteza API-anmodninger godkendes via en API-nøgle, der sendes i Authorization-headeren som et Bearer-token.

Sådan får du din API-nøgle

1. Log ind på arteza.ai
2. Gå til dine kontoindstillinger
3. Find API-sektionen
4. Generer en ny API-nøgle
5. Opbevar den sikkert, behandl den som en adgangskode

Commit aldrig din API-nøgle til versionsstyring. Brug miljøvariabler:

export SEEDANCE_API_KEY="your_api_key_here"

Godkendelsesheader

Authorization: Bearer your_api_key_here

Anmodningsstruktur

En grundlæggende Seedream v4.5 Edit-anmodning ser sådan ud:

{
  "prompt": "Replace the background with a polished marble surface. Preserve the product position, color, and lighting exactly. Add a subtle contact shadow.",
  "image_urls": [
    "https://your-bucket.com/product-shot.jpg"
  ],
  "num_images": 1,
  "output_format": "png"
}

Parameterreference

Op til 10 billed-URL'er kan sendes. Modellen behandler det første billede som det primære og efterfølgende billeder som referencer.

Eksempelanmodning: 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: "Replace the background with a polished marble surface. Preserve the product position, color, and lighting exactly.",
    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);

Eksempelanmodning: 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": "Replace the background with a polished marble surface. Preserve the product position, color, and lighting exactly.",
        "image_urls": [
            "https://your-bucket.com/product-shot.jpg"
        ],
        "num_images": 1,
        "output_format": "png"
    }
)

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

Responsstruktur

Et vellykket svar indeholder de genererede billed-URL'er:

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

Download billedet fra den returnerede URL. Output-URL'er er gyldige i 24 timer.

Asynkront genereringsmønster

Seedream v4.5 Edit tager 30-60 sekunder pr. anmodning. Til produktion ønsker du sandsynligvis asynkron generering med webhooks eller polling i stedet for blokerende anmodninger.

Webhook-baseret asynkron

Send en webhook_url i din anmodning, og Arteza vil POST'e resultatet til den, når genereringen er færdig:

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

Din webhook-handler modtager:

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

Webhook-håndtering er det anbefalede produktionsmønster.

Begynd at bygge. Prøv værktøjet først.

Polling-baseret asynkron

Hvis din infrastruktur ikke kan modtage webhooks, kan du polle for 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 for completion
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 hvert 5-10 sekund. Den samlede ventetid er normalt 30-60 sekunder.

Produktionsmønstre

Mønster 1: Katalog-batchgenerering

Kør API'et over dit produktkatalog for at generere ensartede baggrundsudskiftninger for hvert SKU:

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

Kombiner med en webhook-handler, der gemmer output til dit CDN og opdaterer produktposten.

Mønster 2: On-demand brugerredigeringer

Lad brugere uploade billeder og få AI-redigerede resultater on-demand:

1. Brugeren uploader et billede til din bucket
2. Din backend kalder Seedream v4.5 Edit med en brugerdefineret prompt
3. Poll eller afvent webhook
4. Returner resultat-URL'en til brugerens klient

Beregn ca. 60 sekunders ventetid pr. redigering i din UX.

Mønster 3: CMS-drevet asset-pipeline

Når indhold publiceres i dit CMS, genereres tilhørende billeder automatisk:

1. CMS udsender en publiceringshændelse
2. Serverless-funktion trigges
3. Kalder Seedream v4.5 Edit med en skabelonprompt
4. Gemmer resultatet på CDN
5. Opdaterer CMS-posten med billed-URL'en

Dette mønster eliminerer manuel billedoprettelse ved publicering med høj volumen.

Fejlhåndtering

Almindelige fejlsvar:

Ombryd altid API-kald i try/except med retry-logik for 429- og 500-svar.

Hastighedsgrænser

Arteza anvender rimelige hastighedsgrænser på API'et. For de fleste produktionsarbejdsgange vil du ikke ramme dem, men ved massesbatches med 1.000+ anmodninger bør du implementere:

• Eksponentiel backoff ved 429-svar
• Grænser for samtidige anmodninger (start med 5 parallelle, juster opad)
• Anmodningskø for forudsigelig gennemstrømning

Kontakt support for højere hastighedsgrænser ved tunge produktionsbelastninger.

Omkostninger ved API-volumen

API-kald koster det samme som kald via brugerfladen: 1 kreditter ($0,10) pr. billede. Til planlægningsformål:

• 100 API-kald = 100 kreditter (godt inden for $5 Starter-planen)
• 1.000 API-kald = 1.000 kreditter ($120 Studio-planen, 1.800 om måneden)
• 10.000 API-kald = 10.000 kreditter ($120 Studio-planen plus ca. 8.200 kreditter i påfyldninger)

For volumener over 10.000 pr. måned skal du kontakte teamet for tilpassede priser.

Bedste praksis

1. Brug webhooks i produktion. Polling virker, men spilder ressourcer.
2. Gem prompts i versionsstyring. Behandl prompts som kode.
3. Log alt. Anmodnings-ID'er, prompts, output, fejl.
4. Valider input, før du kalder API'et. Dårlige billed-URL'er spilder kreditter.
5. Overvåg kreditbalancen. Sæt en alarm, når du falder under en grænse.
6. Test promptændringer i staging. Valider på 3-5 billeder, inden du kører en fuld batch.
7. Cache resultater. Genanbring tidligere output, hvis inputene er identiske.

Videre læsning

• Komplet Seedream v4.5 redigeringsguide
• Vejledning til batchredigering
• Prisoversigt

Kom i gang

Generer din API-nøgle i Arteza-dashboardet, hent 10 gratis kreditter, og kør Node.js-eksemplet ovenfor med et produktbillede. API'et frigør det fulde produktionspotentiale i Seedream v4.5 Edit. Når du har det koblet op, handler resten om promptudvikling. Til hands-on test kan du starte med åbn webværktøjet og validere dine prompts, inden du automatiserer.