Seedream 5.0 Flash API

ByteDance Seedream 5.0 Flash: generación y edición de imágenes rápida y económica con hasta 10 referencias, mismo precio en 1K y 2K

1K
APIMart 0,0137 $ / imagen
2K
APIMart 0,0137 $ / imagen

Comparar precios

Compara los precios públicos de los proveedores para la misma especificación de salida

Comparar otros modelos
Especificación de salidaProveedoresPrecio publicado del proveedorTiempo típicoProbar
1K
KIE
0,0162 $ / imagen
Probar
APIMart
0,0137 $ / imagen
Tiempo típico 12 s
12 sProbar
2K
KIE
0,0162 $ / imagen
Probar
APIMart
0,0137 $ / imagen
Tiempo típico 17 s
17 sProbar

Enrutamiento automático y failover

Llama a Seedream 5.0 Flash con un solo ID de modelo y Yir elige el canal de cada tarea entre APIMart y KIE: la envía al canal disponible con el precio estimado más bajo y la cobra al precio público de ese canal, sin recargo. Si un intento falla, lo reintenta en otro canal sin superar tu max_cost. No necesitas parámetros de enrutamiento en tu solicitud. Documentación de enrutamiento y failover

Notas de precios

Se cobra según el proveedor que realmente ejecuta la tarea. El failover puede cambiar de proveedor, lo que puede modificar el costo y el tiempo.

Usar la API

Deja el código a un agente de programación, genera en el chat con MCP o la Skill, o intégralo tú mismo con el SDK o la API compatible con OpenAI.

Deja que un agente de programación lo integre

Copia el prompt de integración o ábrelo directamente en Codex o Claude. El agente lee esta página y el contrato del modelo, y luego escribe en tu proyecto el envío, la espera y el manejo de resultados.

Añade el servidor MCP de Yir

Conéctalo a ChatGPT, Claude o Cursor, menciona @Yir y pide Seedream 5.0 Flash por su nombre. Primero te da el precio y solo genera cuando confirmas.

https://gateway.yir.ai/mcp
Pasos para cada cliente

Un comando para Claude Code

Crea una API key en la consola, guárdala como YIR_API_KEY y ejecuta:

claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"

Instala la Skill de Yir

Define YIR_API_KEY donde se ejecuta tu agente, añade la Skill a Claude Code, Codex u otro agente de programación y di “usa Seedream 5.0 Flash en Yir para crear…”.

npx skills add yir-ai/skills
Sobre la Skill de Yir

Instala el SDK oficial con tu gestor de paquetes o copia el fragmento de código de abajo para empezar

$pnpm add @yir-ai/sdk
import { createNodeYirClient } from "@yir-ai/sdk/server";
 
// Lee YIR_API_KEY del entorno por defecto: process.env.YIR_API_KEY
const client = createNodeYirClient();
 
// 1. Envía una tarea de generación de imagen
const job = await client.submitImage({
model: "bytedance/seedream-5.0-flash",
input: {
type: "text",
prompt: "Crea un póster de producto de agua con gas de cítricos: una botella de vidrio transparente y naranjas frescas, fondo crema, luz natural suave y una etiqueta de producto nítida",
},
parameters: {
resolution: "2K",
aspect_ratio: "1:1",
n: 1,
},
});
 
// 2. Espera a que la tarea termine y entregue el resultado
const result = await client.waitForJob(job.id);
console.log("Archivos entregados:", result.result);
if (result.result && "files" in result.result) {
for (const file of result.result.files) {
console.log("->", file.url);
}
}

Los proyectos que ya usan el protocolo de OpenAI, o gateways como new-api, solo necesitan una nueva Base URL y una nueva clave. Guía de compatibilidad con OpenAI

base_url del SDK de OpenAI
https://gateway.yir.ai/openai/v1
Base URL del canal en new-api
https://gateway.yir.ai/openai
Clave
API Key de Yir
ID del modelo
bytedance/seedream-5.0-flash
curl https://gateway.yir.ai/openai/v1/images/generations \
  -H "Authorization: Bearer $YIR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedream-5.0-flash",
    "prompt": "Crea un póster de producto de agua con gas de cítricos: una botella de vidrio transparente y naranjas frescas, fondo crema, luz natural suave y una etiqueta de producto nítida",
    "resolution": "2K",
    "aspect_ratio": "1:1"
  }'

Resumen de parámetros

Parámetros comunes; los límites dependen del modelo actual y del proveedor seleccionado

Documentación de la API
Resolución
resolution
  • 1K
  • 2K

Nivel de resolución de salida. Las resoluciones más altas dan mayor nitidez y el precio aumenta en consecuencia

Relación de aspecto
aspect_ratio
  • 1:1
  • 4:3
  • 3:4
  • 16:9
  • 9:16
  • 3:2
  • 2:3
  • 2:1
  • 1:2
  • 21:9

Proporción geométrica. Elígela según el medio de destino (vertical, banner o cuadrado)

Modo de entrada
input_mode
  • Entrada de texto
  • Entrada de imagen

Los límites y formatos de las referencias dependen del modelo y del proveedor seleccionado

Referencias
references
  • reference_image ≤ 10

Los límites por modo dependen del proveedor elegido. Las cantidades de la tabla son ejemplos de precio, no límites ni cuotas gratuitas.

Preguntas frecuentes

Empieza a crear con Seedream 5.0 Flash

Compara la misma especificación entre proveedores y llama a varios proveedores desde una sola billetera.