Seedream v4.5 Edit API: programmatisk bildredigering

Att köra Seedream v4.5 Edit via Arteza-gränssnittet fungerar bra för enstaka redigeringar och mindre volymer. För arbetsflöden med hög volym, som kataloger med tusentals SKU:er, dynamisk bildgenerering per användare eller CMS-drivna resurspipelines, vill du ha API-åtkomst. Den här guiden går igenom endpointstruktur, begäransparametrar, responshantering och produktionsmönster för att bygga automatiserade bildredigeringssystem med Seedream v4.5.

Varför använda API:et

API:et låser upp automationsmönster som gränssnittet inte kan matcha:

• Batchbearbetning i hög volym. Bearbeta 1 000+ redigeringar i en enda pipeline-körning.
• Dynamisk generering. Bygg bilder on-demand från användardata eller databasposter.
• Schemalagda arbetsflöden. Nattliga kataloguppdateringar, händelseutlöst regenerering.
• Integration med befintliga system. Node.js, Python, Go, Ruby, vilken HTTP-klient som helst.
• Reproducerbar produktion. Versionshanterade skript i stället för manuella klick.

Om ditt användningsfall involverar mer än 20-50 liknande redigeringar är API:et värt installationsarbetet.

Endpointstruktur

Seedream v4.5 Edit-modellen är tillgänglig på:

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

Det här är en standard fal.ai-modellendpoint som kan anropas direkt eller via Artezas kreditsystem.

Autentisering

Arteza API-förfrågningar autentiseras via en API-nyckel som skickas i Authorization-headern som en Bearer-token.

Hämta din API-nyckel

1. Logga in på arteza.ai
2. Navigera till dina kontoinställningar
3. Hitta API-sektionen
4. Generera en ny API-nyckel
5. Förvara den säkert, behandla den som ett lösenord

Lägg aldrig in din API-nyckel i källkodshantering. Använd miljövariabler:

export SEEDANCE_API_KEY="your_api_key_here"

Autentiseringsheader

Authorization: Bearer your_api_key_here

Begäransstruktur

En grundläggande Seedream v4.5 Edit-förfrågan ser ut så här:

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

Parameterreferens

Upp till 10 bild-URL:er kan skickas in. Modellen behandlar den första bilden som primär och efterföljande bilder som referenser.

Exempelförfrågan: 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);

Exempelförfrågan: 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

Ett lyckat svar innehåller de genererade bild-URL:erna:

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

Ladda ned bilden från den returnerade URL:en, utdata-URL:er är giltiga i 24 timmar.

Asynkront genereringsmönster

Seedream v4.5 Edit tar 30-60 sekunder per förfrågan. I produktion vill du troligtvis använda asynkron generering med webhooks eller polling i stället för blockerande förfrågningar.

Webhook-baserad asynkronisering

Skicka med en webhook_url i din förfrågan och Arteza skickar ett POST-anrop med resultatet till den när genereringen är klar:

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

Din webhook-hanterare tar emot:

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

Webhook-hantering är det rekommenderade produktionsmönstret.

Börja bygga. Prova verktyget först.

Polling-baserad asynkronisering

Om din infrastruktur inte kan ta emot webhooks kan du använda polling för att kontrollera 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;
}

Polla var 5-10 sekunder. Total väntetid är vanligtvis 30-60 sekunder.

Produktionsmönster

Mönster 1: Batchgenerering för kataloger

Kör API:et över din produktkatalog för att generera enhetliga bakgrundsbyten för varje 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"])

Kombinera med en webhook-hanterare som sparar utdata till ditt CDN och uppdaterar produktposten.

Mönster 2: On-demand-redigering för användare

Låt användare ladda upp bilder och få AI-redigerade resultat on-demand:

1. Användaren laddar upp en bild till din bucket
2. Din backend anropar Seedream v4.5 Edit med en användarvald prompt
3. Polla eller invänta webhook
4. Returnera resultat-URL:en till användarens klient

Räkna med cirka 60 sekunders väntetid per redigering i din UX.

Mönster 3: CMS-driven resurspipeline

När innehåll publiceras i ditt CMS genereras tillhörande bilder automatiskt:

1. CMS skickar ut en publiceringshändelse
2. En serverlös funktion triggas
3. Anropar Seedream v4.5 Edit med en mallprompt
4. Lagrar resultatet på CDN
5. Uppdaterar CMS-posten med bild-URL:en

Det här mönstret eliminerar manuellt bildskapande vid publicering i hög volym.

Felhantering

Vanliga felsvar:

Omslut alltid API-anrop med try/except och retry-logik för 429- och 500-svar.

Hastighetsgränser

Arteza tillämpar rimliga hastighetsgränser på API:et. För de flesta produktionsarbetsflöden når du dem inte, men för massbatcher med 1 000+ förfrågningar bör du implementera:

• Exponentiell backoff vid 429-svar
• Begränsning av parallella förfrågningar (börja med 5 parallella, justera uppåt)
• Köhantering av förfrågningar för förutsägbart genomflöde

Kontakta supporten för högre hastighetsgränser vid tunga produktionsarbetsbelastningar.

Kostnad vid API-volym

API-anrop kostar samma som anrop via gränssnittet: 1 krediter ($0,10) per bild. För planeringsändamål:

• 100 API-anrop = 100 krediter (väl inom $5 Starter-planen)
• 1 000 API-anrop = 1 000 krediter ($120 Studio-planen, 1 800 i månaden)
• 10 000 API-anrop = 10 000 krediter ($120 Studio-planen plus ungefär 8 200 krediter i påfyllningar)

För volymer över 10 000 per månad, kontakta teamet för anpassad prissättning.

Bästa praxis

1. Använd webhooks i produktion. Polling fungerar men slösar resurser.
2. Lagra prompts i versionshantering. Behandla prompts som kod.
3. Logga allt. Förfrågnings-ID:n, prompts, utdata och fel.
4. Validera indata innan anrop. Felaktiga bild-URL:er slösar krediter.
5. Övervaka kreditsaldo. Utlös en avisering när du faller under ett tröskelvärde.
6. Testa promptändringar i staging. Validera på 3-5 bilder innan du kör ett helt batch-jobb.
7. Cacha resultat. Om indata är identiska, återanvänd tidigare utdata.

Vidare läsning

• Komplett redigeringsguide för Seedream v4.5
• Handledning för batchredigering
• Prisöversikt

Kom igång

Generera din API-nyckel i Arteza-instrumentpanelen, hämta 10 gratis krediter och kör Node.js-exemplet ovan med en produktbild. API:et låser upp den fulla produktionspotentialen hos Seedream v4.5 Edit. När det väl är kopplat handlar resten om prompt-engineering. Vill du testa manuellt först kan du öppna webbverktyget och validera dina prompts innan du automatiserar.