Referência da API do Seedream 5.0 Pro

Com uma única chave de API da PopNow você chama o Seedream 5.0 Pro direto do seu código. Aqui estão os IDs de modelo a enviar, cada campo de entrada aceito, quantos créditos custa cada requisição e um exemplo que você cola no terminal e roda.

As descrições dos parâmetros vêm do schema de entrada do modelo e estão disponíveis só em inglês.

Resumo

Desenvolvedor: ByteDance
Resultado: Imagem
A partir de: 5.4 créditos por imagem ($0.054)
Tempo médio: cerca de 54 s
IDs 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 = US$ 0,01. Ao ser aceita, a tarefa reserva o valor máximo possível e, no fim, cobra o uso real, arredondado para cima em créditos inteiros; o restante é liberado. Tarefas que falham não são cobradas. Para saber o valor exato antes de rodar, chame POST /api/v1/jobs/quote.

Criar imagem

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

Preço

Opção	Créditos (por imagem)	Dólares
`1k`	5.4	$0.054
`2k`	10.8	$0.108

Parâmetros

Campo	Tipo	Padrão	Valores aceitos	Para que serve
`prompt`Obrigatório	`string`	—	até 5.000 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.

Exemplo de requisição

Esta requisição roda do jeito que está; os campos que você omitir usam o valor padrão. Antes, coloque sua chave em 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"
  }
}'

A resposta já traz um taskId. Busque o resultado com GET /api/v1/jobs/recordInfo ou inclua callBackUrl para ser avisado.

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 imagem

bytedance/seedream-5.0-pro/edit

Preço

Opção	Créditos (por imagem)	Dólares
`1k`	5.4	$0.054
`2k`	10.8	$0.108

Parâmetros

Campo	Tipo	Padrão	Valores aceitos	Para que serve
`prompt`Obrigatório	`string`	—	até 5.000 caracteres	Describe the image to produce from the source: subject, composition, style, and lighting.
`image_urls`Obrigatório	`array<string (uri)>`	—	até 10 itens	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.

Exemplo de requisição

Esta requisição roda do jeito que está; os campos que você omitir usam o valor padrão. Antes, coloque sua chave em POPNOW_API_KEY.

O exemplo usa arquivos de amostra da PopNow em image_urls. Troque pelos seus próprios links HTTPS públicos, uploads ou assets salvos.

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

A resposta já traz um taskId. Busque o resultado com GET /api/v1/jobs/recordInfo ou inclua callBackUrl para ser avisado.

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 camadas

bytedance/seedream-5.0-pro/layer-decomposition

Preço

Opção	Créditos (por imagem)	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	Padrão	Valores aceitos	Para que serve
`image_url`Obrigatório	`string (uri)`	—	—	The finished image to split into layers.
`prompt`Opcional	`string`	—	até 5.000 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.

Exemplo de requisição

Esta requisição roda do jeito que está; os campos que você omitir usam o valor padrão. Antes, coloque sua chave em POPNOW_API_KEY.

O exemplo usa arquivos de amostra da PopNow em image_url. Troque pelos seus próprios links HTTPS públicos, uploads ou assets salvos.

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

A resposta já traz um taskId. Busque o resultado com GET /api/v1/jobs/recordInfo ou inclua callBackUrl para ser avisado.

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"

Referência da API do Seedream 5.0 Pro

Resumo

Criar imagem

Preço

Parâmetros

Exemplo de requisição

Editar imagem

Preço

Parâmetros

Exemplo de requisição

Separar camadas

Preço

Parâmetros

Exemplo de requisição

Próximos passos

Nesta página