Referencia de la API de Seedream 5.0 Pro

Con una sola clave de API de PopNow puedes llamar a Seedream 5.0 Pro desde tu propio código. Aquí tienes los ID de modelo que debes enviar, cada campo de entrada que acepta, cuántos créditos cuesta cada solicitud y una petición que puedes pegar tal cual en la terminal.

Las descripciones de los parámetros vienen del esquema de entrada del modelo y solo están en inglés.

De un vistazo

Creado por: ByteDance
Resultado: Imagen
Desde: 5.4 créditos por imagen ($0.054)
Tiempo habitual: unos 54 s
ID de modelo: bytedance/seedream-5.0-pro/text-to-image
bytedance/seedream-5.0-pro/edit
bytedance/seedream-5.0-pro/layer-decomposition

1 crédito = 0,01 US$. Al aceptarse, la tarea retiene el cargo máximo posible y al terminar cobra el uso real, redondeado al crédito superior; el resto se libera. Las tareas fallidas no se cobran. Para saber la cifra exacta antes de ejecutar, llama a POST /api/v1/jobs/quote.

Crear imagen

bytedance/seedream-5.0-pro/text-to-image

Precio

Opción	Créditos (por imagen)	Dólares
`1k`	5.4	$0.054
`2k`	10.8	$0.108

Parámetros

Campo	Tipo	Valor predeterminado	Valores admitidos	Para qué sirve
`prompt`Obligatorio	`string`	—	hasta 5000 caracteres	Describe the image to generate: subject, composition, style, and lighting.
`aspect_ratio`Opcional	`string`	`1:1`	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)	Output aspect ratio.
`resolution`Opcional	`string`	`2k`	1k, 2k	Output resolution tier.
`output_format`Opcional	`string`	`jpeg`	jpeg, png	File format of the returned image.
`enable_thinking`Opcional	`boolean`	`true`	—	Run a thinking pass that refines the prompt before generating. Off is faster.

Solicitud de ejemplo

Esta solicitud funciona tal cual; los campos que no envíes usan su valor predeterminado. Antes, guarda tu clave en POPNOW_API_KEY.

POST /api/v1/jobs/createTask

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: $(uuidgen)" \
  -d '{
  "model": "bytedance/seedream-5.0-pro/text-to-image",
  "input": {
    "prompt": "A cozy reading nook beside a rain-streaked window, warm lamp light, a sleeping orange cat on a knitted blanket, soft film grain",
    "resolution": "2k"
  }
}'

La respuesta trae un taskId al instante. Consulta el resultado con GET /api/v1/jobs/recordInfo o añade callBackUrl para recibir un aviso.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Editar imagen

bytedance/seedream-5.0-pro/edit

Precio

Opción	Créditos (por imagen)	Dólares
`1k`	5.4	$0.054
`2k`	10.8	$0.108

Parámetros

Campo	Tipo	Valor predeterminado	Valores admitidos	Para qué sirve
`prompt`Obligatorio	`string`	—	hasta 5000 caracteres	Describe the image to produce from the source: subject, composition, style, and lighting.
`image_urls`Obligatorio	`array<string (uri)>`	—	hasta 10 elementos	Source images that you are authorised to process.
`aspect_ratio`Opcional	`string`	`auto`	auto, 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, … (+2)	Output aspect ratio. auto picks the supported ratio closest to the first reference image.
`resolution`Opcional	`string`	`2k`	1k, 2k	Output resolution tier.
`output_format`Opcional	`string`	`jpeg`	jpeg, png	File format of the returned image.
`background`Opcional	`string`	`opaque`	opaque, transparent	Opaque image, or a PNG with a transparent background (png output, one PNG input with alpha).
`enable_thinking`Opcional	`boolean`	`true`	—	Run a thinking pass that refines the prompt before generating. Off is faster.

Solicitud de ejemplo

Esta solicitud funciona tal cual; los campos que no envíes usan su valor predeterminado. Antes, guarda tu clave en POPNOW_API_KEY.

El ejemplo usa archivos de muestra de PopNow en image_urls. Cámbialos por tus propios enlaces HTTPS públicos, archivos subidos o recursos guardados.

POST /api/v1/jobs/createTask

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: $(uuidgen)" \
  -d '{
  "model": "bytedance/seedream-5.0-pro/edit",
  "input": {
    "prompt": "Change the orange jacket to deep forest green and add soft golden-hour light; keep the face, pose and background unchanged",
    "image_urls": [
      "https://media.popnow.ai/influencer/examples/marco.webp"
    ],
    "resolution": "2k"
  }
}'

La respuesta trae un taskId al instante. Consulta el resultado con GET /api/v1/jobs/recordInfo o añade callBackUrl para recibir un aviso.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Separar capas

bytedance/seedream-5.0-pro/layer-decomposition

Precio

Opción	Créditos (por imagen)	Dólares
`1.5k`	6.3	$0.063
`1k`	6.3	$0.063
`2k`	12.6	$0.126
`auto`	12.6	$0.126

Parámetros

Campo	Tipo	Valor predeterminado	Valores admitidos	Para qué sirve
`image_url`Obligatorio	`string (uri)`	—	—	The finished image to split into layers.
`prompt`Opcional	`string`	—	hasta 5000 caracteres	Optional: name the elements to separate. Leave empty to let the model pick the main elements.
`resolution`Opcional	`string`	`1.5k`	auto, 1k, 1.5k, 2k	Output resolution tier. auto follows the size of the source image.
`output_format`Opcional	`string`	`jpeg`	jpeg, png	File format of the base image. Layers are always transparent PNG.

Solicitud de ejemplo

Esta solicitud funciona tal cual; los campos que no envíes usan su valor predeterminado. Antes, guarda tu clave en POPNOW_API_KEY.

El ejemplo usa archivos de muestra de PopNow en image_url. Cámbialos por tus propios enlaces HTTPS públicos, archivos subidos o recursos guardados.

POST /api/v1/jobs/createTask

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: $(uuidgen)" \
  -d '{
  "model": "bytedance/seedream-5.0-pro/layer-decomposition",
  "input": {
    "prompt": "A bright, cheerful scene with soft natural light",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "1.5k"
  }
}'

La respuesta trae un taskId al instante. Consulta el resultado con GET /api/v1/jobs/recordInfo o añade callBackUrl para recibir un aviso.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Referencia de la API de Seedream 5.0 Pro

De un vistazo

Crear imagen

Precio

Parámetros

Solicitud de ejemplo

Editar imagen

Precio

Parámetros

Solicitud de ejemplo

Separar capas

Precio

Parámetros

Solicitud de ejemplo

Siguientes pasos

En esta página