ByteDance
Seedream 4.5
seedream-4.5/image-to-image
Modelo de imagem de nível comercial do ByteDance, com foco em iluminação cinematográfica, consistência de personagens entre tomadas e edição com referência de múltiplas imagens, ideal para imagens em alta resolução de materiais de e-commerce e marketing
Experimentar seedream-4.5/image-to-image
Entrada
Criações
Ver todas as criaçõesSaída
imagePreços
seedream-4.5/image-to-image per image
| Preço unitário | $0.045 |
|---|
Visão geral do posicionamento
Linha de edição de imagens Seedream 4.5, voltada a desenvolvedores que precisam fazer reescritas controladas com base em materiais existentes. Recebe de 1 a 14 imagens de referência e uma instrução de edição, e gera imagens finais em resolução 2K ou 4K, com proporção selecionável entre 1:1 e 21:9. Adequada a fluxos de trabalho de geração em lote para e-commerce, marketing e conceitos audiovisuais: é preciso manter os personagens, produtos ou cenários das imagens de referência, ao mesmo tempo em que se ajustam os detalhes da imagem conforme instruções textuais, produzindo imagens de alta resolução prontas para entrega.
Destaques principais
- Fluxo de edição orientado por múltiplas imagens de referência — é possível enviar até 14 imagens de referência de uma só vez, para fundir múltiplos elementos ou manter a consistência do sujeito e, em seguida, reescrever a imagem conforme as instruções.
- Resoluções nativas 2K e 4K disponíveis — a resolução de saída é especificada diretamente nos parâmetros; a opção 4K é voltada a cenários de entrega comercial que exigem imagens em alta resolução.
- Proporções que cobrem composições horizontais, verticais e panorâmicas — suporta oito formatos, incluindo 1:1, 4:3, 16:9 e 21:9; o layout pode ser definido antes da geração, reduzindo recortes secundários.
Descrição das capacidades
Reescrita de imagem orientada por instruções: descreva o efeito desejado com uma instrução de edição de no máximo 3000 caracteres; o modelo realiza a reescrita preservando o conteúdo das imagens de referência, reduzindo o custo de iterações com redesenhos repetidos.
Fusão de múltiplas imagens e continuidade do sujeito: com 1 a 14 imagens de referência inseridas simultaneamente, é possível combinar vários materiais em uma mesma imagem final ou manter a forma e a textura de personagens e produtos consistentes entre diferentes enquadramentos.
Resolução e formato selecionáveis: a saída oferece as opções 2K padrão e 4K ultra-HD, combinadas com oito proporções de aspecto, gerando diretamente imagens compatíveis com os requisitos de posicionamento e layout.
Renderização de texto na imagem: boa capacidade de reprodução de textos como etiquetas e placas dentro da imagem, adequada à geração de imagens de materiais que exigem texto visível.
Cenários de aplicação
- Operação de e-commerce: troca de cenário com fotos reais do produto — insira a imagem de referência do produto e a descrição do cenário para gerar imagens de produto em vários ângulos, usadas em páginas de detalhes e materiais de mídia.
- Design de marketing: desdobramento de materiais a partir do visual principal — use o visual principal existente como referência e gere em lote materiais horizontais e verticais em diferentes formatos, para canais internos e redes sociais.
- Audiovisual e storyboard: geração de imagens com continuidade do personagem — envie a imagem de referência do personagem e as instruções de storyboard para gerar uma sequência de imagens com aparência consistente, usadas em storyboards e discussões de design conceitual.
Limitações e recomendações de seleção
As imagens de referência devem ser links jpeg, png ou webp acessíveis publicamente, com no máximo 10MB cada, e SVG não é suportado; o comprimento da instrução deve ficar entre 4 e 3000 caracteres, sendo necessário resumi-la caso ultrapasse esse limite. A saída 4K e a combinação de múltiplas imagens de referência aumentam a latência de geração, não sendo adequadas a cenários de interação em tempo real sensíveis à velocidade de resposta. Se a necessidade for gerar do zero, sem material de referência, deve-se optar pela linha de texto para imagem da mesma família; se forem necessárias saídas que não sejam imagens, esta linha não se aplica.
Perguntas frequentes
Ver todas as perguntas →-
Qual é a diferença entre image-to-image e text-to-image no Seedream 4.5?
O endpoint image-to-image usa a imagem que você enviou como base para edição, sendo adequado para mudar cores, trocar cenários, refazer a iluminação, conversão de estilo e composição com várias imagens; já o text-to-image gera a imagem do zero apenas a partir do texto. Quando for necessário preservar o sujeito, a composição ou o texto dentro da imagem, deve-se priorizar o uso do modelo image-to-image atual.
-
Quantas imagens de referência o Seedream 4.5 suporta no máximo?
Cada requisição pode enviar de 1 a 14 imagens JPEG, PNG ou WebP, com tamanho máximo de 10 MB por arquivo; SVG não é suportado. Em tarefas com várias imagens, você pode usar "image 1" e "image 2" no Prompt para especificar explicitamente a finalidade de cada imagem, e a ordem deve corresponder ao array image_urls.
-
Como é cobrado o Seedream 4.5 para edição de imagens? A quantidade de imagens de referência afeta o preço?
A cobrança é feita com base nas imagens de saída geradas com sucesso, e não na quantidade de imagens de referência. Atualmente, 2K e 4K usam a mesma tarifa pública; os valores específicos estão sujeitos ao preço em tempo real na página do modelo e ao registro da tarefa.
-
Como fazer o Seedream 4.5 preservar o sujeito, a composição ou o texto da imagem?
No Prompt, é necessário especificar ao mesmo tempo "o que precisa ser alterado" e "o que deve permanecer inalterado", por exemplo, preservar o contorno do sujeito, o ângulo da câmera, a sombra de contato, o layout da loja ou o texto caligráfico. Primeiro verifique o resultado no Playground; para materiais com texto de marca e requisitos rigorosos de layout, recomenda-se manter uma etapa de revisão manual.
Criar uma tarefa de geração
https://api.hiapi.ai/v1/tasks Cabeçalhos
AuthorizationstringObrigatórioChave de API da conta. Obrigatória em toda requisição. Exemplo: Bearer YOUR_HIAPI_API_KEY. Obter chave de API
Content-TypestringOpcionalO 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-KeystringOpcionalChave 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.
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órioValor fixo atual: seedream-4.5/image-to-image
routestringOpcionalValor fixo atual: default
inputobjectObrigatório
Objeto de parâmetros de negócio para seedream-4.5/image-to-image e a rota default — veja a tabela de parâmetros abaixo.
promptstringObrigatóriominLength 4maxLength 3000Instrução de edição, usada para descrever o efeito de imagem desejado na saída, com comprimento máximo de 3000 caracteres.
image_urlsarrayObrigatóriominItems 1maxItems 14Array de imagens de referência de entrada, com suporte para 1 a 14 imagens; cada uma deve ser uma URL publicamente acessível, no formato jpeg/png/webp, com no máximo 10MB por imagem, e SVG não é suportado.
Array [ string ]
resolutionstringObrigatórioPadrão: "2K"Resolução da imagem de saída; 2K é a qualidade padrão e 4K é ultra-alta definição; o padrão é 2K.
2K4Kaspect_ratiostringObrigatórioPadrão: "1:1"Proporção da imagem gerada; o padrão é 1:1.
1:14:33:416:99:162:33:221:9callbackobjectOpcional
Configuração de notificação de estado terminal. Se omitida, sem callback: consulte a tarefa por conta própria.
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órioObrigató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.
finalstoragestringOpcionalPadrã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.
temppersistentExemplos 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-4.5/image-to-image",
"input": {
"prompt": "…",
"image_urls": "…",
"resolution": "2K",
"aspect_ratio": "1:1"
}
}' 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-4.5/image-to-image",
input: {
"prompt": "…",
"image_urls": "…",
"resolution": "2K",
"aspect_ratio": "1:1"
}
}),
});
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-4.5/image-to-image",
"input": {
"prompt": "…",
"image_urls": "…",
"resolution": "2K",
"aspect_ratio": "1:1"
}
},
)
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
https://api.hiapi.ai/v1/tasks/:id Campos da resposta
taskIdstringObrigatórioID da tarefa, sempre com prefixo tk-hiapi-.
modelstringObrigatórioNome 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.
routestringOpcionalPresente apenas se o parâmetro route explícito foi usado; ecoa o valor enviado.
statusstringObrigatórioEstado da tarefa.
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órioMomento de criação da tarefa (segundos Unix).
completednumberObrigatórioSegundos 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órioURL do artefato, baixável diretamente.
typestringObrigatórioValores possíveis no momento: video, image, audio, first_frame, last_frame, thumbnail; poderão ser ampliados.
expireAtnumberObrigatórioSegundos Unix de disponibilidade do artefato; baixe ou transfira antes da expiração.
errorobjectOpcional
Presente apenas com status == fail.
codestringObrigatórioCódigo de erro de negócio.
messagestringObrigatórioDescriçã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"
}
}
} Artigos
Ver todos os artigos →-
Avaliação comparativa
hailuo-2.3-fast/image-to-video comparação lado a lado: como escolher modelos de imagem para vídeo e pontos de migração
-
Tutorial
recraft-v4.1-flash geração de imagens por texto na prática: 5 cenários de negócio de alto valor e pontos de integração
Partindo de um custo de US$ 0,01 por imagem, planeje como aplicar a geração de imagens em negócios reais
-
Tutorial
Como chamar kling-4.0/image-to-video na HiAPI: curl, Python e polling
-
Tutorial
Como usar kling-4.0/text-to-video através da API HiAPI: curl, Python e um exemplo de requisição executável
Guia prático para desenvolvedores: prompts cinematográficos, áudio sincronizado, polling assíncrono e download da saída
-
Avaliação comparativa
Comparação lado a lado do Recraft v4.1 Flash em text-to-image: guia de seleção e migração para desenvolvedores
Com um custo de $0.01 por imagem e capacidade de text-to-image pura, avalie se ele é adequado para seu pipeline de geração de imagens
-
Tutorial
Como chamar hailuo-2.3/text-to-video pela API HiAPI: curl, Python e exemplos de requisição executáveis
-
Tutorial
Usar Kandinsky 6.0 Pro text-to-video na HiAPI: tutorial de curl e Python
Demonstração prática com foco na requisição: montar a chamada de prompt para clipe de vídeo, enviar a requisição, consultar o status de conclusão e baixar o resultado
-
Tutorial
Tutorial de kandinsky-6.0-pro/image-to-video na HiAPI: curl + Python
Faça uma requisição de imagem para vídeo funcional na HiAPI: do upload do primeiro quadro ao polling assíncrono e ao download final
-
Tutorial
Como chamar hailuo-2.3-fast/image-to-video pela API HiAPI: curl e Python na prática
A primeira requisição executável do nível rápido e econômico de geração de vídeo a partir de imagem — do ID do modelo ao download do MP4
Modelos relacionados
Ver todos os modelos →Mesmo tipo
-
Nano Banana 2 Google $0.036 /imagem -
FLUX.1 Fill Pro Black Forest Labs $0.071 /imagem -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /imagem -
Grok Imagine Image 2.0 xAI $0.052 /imagem -
BRIA Product Shot Bria $0.058 /imagem -
Muse Image 1.0 Meta $0.015 per task -
Krea 2 Medium Turbo Krea $0.021 /imagem -
Recraft V4.1 Recraft $0.010 /imagem -
FIBO 1.5 Bria $0.058 /imagem -
Recraft Crisp Upscale Recraft $0.004 /imagem -
Krea 3 Krea $0.036 /imagem -
Seedream 5.0 ByteDance $0.025 /imagem







