Seedream 5.5 API
O modelo de imagem mais recente da ByteDance, lançado em 9 de novembro de 2026: continue editando a mesma imagem por 100 rodadas sem que as áreas não tocadas mudem, gere PNG transparente direto e tenha fotos e texto pequeno mais próximos do real.
- 1K
- APIMart $ 0,0182 / imagem
- 2K
- APIMart $ 0,028 / imagem
Preços da API do Seedream 5.5
Preço por imagem em 1K ou 2K; a edição soma uma pequena taxa por imagem de referência. A BytePlus ainda não publicou o próprio preço do Seedream 5.5
Por padrão, a Yir envia cada job ao canal elegível com o menor preço estimado. Se uma tentativa falhar, ela tenta de novo em outro canal sem passar do seu max_cost. Não é preciso parâmetro de roteamento na solicitação. Documentação de roteamento e failover
Notas de preço
Cobrado pelo canal que de fato executa o job. O failover pode trocar de canal, o que pode mudar o custo e o tempo.
O que o Seedream 5.5 traz em relação ao Seedream 5.0 Pro
Estável por 100 rodadas de edição
As áreas não tocadas ficam idênticas pixel a pixel e sem desvio de cor, então dá para seguir refinando a mesma imagem
PNG transparente, sem recorte
Transparência total ou parcial direto de um prompt ou de uma imagem de referência, sem remover o fundo; ainda não disponível na API do Yir
Mais perto de uma foto real
Luz e pele mais naturais, com menos brilho; realismo na edição 55,62% acima do 5.0 Pro segundo a ByteDance
Texto pequeno e denso legível
Erros graves de texto em 0,4% nos testes da ByteDance, mesmo em legendas densas em chinês
Exemplos de geração
Todas as amostras vêm do lançamento oficial do Seedream 5.5 pela ByteDance Seed, com o prompt original; só redimensionamos e comprimimos
Gato branco num bar Prompt
A white cat sits elegantly among bottles and glasses in a bar at night. Shoot from a low angle with a tilted composition, using flash, Fujifilm Provia colors and film grain. Capture dappled light, bright highlights and crisp detail for a vintage photographic feel.
Página de jornal sobre Shakespeare Reutilizando personagens com fundo transparente Arranjos florais editados em muitas rodadas 
Instantâneo de rua com vento Prompt
A candid horizontal street photograph of a long-haired woman in a burgundy top and light brown jacket looking down at her phone. Strong wind sweeps her hair across her sunglasses and face. The entire frame tilts about 25 degrees clockwise, with consistent perspective across the figure, buildings, lamppost and pavement. Natural clothing folds, hurried framing and asymmetric cropping create an unposed everyday moment.
Esquina do sul da Europa Prompt
A vertical 3:4 street photograph of a southern European corner. A lemon-yellow limewashed wall, an old deep-purple wooden door and hanging royal-purple linen form a bold geometric composition. Golden flowers fill a weathered metal bucket at the lower right. Strong afternoon sunlight casts crisp shadows, revealing textured plaster, fabric folds, rust and layered petals in vivid complementary purple and yellow.
Bistrô numa noite de verão Prompt
A candid horizontal snapshot inside a neighborhood bistro in Europe on a summer evening. Two older diners eat naturally at a table covered with cream linen, unaware of the camera. Glasses, cutlery, breadcrumbs and worn wooden furniture show everyday use. Warm pendant lights mix with traces of cool evening light. Slight underexposure, subtle high-ISO grain and foreground occlusion create an intimate, spontaneous atmosphere.
Reflexos numa poça depois da chuva Prompt
A vertical 3:4 street photograph after rain, taken from a low angle looking down at wet paving stones and irregular puddles. Reflections of an old building’s golden carvings, window frames and colonnades are fragmented by exposed stones, puddle edges and ripples. Warm golden light contrasts with deep-blue reflections, preserving worn joints and wet surface textures. No full building, people or vehicles appear.
Usar a API
Deixe o código com um agente, gere direto no chat com MCP ou a Skill, ou integre você mesmo com o SDK ou a API compatível com OpenAI.
Deixe um agente de código fazer a integração
Copie o prompt de integração ou abra direto no Codex ou no Claude. O agente lê esta página e o contrato do modelo e depois escreve o envio, a espera e o tratamento do resultado no seu projeto.
Adicione o servidor MCP da Yir
Conecte ao ChatGPT, Claude ou Cursor, mencione @Yir e peça o Seedream 5.5 pelo nome. Ele mostra o preço primeiro e só gera depois que você confirmar.
https://gateway.yir.ai/mcpUm comando para o Claude Code
Crie uma API key no console, defina como YIR_API_KEY e execute:
claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"Instale a Yir Skill
Defina YIR_API_KEY onde seu agente roda, adicione a Skill ao Claude Code, Codex ou outro agente de código e diga “use o Seedream 5.5 na Yir para criar…”.
npx skills add yir-ai/skillsInstale o SDK oficial com seu gerenciador de pacotes ou copie o snippet abaixo para começar
| import { createNodeYirClient } from "@yir-ai/sdk/server"; |
| // Lê YIR_API_KEY do ambiente por padrão: process.env.YIR_API_KEY |
| const client = createNodeYirClient(); |
| // 1. Envia um job de geração de imagem |
| const job = await client.submitImage({ |
| model: "bytedance/seedream-5.5", |
| input: { |
| type: "text", |
| prompt: "Crie um pôster de produto de água com gás cítrica: uma garrafa de vidro transparente e laranjas frescas, fundo creme, luz natural suave e um rótulo de produto nítido", |
| }, |
| parameters: { |
| resolution: "1K", |
| aspect_ratio: "1:1", |
| n: 1, |
| }, |
| }); |
| // 2. Aguarda o job terminar e entregar o resultado |
| const result = await client.waitForJob(job.id); |
| console.log("Arquivos entregues:", result.result); |
| if (result.result && "files" in result.result) { |
| for (const file of result.result.files) { |
| console.log("->", file.url); |
| } |
| } |
Projetos que já usam o protocolo da OpenAI, ou gateways como o new-api, só precisam de uma nova Base URL e key. Guia de compatibilidade com OpenAI
- base_url do SDK da OpenAI
https://gateway.yir.ai/openai/v1- Base URL do canal no new-api
https://gateway.yir.ai/openai- Key
- API Key do Yir
- ID do modelo
bytedance/seedream-5.5
curl https://gateway.yir.ai/openai/v1/images/generations \
-H "Authorization: Bearer $YIR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "bytedance/seedream-5.5",
"prompt": "Crie um pôster de produto de água com gás cítrica: uma garrafa de vidro transparente e laranjas frescas, fundo creme, luz natural suave e um rótulo de produto nítido",
"resolution": "1K",
"aspect_ratio": "1:1"
}'Visão geral dos parâmetros
Parâmetros comuns; os limites dependem do modelo atual e do canal selecionado
- Resolução resolution
- 1K
- 2K
Faixa de resolução da saída. Resoluções maiores dão mais nitidez e o preço acompanha
- Proporção aspect_ratio
- 1:1
- 4:3
- 3:4
- 16:9
- 9:16
- 3:2
- 2:3
- 2:1
- 1:2
- 21:9
Proporção geométrica. Escolha de acordo com o meio de destino (retrato, banner ou quadrado)
- Modo de entrada input_mode
- Entrada de texto
- Entrada de imagem
Os limites e formatos de referência dependem do modelo e do canal selecionado
- Referências references
- reference_image ≤ 10
Os limites por modo dependem do canal escolhido. As quantidades na tabela são exemplos de preço, não limites nem cotas gratuitas.
