API d'édition Seedream 5.0 : édition d'images par programmation

Les interfaces web sont idéales pour les modifications ponctuelles. Les API, c'est ce qui vous permet de modifier 10 000 images en une nuit. L'API Seedream 5.0 Edit vous offre un accès programmatique au même modèle d'édition en langage naturel qui alimente la plateforme Arteza, au même tarif de $0,10 par modification. Ce guide présente l'authentification, les endpoints, des exemples Python et JavaScript, les modèles de traitement par lots et les bonnes pratiques en production.

En bref

• Accès programmatique à Seedream 5.0 Edit à $0,10 par modification (1 crédits)
• API REST avec réponses JSON, génération en 5 à 15 secondes
• Exemples Python et JavaScript inclus
• Conçue pour les workflows par lots : traitez des milliers d'images par tâche
• 10 crédits gratuits pour tester sur arteza.ai

Quand utiliser l'API plutôt que l'interface web

Utilisez l'interface web quand :

• Vous modifiez 1 à 20 images manuellement
• Vous souhaitez itérer visuellement
• Vous explorez des directions créatives

Utilisez l'API quand :

• Vous modifiez 50 images ou plus
• Vous construisez un produit qui modifie des images
• Vous avez besoin de prompts cohérents sur un lot
• Vous voulez intégrer l'édition dans un pipeline existant (export Lightroom, Shopify, CMS, etc.)

Authentification

L'API utilise l'authentification par jeton Bearer. Obtenez votre clé API depuis le Tableau de bord Arteza après votre inscription.

# Stockez votre clé dans une variable d'environnement
export SEEDANCE_API_KEY="your_api_key_here"

Ne commitez jamais vos clés API dans git. Utilisez des variables d'environnement, des gestionnaires de secrets ou des fichiers .env.

L'endpoint d'édition

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

Paramètres obligatoires :

Paramètres optionnels :

Chaque appel réussi déduit 1 crédits.

Exemple Python

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

# Utilisation
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)

Exemple JavaScript / Node.js

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

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

Exemple cURL

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

Vous voulez des résultats comme ceux-ci ? Essayer Seedream 5.0 Edit gratuitement →

Modèle de traitement par lots

Le cas d'usage idéal de l'API, c'est le traitement par lots. Voici un modèle Python prêt pour la production :

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

# Modifier 100 photos produit avec le même prompt
process_batch(
    image_dir="./raw_products",
    prompt="Replace background with pure white studio, soft shadow beneath",
    output_dir="./edited_products",
    workers=4,
)

Performance : avec 4 workers, 100 images prennent environ 3 à 5 minutes au total. Coût : 100 x 1 crédit = 100 crédits = 10 dollars au total.

Gestion des erreurs

L'API renvoie des codes de statut HTTP standard :

Modèle de nouvelle tentative

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  # backoff exponentiel : 1s, 2s, 4s
                time.sleep(wait)
                continue
            raise
    raise Exception("Nombre maximal de tentatives dépassé")

Workflow par webhook pour les grands lots

Pour les tâches comportant des milliers d'images, utilisez des webhooks afin d'éviter le long polling :

# Soumettre une tâche avec une URL de webhook
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 enverra les résultats en POST à votre webhook une fois la tâche terminée

Limites de débit

Si vous avez besoin de limites plus élevées, contactez le support depuis votre tableau de bord.

Modèles courants en production

1. Pipeline produit Shopify

# Récupère les nouveaux produits depuis Shopify → modifie → renvoie
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)

Consultez le guide photos de produits pour des idées de prompts.

2. Automatisation des annonces immobilières

# Améliore automatiquement les nouvelles photos d'annonces
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)

Consultez le guide de home staging virtuel pour des modèles de prompts.

3. Pipeline de contenu pour les réseaux sociaux

# Génère des variantes multi-plateformes pour chaque publication
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)

Consultez le guide réseaux sociaux.

Suivi des coûts

Chaque appel API déduit 1 crédits. Suivez vos dépenses de manière programmatique :

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"Crédits restants : {get_credit_balance()}")

Tarification

Les crédits mensuels sont renouvelés à chaque cycle de facturation. Les crédits rechargés n'expirent jamais. Tarifs complets.

Liste de contrôle pour la production

• Clé API stockée de manière sécurisée (variable d'environnement ou gestionnaire de secrets)
• Logique de nouvelle tentative avec backoff exponentiel
• Journalisation des erreurs et alertes
• Surveillance du solde de crédits
• Concurrence respectueuse des limites de débit
• Validation de la taille des images en entrée (<2048 px)
• Stockage des sorties (CDN, S3, etc.)
• Modèles de prompts versionnés dans git

Prochaines étapes

• Guide complet de Seedream 5.0 Edit
• Flux de travail pour la photographie de produits
• Automatisation immobilière
• Créer des variantes à grande échelle

Obtenez votre clé API gratuitement → : crédits gratuits à l'inscription, sans carte bancaire requise.