Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Describe the image to generate: subject, composition, style, and lighting. |
resolution | No | Tamaño de salida. Más grande es más nítido y cuesta más. 1k · 2k · Por defecto: 2k |
aspect_ratio | No | La forma del encuadre: horizontal, cuadrado o vertical. 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3 · 4:5 · 5:4 · 21:9 · 9:21 · 2:1 · 1:2 · 3:1 · 1:3 · Por defecto: 1:1 |
output_format | No | Tipo de archivo del resultado. jpeg · png · Por defecto: jpeg |
enable_thinking | No | Run a thinking pass that refines the prompt before generating. Off is faster. Por defecto: true |
Precios
Los precios están en créditos, los mismos que usas en la web (1 crédito = 0,01 $). El importe se retiene cuando se acepta la tarea y se liquida al coste real cuando termina; las tareas fallidas se reembolsan.
| Opción | Créditos por imagen | ≈ USD |
|---|---|---|
| resolution 1K | 5,4 | 0,054 US$ |
| resolution 2K | 10,8 | 0,11 US$ |
Cada tarea se redondea al alza a créditos enteros, así que una ejecución en el nivel más bajo cuesta 6 créditos por imagen (0,06 US$).
Para saber la cifra exacta antes de ejecutar, envía el mismo cuerpo a POST /jobs/quote.
Inicio rápido de la API
Llama a la API de Seedream 5.0 Pro en tres pasos
- Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola de la API. Las claves empiezan por sk-popnow- y usan los mismos créditos que el sitio web.
- Envía la solicitud. Haz POST /jobs/createTask con model bytedance/seedream-5.0-pro/text-to-image y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
- Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedream-5.0-pro/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"resolution": "2k",
"output_format": "jpeg"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.
Preguntas sobre la API de Seedream 5.0 Pro
¿Cuánto cuesta la API de Seedream 5.0 Pro?
Seedream 5.0 Pro cuesta desde 6 créditos (0,06 US$) por imagen con Crear imagen, su tarea más barata. Precios por opción: 1K 5,4 créditos por imagen, 2K 10,8 créditos por imagen. Los créditos son los mismos que en la web (1 crédito = 0,01 $), las cuentas nuevas reciben 30 créditos gratis y las tareas fallidas se reembolsan.
¿Cuál es el nombre de modelo de Seedream 5.0 Pro en la API?
Pon bytedance/seedream-5.0-pro/text-to-image para Crear imagen; bytedance/seedream-5.0-pro/edit para Editar imagen; bytedance/seedream-5.0-pro/layer-decomposition para Separador de capas en el campo model de POST /jobs/createTask.
¿Cuántas imágenes de referencia admite una edición?
Hasta diez. Asígnale un papel a cada una en el prompt, porque las fuentes sin nombrar se mezclan. Cada referencia más allá de la primera suma a la cotización que ves antes de enviar.
¿Puedo fijar el tamaño de salida o la proporción?
Sí, como proporción y nivel, no como píxeles libres. aspect_ratio admite quince formas de 1:3 a 3:1, y resolution elige 1k o 2k. Text-to-image usa 1:1 por defecto; la edición usa auto, que elige la proporción admitida más cercana a tu primera referencia. Si necesitas un preset de ancho*alto con nombre, usa Seedream 5.0 Lite.
¿Hay seed para obtener resultados reproducibles?
No. Ninguno de los dos endpoints la expone, así que dos solicitudes idénticas devuelven dos cuadros distintos. Guarda el prompt junto a cualquier recurso que pienses reutilizar.
¿JPEG o PNG, cuál conviene pedir?
png cuando el cuadro siga hacia retoque o composición y los bordes sin pérdida importen; jpeg para ciclos de revisión y entrega directa. Cambia el archivo que recibes, no la imagen que se generó.
¿Puede escribir texto dentro de la imagen?
Las cadenas cortas a veces salen bien, pero no es para lo que sirve este modelo. Para letreros, titulares y textos de empaque, usa un modelo hecho para tipografía dentro de la imagen.
¿Qué límites tiene la API de Seedream 5.0 Pro?
Resoluciones: 1K · 2K; Relaciones de aspecto: 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 +9; Longitud del prompt (caracteres): 5,000. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar Seedream 5.0 Pro sin escribir código?
Sí. El Playground ejecuta Seedream 5.0 Pro con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.
Todos los modelos de Seedream
Seedream 5.0 Lite trabaja con tamaños 2K fijos, lo que mantiene coherente una serie, y Seedream 5.0 Flash es el hermano más rápido y barato. Pro es el de la imagen final, la más detallada.
- API de Seedream 5.0 ProImágenes y ediciones muy detalladas con hasta diez referenciasDesde 6 créditos por imagen
- API de Seedream 5.0 FlashSeedream rápido: imágenes, ediciones y capas hasta 2KDesde 4 créditos por imagen
- API de Seedream 5.0 LiteImágenes 2K de tamaño fijo para que una serie sea coherenteDesde 6 créditos por imagen
- API de Seedream 4.0Tamaños exactos hasta 4096×2304 y ediciones con diez referenciasDesde 5 créditos por imagen

