Guia da API Seedream 5.0 Lite: geração de imagem a partir de texto e edição de imagem

Resumo do conteúdo

• O Seedream 5.0 Lite é o modelo de imagem da ByteDance. No HiAPI ele tem dois endpoints: seedream-5.0-lite/text-to-image e seedream-5.0-lite/image-to-image, ambos a $0.035 por imagem, com o mesmo preço para 2K ou 4K.
• Ele se destaca em renderizar texto com precisão nas imagens e em edições direcionadas: alterar um único objeto, substituir o texto de uma placa ou compor até 14 imagens de referência, mantendo o restante da cena intacto.
• Cada chamada exige aspect_ratio e resolution. Abra a página do modelo de texto para imagem para experimentar; novas contas recebem 200 créditos gratuitos.

Texto para imagem ou imagem para imagem

	Texto para imagem	Imagem para imagem
ID do modelo	seedream-5.0-lite/text-to-image	seedream-5.0-lite/image-to-image
Campos obrigatórios	prompt, aspect_ratio, resolution	Os mesmos, mais image_urls (1–14)
Preço	$0.035 por imagem	$0.035 por imagem, independentemente do número de imagens de referência
Cenários de uso	Pôsteres, cardápios, embalagens, infográficos	Mudança de cor, substituição de texto, composição de produto em cena

Preço em tempo real do HiAPI, verificado em 19 de outubro de 2026. Tarefas com falha não são cobradas.

O 4K tem o mesmo preço do 2K, então solicite 4K diretamente quando precisar de tamanho para impressão. Com $1 é possível gerar cerca de 28 imagens.

Texto para imagem: texto renderizado com precisão

Coloque entre aspas cada palavra que deseja renderizar e especifique a posição de cada string:

一张手绘丝网印刷风格的海报，主题是虚构的夜市美食节，顶部是大号中文书法标题“夜市食堂”，其正下方是英文副标题“NIGHT MARKET CANTEEN”，使用窄体无衬线字体，底部是日期行“OCT 17-19 · RIVERSIDE PIER”，暖色灯笼光晕笼罩着拥挤的小吃摊，竹蒸笼里升起蒸汽，限定配色为朱红、奶油色和墨蓝，可见印刷颗粒感，复古海报构图

Gerar este pôster →

seedream-5.0-lite/text-to-image, 2K, $0.035.

O título em chinês, o subtítulo em inglês e a linha de data aparecem exatamente como escritos. O mesmo padrão vale para quadros de cardápio, etiquetas de preço e embalagens; mantenha o texto em cerca de seis linhas no máximo. Para mais cinco padrões (incluindo um cardápio com cada preço correto), veja Receitas de prompts do Seedream 5.0 Lite.

Imagem para imagem: altere só um ponto, preserve o resto

Padrão: uma frase explicando a alteração e, em seguida, nomeie tudo o que deve permanecer inalterado.

Mudança de cor localizada. Imagem original:

把这只哑光白色陶瓷杯改成深钴蓝色釉面杯，带光泽反光质感，保持热气、橡木桌、打开的笔记本、钢笔、多肉植物、光线和相机角度完全不变，照片级写实

seedream-5.0-lite/image-to-image, uma imagem de referência, 3:2, 2K, $0.035.

Substituição de texto em placa.

把门上木制招牌的文字替换为“BAKERY CORNER”，保持相同的金色衬线字体风格和字号，保持招牌形状和木质纹理、砖墙立面、发光的窗户、橄榄树和阴天光线完全不变，照片级写实

seedream-5.0-lite/image-to-image, uma imagem de referência, 3:2, 2K, $0.035.

Composição de duas imagens. Refira-se às imagens pela ordem em que aparecem em image_urls:

取第一张图中的皮革背包，把它放在第二张图营地场景中的扁平花岗岩巨石上，以轻微角度自然倚靠，重新打光以匹配温暖的金色时分阳光，并在岩石上投下柔和阴影，保持石砌火圈、松林和山峰不变，照片级写实合成

seedream-5.0-lite/image-to-image, duas imagens de referência, 3:2, 2K, $0.035.

Defina aspect_ratio igual ao da entrada. Se solicitar um formato de quadro diferente, parte do efeito de edição será consumida por um novo recorte.

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-lite/text-to-image",
    "input": {
      "prompt": "A cafe chalkboard menu listing exactly three items: '\''FLAT WHITE 4.50'\'', '\''COLD BREW 5.00'\'', '\''CROISSANT 3.80'\''",
      "aspect_ratio": "3:4",
      "resolution": "2K"
    }
  }'

