# Seedream 5.5

> 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.

- Página do modelo: https://yir.ai/pt/models/seedream-5-5
- ID do modelo: `bytedance/seedream-5.5`
- Cobrança: pelo canal que executou o job; tentativas que o upstream não cobrou são grátis.

## 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

## Preços

Preços públicos atuais por canal para a mesma especificação de saída; os preços oficiais são uma referência. Você paga pelo canal que de fato executa o job, que pode mudar em um failover.

| Especificação de saída | Canal | Preço público |
|---|---|---|
| 1K | APIMart | $ 0,013 ~ $ 0,0182 / imagem |
| 1K | KIE | $ 0,018 ~ $ 0,0252 / imagem |
| 2K | APIMart | $ 0,0228 ~ $ 0,028 / imagem |
| 2K | KIE | $ 0,0315 ~ $ 0,0387 / imagem |

## Parâmetros

- Operação: `generate_image`

| Parâmetro | Valores | Padrão |
|---|---|---|
| `input` | text / image | text |
| `resolution` | 1K / 2K | 1K |
| `aspect_ratio` | 1:1 / 4:3 / 3:4 / 16:9 / 9:16 / 3:2 / 2:3 / 2:1 / 1:2 / 21:9 | 1:1 |

## Integração

Escolha uma opção: o SDK oficial para código novo, ou troque a Base URL em projetos que já usam o protocolo da OpenAI.

### SDK oficial (TypeScript)

O SDK chama a Standard API (https://gateway.yir.ai) para enviar, aguardar e coletar jobs; também há um SDK em Go. https://yir.ai/docs/integrations/sdk

```bash
pnpm add @yir-ai/sdk
```

```ts
import { createNodeYirClient } from "@yir-ai/sdk/server";

// Reads YIR_API_KEY from the environment by default: process.env.YIR_API_KEY
const client = createNodeYirClient();

// 1. Submit an image generation job
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. Wait for the job to finish and deliver its result
const result = await client.waitForJob(job.id);
console.log("Delivered files:", result.result);
if (result.result && "files" in result.result) {
  for (const file of result.result.files) {
    console.log("->", file.url);
  }
}
```

### API compatível com OpenAI

Protocolos OpenAI Images e Sora Videos para SDKs da OpenAI e gateways como o new-api; sem chat. https://yir.ai/docs/integrations/openai-compatibility

- base_url do SDK da OpenAI: `https://gateway.yir.ai/openai/v1`
- Base URL do canal no new-api (tipo de canal OpenAI): `https://gateway.yir.ai/openai`
- ID do modelo: `bytedance/seedream-5.5`

```bash
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"
  }'
```

## FAQ

### Seedream 5.5 ou Seedream 5.0 Pro: qual usar?

Escolha o Seedream 5.5 se precisar de muitas rodadas de edição na mesma imagem ou de texto pequeno denso: nos testes da ByteDance, ele pontuou mais alto que o 5.0 Pro nos seis casos de produção e, em cinema e escritório, foi utilizável mais que o dobro das vezes. O Seedream 5.0 Pro alterna entre três provedores em caso de falha, enquanto o 5.5 roda por enquanto em um só provedor. A ByteDance diz que um Seedream 5.5 Pro virá depois.

### Quando o Seedream 5.5 foi lançado?

A equipe Seed da ByteDance lançou o Seedream 5.5 em 9 de novembro de 2026. Ele está chegando aos poucos ao Dreamina, CapCut, Doubao e Volcano Engine Ark, e o BytePlus ModelArk é a API da ByteDance fora da China. A ByteDance diz que haverá uma versão Pro da série Seedream 5.5.

### Como o Seedream 5.5 se compara ao GPT Image 2.5 e ao Nano Banana 2.1?

Nas avaliações comparativas de especialistas da ByteDance, o Seedream 5.5 supera o GPT Image 2.5 Sunburst e o Nano Banana 2.1 em estrutura do texto tanto em texto para imagem quanto em edição, e tem vantagem clara em realismo de texto para imagem. São avaliações da própria ByteDance na plataforma MagicArena, não testes independentes.

### Já posso usar a API do Seedream 5.5 no Yir?

Sim. Texto para imagem e edição com até 10 imagens de referência já estão disponíveis em 1K e 2K, com o preço exibido antes do envio. Saída transparente e separação em camadas ainda não estão na API do Yir.

### O que o Seedream 5.5 suporta?

Texto para imagem e edição com até 10 imagens de referência. No Yir: 1K e 2K, dez proporções de 21:9 a 1:2, uma imagem por requisição. O modelo também oferece 1.5K, saída transparente e separação de uma imagem em camadas, que o Yir ainda não expõe. A BytePlus ainda não publicou os limites da API.

## Regras

- Autentique com Authorization: Bearer $YIR_API_KEY; mantenha a key em uma variável de ambiente do servidor, nunca em código de navegador, controle de versão, prompts ou logs.
- Os jobs são assíncronos: guarde o Job ID, espere um estado final e depois leia o resultado; trate falhas e cancelamentos.
- Para retentativas seguras, reutilize a mesma chave de idempotência e a mesma requisição; não reenvie às cegas quando o resultado for desconhecido.
- As URLs de resultado são temporárias; copie os arquivos para outro lugar se precisar guardá-los.

## Links

- [Início rápido](https://yir.ai/docs/getting-started/quickstart)
- [Referência da API](https://yir.ai/docs/reference)
- [llms.txt](https://yir.ai/llms.txt)