API de edición de Seedream 5.0: edición de imágenes programática

Las interfaces web son ideales para ediciones puntuales. Las APIs son la forma de editar 10.000 imágenes en una sola noche. La API de Seedream 5.0 Edit te da acceso programático al mismo modelo de edición en lenguaje natural que impulsa la plataforma Arteza, al mismo precio de $0,10 por edición. Esta guía explica la autenticación, los endpoints, ejemplos en Python y JavaScript, patrones de procesamiento en lote y buenas prácticas para producción.

Resumen rápido

• Acceso programático a Seedream 5.0 Edit a $0,10 por edición (1 créditos)
• API REST con respuestas JSON, generación en 5-15 segundos
• Ejemplos en Python y JavaScript incluidos
• Diseñada para flujos de trabajo en lote: procesa miles de imágenes por tarea
• 10 créditos gratis para pruebas en arteza.ai

Cuándo usar la API frente a la interfaz web

Usa la interfaz web cuando:

• Editas entre 1 y 20 imágenes de forma manual
• Quieres iterar visualmente
• Estás explorando direcciones creativas

Usa la API cuando:

• Editas 50 imágenes o más
• Estás desarrollando un producto que edita imágenes
• Necesitas prompts consistentes en un lote
• Quieres integrar la edición en un pipeline existente (exportación de Lightroom, Shopify, CMS, etc.)

Autenticación

La API utiliza autenticación por token bearer. Obtén tu clave de API desde el Panel de Arteza después de registrarte.

# Guarda tu clave como variable de entorno
export SEEDANCE_API_KEY="your_api_key_here"

Nunca incluyas claves de API en git. Usa variables de entorno, gestores de secretos o archivos .env.

El endpoint de edición

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

Parámetros obligatorios:

Parámetros opcionales:

Cada llamada exitosa deduce 1 créditos.

Ejemplo en 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

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

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

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

Ejemplo con cURL

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

¿Quieres resultados como estos? Prueba Seedream 5.0 Edit gratis →

Patrón de procesamiento en lote

El caso de uso estrella de la API es el procesamiento en lote. Aquí tienes un patrón Python listo para producción:

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

# Editar 100 fotos de producto con el mismo prompt
process_batch(
    image_dir="./raw_products",
    prompt="Replace background with pure white studio, soft shadow beneath",
    output_dir="./edited_products",
    workers=4,
)

Rendimiento: con 4 workers, 100 imágenes tardan aproximadamente 3-5 minutos en total. Coste: 100 x 1 crédito = 100 créditos = $10 en total.

Gestión de errores

La API devuelve códigos de estado HTTP estándar:

Patrón de reintento

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  # retroceso exponencial: 1s, 2s, 4s
                time.sleep(wait)
                continue
            raise
    raise Exception("Número máximo de reintentos superado")

Flujo de trabajo con webhooks para lotes grandes

Para tareas con miles de imágenes, usa webhooks para evitar el sondeo prolongado:

# Enviar una tarea con una 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 enviará los resultados a tu webhook cuando la tarea se complete

Límites de velocidad

Si necesitas límites más altos, contacta con soporte desde tu panel de control.

Patrones comunes en producción

1. Pipeline de productos en Shopify

# Obtener nuevos productos de Shopify → editar → volver a subir
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)

Consulta el guía de fotos de productos para ideas de prompts.

2. Automatización de listados inmobiliarios

# Mejorar automáticamente las fotos de nuevos listados
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)

Consulta el guía de staging virtual para plantillas de prompts.

3. Pipeline de contenido para redes sociales

# Generar variantes para múltiples plataformas de cada publicación
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)

Consulta el guía de redes sociales.

Seguimiento del coste

Cada llamada a la API deduce 1 créditos. Controla tu gasto de forma programática:

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éditos restantes: {get_credit_balance()}")

Precios

Los créditos mensuales se renuevan cada ciclo de facturación. Los créditos de recarga nunca caducan. Precios completos.

Lista de verificación para producción

• Clave de API almacenada de forma segura (variable de entorno o gestor de secretos)
• Lógica de reintento con retroceso exponencial
• Registro y alertas de errores
• Monitorización del saldo de créditos
• Concurrencia consciente del límite de velocidad
• Validación del tamaño de imagen de entrada (<2048px)
• Almacenamiento de salida (CDN, S3, etc.)
• Plantillas de prompts versionadas en git

Próximos pasos

• Guía completa de Seedream 5.0 Edit
• Flujos de trabajo de fotografía de productos
• Automatización para bienes raíces
• Creación de variaciones a escala

Obtén tu clave API gratis →: créditos gratis al registrarte, sin necesidad de tarjeta.