ByteDance

Seedream 5.0

seedream-5.0-flash

Modelo de geração de imagens de nível de produção da ByteDance, com suporte a busca na internet e raciocínio lógico em várias etapas, saída em 4K e edição por exemplos, ideal para criar imagens de produtos e infográficos

seedream-5.0-flash seedream-5.0-lite/image-to-image seedream-5.0-lite/text-to-image seedream-5.0-pro/image-to-image seedream-5.0-pro/text-to-image

Experimentar seedream-5.0-flash

Entrada

Criações

Ver todas as criações

Saída

image

Preencha os parâmetros e gere — os resultados aparecerão aqui.

Preços

seedream-5.0-flash per image

Preço unitário	$0.025

Apresentação

O Seedream 5.0 Flash é o modelo de geração rápida de imagens da série Seedream 5.0 da ByteDance, com suporte a dois fluxos: texto para imagem e imagem para imagem. Ele aceita até 10 imagens de referência, permite definir tamanhos de 1K, 1.5K, 2K ou largura e altura personalizadas, além de oferecer fundo transparente e escolha de formato de saída JPEG/PNG. É indicado para desenvolvedores que precisam produzir imagens de produto, materiais de marketing e visuais de séries em lote; basta acessar pela interface unificada do HiAPI.ai e concluir a geração e a transformação com imagens de referência e prompts.

Destaques principais

Imagem para imagem com múltiplas imagens de referência — é possível enviar uma única URL, Base64 ou um array com até 10 imagens, restringindo personagem, estilo e composição com um conjunto de referências.
Controle flexível do tamanho de saída — suporta predefinições de 1K, 1.5K, 2K ou largura e altura personalizadas, com proporções de 1:16 a 16:1, adequado a materiais em formato banner e vertical.
Saída opcional com fundo transparente — na edição de uma única imagem, é possível especificar fundo transparente e gerar PNG, facilitando sobrepor o material diretamente em peças de design ou páginas.
Chave de otimização de prompt — inclui um modo padrão de otimização de prompt que melhora a estabilidade da geração sem alterar a lógica de chamada.

Descrição das capacidades

Dois fluxos: texto para imagem e imagem para imagem: gere uma cena apenas com o prompt ou combine imagens de referência para indicar local e conteúdo das alterações; uma única interface cobre desde a criação de novos materiais até a transformação de imagens existentes.

Referência e fusão de múltiplas imagens: o modo imagem para imagem aceita até 10 imagens de referência, cujas funções podem ser indicadas separadamente no prompt, para uniformidade de estilo e combinação de múltiplos elementos.

Saída controlável em tamanho e formato: é possível definir de 1K a 2K ou largura e altura personalizadas, com saída em JPEG ou PNG; na edição com fundo transparente, o sistema restringe automaticamente a entrada a uma imagem e o formato a PNG.

Chave de marca d'água da geração: o parâmetro watermark vem desativado por padrão e pode ser ativado explicitamente para incluir a marca d'água de geração por IA, facilitando a adequação às exigências de conformidade de cada canal de publicação.

Cenários de uso

Produção em lote de imagens de produto por desenvolvedores de e-commerce — use fotos reais do produto como referência e, com prompts, gere versões com diferentes fundos e composições, produzindo materiais prontos para páginas de detalhes e anúncios.
Desdobramento de visuais de série por equipes de marketing — envie a imagem de referência do visual principal e descreva as variações desejadas para produzir em lote pôsteres, banners e outros materiais com tamanho e estilo consistentes.
Chamadas de imagem contextualizadas em ferramentas de design — acione a interface dentro do produto com entrada de texto ou imagem, oferecendo aos usuários geração e transformação de imagens em tempo real.

Limitações e recomendações de escolha

Como modelo Flash, destina-se à geração comum de imagens e à edição com imagens de referência, com limite de saída de 2K, sem opções de resolução superior. O fundo transparente é restrito à edição de uma única imagem e exige saída em PNG, não sendo possível usar esse recurso em cenários com múltiplas referências em lote. Se forem necessárias resoluções mais altas, infográficos complexos ou edição refinada em nível de pixel, deve-se avaliar versões mais capazes da mesma série; para cenários com exigência muito alta de qualidade de geração e tolerância a tempos de espera maiores, também se recomenda fazer uma escolha separada.

Novidades

Ver o changelog →

Novo modelo Lançamento do seedream-5.0-pro/image-to-image Nov 3, 2026
Novo modelo Novo modelo disponível: seedream-5.0-pro/text-to-image Nov 3, 2026
Novo modelo Modelo seedream-5.0-lite/image-to-image lançado Nov 3, 2026

Criar uma tarefa de geração

POST https://api.hiapi.ai/v1/tasks

Cabeçalhos

AuthorizationstringObrigatório

Chave de API da conta. Obrigatória em toda requisição. Exemplo: Bearer YOUR_HIAPI_API_KEY. Obter chave de API

Content-TypestringOpcional

O corpo da requisição é sempre interpretado como JSON; se enviado, apenas application/json (charset opcional) é aceito — qualquer outro valor retorna 415. Exemplo: application/json.

Idempotency-KeystringOpcional

Chave de idempotência, até 255 bytes. Retries com a mesma chave da mesma conta criam a tarefa apenas uma vez; replays retornam o taskId original.

Chave de idempotência

Em timeouts de rede ou retries automáticos do cliente, a mesma chave cria a tarefa apenas uma vez, sem cobrança duplicada (escopo = a conta da chave de API). Use um identificador de negócio exclusivo (ex.: "order-42"); replays retornam o taskId original e as chaves expiram 24 h após a primeira requisição. A matriz completa de cenários está na introdução da API assíncrona unificada.

Corpo

modelstringObrigatório

