Por enquanto este guia está só em inglês. →
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Describe the image to generate: subject, composition, style, lighting and any exact text. |
resolution | Não | Tamanho de saída. Maior fica mais nítido e custa mais. 1k · 1.5k · 2k · Padrão: 2k |
aspect_ratio | Não | O formato do quadro: horizontal, quadrado ou 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 · Padrão: 1:1 |
output_format | Não | Tipo de arquivo do resultado. jpeg · png · Padrão: jpeg |
Preços
Os preços são em créditos, os mesmos que você usa no site (1 crédito = US$ 0,01). O valor é reservado quando a tarefa é aceita e acertado pelo custo real quando ela termina; tarefas com falha são reembolsadas.
| Opção | Créditos por imagem | ≈ USD |
|---|---|---|
| Padrão | 4,35 | US$ 0,044 |
Cada tarefa é arredondada para cima em créditos inteiros, então uma execução no nível mais baixo custa 5 créditos por imagem (US$ 0,05).
Para saber o valor exato antes de rodar, envie o mesmo corpo para POST /jobs/quote.
Início rápido da API
Chame a API do Seedream 5.0 Flash em três passos
- Crie uma chave de API. Entre na PopNow e crie uma chave no console da API. As chaves começam com sk-popnow- e usam os mesmos créditos do site.
- Envie a requisição. Faça POST /jobs/createTask com model bytedance/seedream-5.0-flash/text-to-image e um objeto input conforme a tabela de parâmetros. A resposta traz um ID de tarefa na hora.
- Pegue o resultado. Consulte GET /jobs/recordInfo com o ID da tarefa, ou passe uma callBackUrl e enviamos o resultado para ela. Baixe os links de saída quando a tarefa der certo.
# 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-flash/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"Troque o prompt e os links pelos seus. A aba API traz a referência da resposta, do polling e do callback.
Perguntas sobre a API do Seedream 5.0 Flash
Quanto custa a API do Seedream 5.0 Flash?
O Seedream 5.0 Flash custa a partir de 4 créditos (US$ 0,04) por imagem com Divisor de camadas, a tarefa mais barata. Os créditos são os mesmos do site (1 crédito = US$ 0,01), contas novas ganham 30 créditos grátis e tarefas que falham são reembolsadas.
Qual é o nome de modelo do Seedream 5.0 Flash na API?
Coloque bytedance/seedream-5.0-flash/text-to-image para Criar imagem; bytedance/seedream-5.0-flash/edit para Editar imagem; bytedance/seedream-5.0-flash/layer-decomposition para Divisor de camadas no campo model de POST /jobs/createTask.
O que é a separação em camadas?
Você envia uma imagem pronta e recebe uma imagem base, em que os elementos separados são removidos e o fundo é preenchido, mais até dezesseis PNGs transparentes, um por elemento, como uma pessoa, um título, um produto ou um objeto. Depois você pode mover, redimensionar, substituir, recolorir ou descartar qualquer peça.
Posso usar várias imagens de referência?
Sim, até dez no endpoint de edição. A ordem importa, porque o prompt as chama de primeira, segunda e terceira. Dê uma função a cada uma, por exemplo rosto da imagem 1, vestido da imagem 2, local da imagem 3.
Existe seed para resultados reproduzíveis?
Não. O Flash não expõe seed em nenhum endpoint, então requisições idênticas devolvem resultados diferentes. Guarde o prompt e o ativo devolvido juntos.
Quais são os limites da API do Seedream 5.0 Flash?
Resoluções: 1K · 1.5K · 2K; Proporções: 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 +9; Tamanho do prompt (caracteres): 5,000. Requisições fora desses limites são rejeitadas antes de qualquer cobrança.
Dá para testar o Seedream 5.0 Flash sem escrever código?
Dá. O Playground roda o Seedream 5.0 Flash com seus créditos da PopNow, não precisa de chave de API e mostra o código de cada geração.
Todos os modelos Seedream
O Seedream 5.0 Pro investe mais em detalhe de material para os quadros finais e custa mais em 2K. O Flash é o jeito mais rápido e barato de testar ideias.
- API do Seedream 5.0 ProImagens e edições bem detalhadas com até dez referênciasA partir de 6 créditos por imagem
- API do Seedream 5.0 FlashSeedream rápido: imagens, edições e camadas até 2KA partir de 4 créditos por imagem
- API do Seedream 5.0 LiteQuadros 2K de tamanho fixo que mantêm uma série consistenteA partir de 6 créditos por imagem
- API do Seedream 4.0Tamanhos exatos até 4096×2304 e edições com dez referênciasA partir de 5 créditos por imagem