Você receberá um taskId. Consulte GET https://api.hiapi.ai/v1/tasks/{taskId} repetidamente até que data.status seja success e então baixe data.output[0].url. Os links expiram, então salve o arquivo imediatamente.

Para fazer uma edição, mude o modelo para seedream-5.0-lite/image-to-image e adicione "image_urls": ["https://your-cdn.example.com/input.jpg"].

Python: gere primeiro, edite depois

# pip install requests; export HIAPI_KEY=your-key first
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(model, timeout_s=300, **inp):
    body = {"model": model, "input": inp}
    # Reuse the same Idempotency-Key if you retry a submit, so a retry never bills twice
    r = requests.post(API, json=body, headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)  # 400s list every invalid field
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(5)
    raise TimeoutError(task_id)

# Generate a packshot
shot = generate("seedream-5.0-lite/text-to-image",
                prompt="Studio photo of a matte-black tea tin labeled 'HILLFOG' on slate, no other text",
                aspect_ratio="1:1", resolution="2K")

# Then make a colorway from it; the generated URL works as a reference
green = generate("seedream-5.0-lite/image-to-image",
                 prompt="Recolor the tin to deep forest green, keep the label, slate and lighting unchanged",
                 image_urls=[shot], aspect_ratio="1:1", resolution="2K")

with open("green.jpg", "wb") as f:
    f.write(requests.get(green).content)

Se for reutilizar os resultados depois, baixe cada um assim que estiver pronto; os links de saída expiram.

Parâmetros

Campo	Obrigatório	Valores	Descrição
prompt	Sim	4–3.000 caracteres	Coloque entre aspas o texto que precisa ser renderizado
aspect_ratio	Sim	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9	Ao editar, mantenha igual ao da entrada
resolution	Sim	2K, 4K	Em maiúsculas; mesmo preço
image_urls	Apenas imagem para imagem	1–14 URLs	jpeg, png ou webp, máximo de 10 MB por imagem

Não há seed, negative_prompt nem output_format.

Erros comuns

Todos os erros abaixo retornam HTTP 400 no envio, portanto nenhuma tarefa é criada e nenhuma cobrança ocorre:

• aspect_ratio: missing required field / resolution: missing required field: ambos são obrigatórios, embora a documentação liste valores padrão.
• resolution: value must be one of '2K', '4K': não existe 1K. Use maiúsculas.
• image_urls: maxItems: got 15, want 14: no máximo 14 imagens de referência.
• prompt: minLength: got 2, want 4: o prompt precisa de pelo menos 4 caracteres.
• additional properties 'output_format' not allowed: esse campo não existe no Lite.

Lite, Flash ou Pro?

Modelo	Preço por imagem	Cenário de uso
Seedream 5.0 Flash	$0.025	Quando lote e velocidade são prioridade
Seedream 5.0 Lite	$0.035 tanto para 2K quanto para 4K	Texto em imagens, edições finas, 4K sem custo extra
Seedream 5.0 Pro	$0.05 (1K) / $0.10 (2K)	Quando os ativos finais exigem o máximo de detalhe

Para um teste comparativo com o mesmo prompt entre os dois níveis mais baratos, veja Seedream 5.0 Flash vs. Lite. Para os preços completos, veja Preços da API Seedream 5.0.

Perguntas frequentes

Cada imagem de referência tem custo extra?

Não. O imagem para imagem custa $0.035 por saída, seja enviando 1 ou 14 imagens de referência.

É possível renderizar texto em chinês?

Sim. O pôster acima inclui na mesma imagem tanto um título em chinês quanto um subtítulo em inglês. Basta colocar cada string entre aspas e ancorar sua posição.

Meu produto será mantido totalmente consistente?

Ele preserva o que você especificar. Liste todos os elementos que devem permanecer (forma, rótulos, iluminação, ângulo de câmera); qualquer item não mencionado pode mudar.

Escolher 2K ou 4K?

O preço é o mesmo. O lado maior do 2K tem cerca de 2.300 px, e o do 4K cerca de 4.096 px. Arquivos 2K são menores e mais fáceis de visualizar durante a iteração; mude para 4K quando precisar de impressão.