Saltar al contenido
PlaygroundDocumentaciónObtener clave de API

API de Mage · Modelo de imagen

API de Seedream

Seedream, con un filtro estricto

Obtén una clave de APIPrueba Seedream en el playground
POST https://api.mage.space/v1/seedream/generate

De un vistazo

La API de Seedream ejecuta Seedream 5.5 y otras 5 variantes a través de Mage en POST https://api.mage.space/v1/seedream/generate. Una solicitud con los ajustes predeterminados cuesta 42 Gems (unos 0,042 $), sin suscripción. Seedream admite personajes guardados y referencias mediante @handle en el prompt.

  • ImagenResultado
  • 6Variantes
  • 42Gems por imagen, por defecto
  • $0.042Aprox., en USD

Resumen

Qué hace la API de Seedream

Seedream de ByteDance, desde Seedream 5.0 Flash para borradores hasta Seedream 5.5, el más reciente y el predeterminado, con escenas detalladas, texto legible y ediciones a partir de hasta 10 referencias o Characters, hasta 4K en Seedream 4.5. Filtro estricto: los prompts y las primeras imágenes se revisan antes de cada ejecución.

La familia de imágenes Seedream de ByteDance, para escenas detalladas, texto legible y ediciones a partir de hasta 10 referencias o Characters: Seedream 5.5 (`seedream-5.5`), el más nuevo y el predeterminado, con imágenes más realistas, texto pequeño más nítido y ediciones repetidas más estables; Seedream 5.0 Pro (`seedream-5.0-pro`), el buque insignia anterior; Seedream 5.0 Flash (`seedream-5.0-flash`), un precio único con las imágenes de entrada incluidas, el más bajo en 2K o con imágenes de entrada (Seedream 5.5 cuesta menos para un prompt de 1K sin imágenes); Seedream 5.0 Lite (`seedream-5.0-lite`), hasta 3K; Seedream 4.5 (`seedream-4.5`), hasta 4K; y Seedream 4.0 (`seedream-4.0`). Filtro estricto: Mage revisa el prompt y la primera imagen antes de la ejecución; una solicitud que rechaza falla con `content_blocked` y un motivo, y se reembolsa.

Acepta image y additional_images como entradas.

Inicio rápido

Llama a la API de Seedream

Define MAGE_API_KEY, envía la solicitud a /seedream/generate y consulta status_url hasta que se complete.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seedream/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "seedream-5.5"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('seedream', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'seedream-5.5',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("seedream", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "seedream-5.5",
})

print(request["result"]["url"])

Modelos

Valores de model_id de Seedream

Envía model_id para elegir una variante. Si no lo incluyes, se usa la predeterminada.

model_idNombrePredeterminado
seedream-4.0Seedream 4.0
seedream-4.5Seedream 4.5
seedream-5.0-liteSeedream 5.0 Lite
seedream-5.0-proSeedream 5.0 Pro
seedream-5.0-flashSeedream 5.0 Flash
seedream-5.5Seedream 5.5Sí

Opciones

Parámetros de Seedream

Valores permitidos en todas las variantes; una variante puede ofrecer menos. La documentación indica las opciones de cada variante.

CampoValores
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K, 3K, 4K

Entradas

Archivos de entrada que acepta Seedream

Envía cada una como una URL https, una URL de datos o un archivo subido de hasta 100 MB.

CampoRol
imageLa imagen de referencia.
additional_imagesImágenes de referencia adicionales.

Más modelos de imagen

Otras API de generación de imágenes en Mage

Preguntas frecuentes

Preguntas frecuentes

¿Cuánto cuesta la API de Seedream?
Una solicitud de Seedream con los ajustes predeterminados (Seedream 5.5) cuesta 42 Gems, unos 0,042 $. Otras resoluciones, duraciones y variantes cambian el precio; la respuesta indica el cargo exacto. Si una generación falla, se te reembolsa; si la bloquea la política de contenido de Mage, no.
¿Cuál es el endpoint de la API de Seedream?
Haz POST a https://api.mage.space/v1/seedream/generate con un encabezado Authorization: Bearer que lleve tu clave de API de Mage. La respuesta incluye un status_url para consultar el resultado.
¿Qué modelos de Seedream puedo usar?
seedream-4.0 (Seedream 4.0), seedream-4.5 (Seedream 4.5), seedream-5.0-lite (Seedream 5.0 Lite), seedream-5.0-pro (Seedream 5.0 Pro), seedream-5.0-flash (Seedream 5.0 Flash), seedream-5.5 (Seedream 5.5). El predeterminado es Seedream 5.5.
¿Seedream admite imágenes de referencia o personajes?
Seedream acepta image, additional_images. Seedream admite personajes guardados y referencias mediante @handle en el prompt.
¿Puedo usar Seedream desde Claude o ChatGPT?
Sí. Conecta el servidor MCP de Mage a Claude, ChatGPT, Claude Code, Grok o Cursor y pide Seedream por su nombre. Tu asistente consulta sus opciones con get_model y te indica el precio antes de generar.
¿Cuánto tiempo se conservan los resultados de Seedream?
Los resultados y las entradas se conservan durante 30 días. Descarga lo que quieras guardar en tu propio almacenamiento.

Empieza a crear con Mage

Una cuenta, un saldo de Gems, todos los modelos. Paga solo por lo que generes.

Obtén una clave de APIPrueba Seedream en el playground