Seedream MCP

Seus modelos criativos. Uma conexão.

Conecte seu assistente, escolha um modelo e crie imagens ou vídeos com os créditos existentes.

Criar chave API

Escolha seu ponto de partida

Modelos de imagem…

Modelos de vídeo…

Conecte seu assistente

Endpoint MCP

https://seedream-5.io/api/mcp

Defina SEEDREAM_API_KEY no ambiente da sua ferramenta de IA e copie a configuração. Altere a URL para testes locais.

~/.codex/config.toml

[mcp_servers.seedream]
url = "https://seedream-5.io/api/mcp"
bearer_token_env_var = "SEEDREAM_API_KEY"

Streamable HTTP · Bearer

Verificação e documentação dos clientes

Codex: geração, edição por URL e resultados verificados. Cursor / Grok Build: conexão e ferramentas verificadas. Claude Code: conexão verificada. Os fluxos completos desses três clientes ainda não foram verificados.

Os novos modelos passaram nos testes de geração, edição por URL e chamadas MCP nativas do Codex em produção. Os fluxos completos orientados por IA em cada cliente ainda precisam de validação.

Codex Cursor Claude Code Grok

Oficina de imagens

Escolha modelo e opções e copie os argumentos para o assistente conectado. A configuração de conexão é a mesma.

Modelo do exemploProporção de saídaResoluçãoFormato de saída

promptObrigatório

Texto não vazio, até 3000 caracteres. Descreva a imagem ou as alterações.

Custo estimado… créditos

Parâmetros de entrada

Parâmetro	Obrigatório?	Tipo, valores e limites
`model`	Opcional	`string`seedream-5-pro ID do modelo. Se omitido, usa Seedream 5 Pro. Padrão: seedream-5-pro
`request_id`	Obrigatório	`string` 8–128 letras latinas, números, _ ou -. Novo ID para cada imagem nova; mantenha o mesmo ao repetir a tarefa.
`prompt`	Obrigatório	`string` Texto não vazio, até 3000 caracteres. Descreva a imagem ou as alterações.
`aspect_ratio`	Opcional	`string`1:1 · 2:3 · 3:2 · 3:4 · 4:3 · 9:16 · 16:9 · 21:9 Proporção da imagem final. Para manter a referência, escolha a mesma. auto apenas no Nano Banana 2. Padrão: 1:1
`resolution`	Opcional	`string`1K · 2K Nível de resolução. Os pixels variam com a proporção. Padrão: 1K
`output_format`	Opcional	`string`jpeg · png jpeg ou png em minúsculas. Padrão: jpeg
`image_urls`	Obrigatório apenas na edição	`string[]` Lista de 1–10 URLs HTTPS públicas com domínio, até 4096 caracteres cada. Porta padrão ou 443. Sem IPs, caminhos locais, base64 ou links com login. Omita na geração por texto.

Apenas os parâmetros listados são aceitos. Valores inválidos são rejeitados antes do envio ou reserva de créditos. Uma imagem por pedido.

Ferramentas de consulta

seedream_get_model_info: model é opcional. {} retorna o catálogo e as opções Pro padrão.
seedream_get_balance: Sem argumentos: {}. Retorna créditos e limite restante da chave.
seedream_get_task: task_id obrigatório: o UUID retornado na criação.

Oficina de vídeos

Mesmo endereço e chave. Escolha Standard/Pro e um modo; copie os argumentos ao assistente conectado. O exemplo não envia tarefas.

Modelo do exemploResoluçãoProporção de saídaDuração (segundos)

Gerar áudioSemente (opcional)

promptObrigatório

Custo estimado… créditos

Argumentos prontos para copiar

Exemplos apenas · nenhum crédito é usado aqui

Duração (segundos): 2–30

seedream_generate_video

{
  "model": "wan-3.0-standard",
  "request_id": "generate_video_001",
  "mode": "text-to-video",
  "prompt": "Uma chaleira de cerâmica em mesa de madeira. A câmera se aproxima lentamente na suave luz da manhã.",
  "aspect_ratio": "adaptive",
  "resolution": "720P",
  "duration": 5,
  "audio": true
}

Novo vídeo usa novo request_id. Ao repetir mantenha ID e argumentos; alterações geram conflito.

Chame seedream_generate_video uma vez e consulte seedream_get_task com task_id a cada 5 segundos. Ao terminar retorna URL de vídeo e resource_link. Continua após desconexão. Não reenvie SUBMISSION_UNCERTAIN; procure suporte.

Mídia de referência e limites

Texto exige prompt. Quadros exige first_frame_url ou last_frame_url. Referências exige pelo menos um array de URL. Quadros e referências não se misturam. prompt é opcional com mídia.

Só URL HTTPS públicas, sem arquivo local, base64 ou login. Imagens:até10 JPEG/PNG/BMP/WebP,20 MiB cada, lados240–8000 px, proporção≤8. Vídeos:até5 MP4/MOV,100 MiB cada, lados240–4096 px, proporção≤8. Áudio:até5 WAV/MP3,15 MiB cada. Vídeo/áudio:1–15s cada, total≤15s por tipo. Vídeo de referência+saída≤30s. Mantenha URL disponíveis; o serviço valida arquivos reais.

Padrão: Standard, texto,720P (Pro1080P), adaptive,5s, áudio ligado. MP4 fixo; pixels variam com proporção.

Parâmetros de entrada

Parâmetro	Obrigatório?	Tipo, valores e limites
`request_id`	Obrigatório	`string · 8–128 · A–Z a–z 0–9 _ -`
`model`	Opcional	`wan-3.0-standard \| wan-3.0-prime \| wan-3.0-pro \| wan-3.0-prime-pro` Padrão: wan-3.0-standard
`mode`	Opcional	`text-to-video \| keyframe-to-video \| reference-to-video` Padrão: text-to-video
`prompt`	Obrigatório	`string · 1–20000`
`aspect_ratio`	Opcional	`16:9 \| 9:16 \| 1:1 \| 4:3 \| 3:4 \| adaptive` Padrão: adaptive
`resolution`	Opcional	Padrão: …
`duration`	Opcional	`integer · 2–30 s` Padrão: 5
`audio`	Opcional	`boolean · true \| false` Padrão: true
`seed`	Opcional	`integer · 0–2147483647`
`first_frame_url / last_frame_url`	Obrigatório · Quadro inicial / final	`string · HTTPS · ≤4096`
`reference_image_urls`	Opcional · Mídia de referência	`string[] · 1–10 · HTTPS · ≤4096 / URL`
`reference_video_urls`	Mídia de referência	`string[] · 1–5 · HTTPS · ≤4096 / URL`
`reference_audio_urls`	Mídia de referência	`string[] · 1–5 · HTTPS · ≤4096 / URL`
`reference_video_durations / reference_audio_durations`	Opcional	`number[] · 1–15 s / item · total ≤15 s`

Um MP4 por pedido. Sem output_format ou opções de fornecedor/segurança. Parâmetros inválidos são rejeitados antes da reserva. Mídia inacessível ou acima do limite pode falhar. Durações opcionais devem seguir quantidade e ordem das URL; não dispensam validação real.

Suas chaves API

Defina uma chave e um limite de gastos para cada ferramenta de IA. Exemplos e parâmetros

Carregando…