Valor fixo atual: seedream-5.0-flash

routestringOpcional

Valor fixo atual: default

inputobjectObrigatório

Objeto de parâmetros de negócio para seedream-5.0-flash e a rota default — veja a tabela de parâmetros abaixo.

sizestringOpcionalPadrão: "2K"pattern ^(1K|1\.5K|2K|[1-9][0-9]{0,3}x[1-9][0-9]{0,3})$

Controla o tamanho da imagem gerada; pode ser 1K, 1.5K, 2K ou um tamanho personalizado no formato "largura x altura"; o total de pixels do tamanho personalizado deve estar entre 921600 e 4624220, e a proporção entre 1:16 e 16:1. O padrão é 2K.

imageanyOpcionalminLength 1minItems 1maxItems 10pattern ^(https?://|data:image/)

Entrada de imagem de referência; pode ser uma única URL, uma imagem Base64 ou um array de até 10 imagens, usado para orientar a geração ou edição. Obrigatório quando background for transparent.

promptstringObrigatóriominLength 1maxLength 5000

Descreve o conteúdo da imagem que se deseja gerar; quando usado com imagens de referência, pode indicar os locais e conteúdos a serem modificados.

watermarkbooleanOpcionalPadrão: false

Controla se uma marca d'água de geração por IA é adicionada à imagem de saída; passe true para ativar. Desativado por padrão (false).

backgroundstringOpcionalPadrão: "opaque"

Controla o tipo de fundo da saída; o padrão é opaque (opaco); quando definido como transparent, aplica-se apenas à edição de uma única imagem com canal de transparência, e o formato de saída deve ser PNG ou não especificado.

Opções:opaquetransparent

output_formatstringOpcional

Especifica o formato de arquivo da imagem de saída; quando omitido, geralmente é JPEG, e PNG quando o fundo é transparente. Quando background for transparent, apenas png é suportado.

Opções:jpegpng

optimize_prompt_optionsobjectOpcional

Grupo de configurações de otimização de prompt, que controla as opções relacionadas à otimização de prompt.

modestringOpcionalPadrão: "standard"

Controla o modo de otimização de prompt, adotando o modo de otimização padrão. O padrão é standard.

Opções:standard

callbackobjectOpcional

Configuração de notificação de estado terminal. Se omitida, sem callback: consulte a tarefa por conta própria.

Callbacks (Webhook)

Informe callback.url na criação e o HiAPI fará POST no seu serviço no estado terminal, sem polling. O corpo do callback replica a estrutura do detalhe da tarefa; assinatura, retries e idempotência estão descritos na introdução da API assíncrona unificada.

urlstringObrigatório

Obrigatória se callback estiver presente. No estado terminal é enviado um POST para esta URL; deve ser uma URL http(s) válida.

whenstringOpcionalPadrão: "final"

Atualmente só há suporte a final — notifica tanto em success quanto em fail.

Opções:final

storagestringOpcionalPadrão: "temp"

Nível de armazenamento de artefatos: temp (padrão, ~7 dias) ou persistent (longo prazo, cobrado por tamanho). Saldo insuficiente ou limite excedido ⇒ rebaixamento silencioso para temp; o nível efetivo aparece na resposta de detalhes.

Opções:temppersistent

Exemplos de requisição

# Envia uma tarefa assíncrona; retorna um taskId imediatamente (sem esperar a geração)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5.0-flash",
  "input": {
    "size": "2K",
    "prompt": "…",
    "watermark": false,
    "background": "opaque"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "seedream-5.0-flash",
    input: {
      "size": "2K",
      "prompt": "…",
      "watermark": false,
      "background": "opaque"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "seedream-5.0-flash",
        "input": {
          "size": "2K",
          "prompt": "…",
          "watermark": False,
          "background": "opaque"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obter detalhes da tarefa

GET https://api.hiapi.ai/v1/tasks/:id

Campos da resposta

taskIdstringObrigatório

ID da tarefa, sempre com prefixo tk-hiapi-.

modelstringObrigatório

Nome completo resolvido do modelo. Tarefas enviadas com o parâmetro route retornam base@route (ex.: gpt-image-2/text-to-image@ext); caso contrário, igual ao nome enviado.

routestringOpcional

Presente apenas se o parâmetro route explícito foi usado; ecoa o valor enviado.

statusstringObrigatório

Estado da tarefa.

Valores de status

queued Na fila, ainda não iniciada. handling Em processamento. archiving Processamento concluído, preparando artefatos. success Terminal: concluído, artefatos disponíveis (retorna output). fail Terminal: falha (retorna error). Após o envio, acompanhe status: success e fail são terminais, os demais não. Faça polling a cada 1–3 s até o estado terminal. Em caso de sucesso, baixe os artefatos em output[].url e transfira antes de expireAt; para retenção longa, use storage: "persistent" na criação.

creatednumberObrigatório

Momento de criação da tarefa (segundos Unix).

completednumberObrigatório

Segundos Unix do estado terminal; 0 enquanto não terminal.

outputarrayOpcional

Presente apenas com status == success. Lista de artefatos — sempre um array; uma tarefa pode retornar vários types ao mesmo tempo (ex.: video + first_frame).

Array [ object ]

Itens do array

urlstringObrigatório

URL do artefato, baixável diretamente.

typestringObrigatório

Valores possíveis no momento: video, image, audio, first_frame, last_frame, thumbnail; poderão ser ampliados.

expireAtnumberObrigatório

Segundos Unix de disponibilidade do artefato; baixe ou transfira antes da expiração.

errorobjectOpcional

Presente apenas com status == fail.

codestringObrigatório

Código de erro de negócio.

messagestringObrigatório

Descrição do erro.

Exemplos de resposta

Sucesso

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

Em processamento (não final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Falhou

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}