Pular para o conteúdo
PlaygroundDocumentaçãoObter chave de API

API do Mage · Modelo de imagem

API do Seedream

Seedream, com filtro rigoroso

Obter uma chave de APIExperimente o Seedream no playground
POST https://api.mage.space/v1/seedream/generate

Resumo rápido

A API do Seedream executa o Seedream 5.5 e mais 5 variantes pelo Mage em POST https://api.mage.space/v1/seedream/generate. Uma requisição com as configurações padrão custa 42 Gems (cerca de US$ 0,042), sem assinatura. O Seedream aceita personagens salvos e referências por @handle no prompt.

  • ImagemSaída
  • 6Variantes
  • 42Gems por imagem, padrão
  • $0.042Aproximadamente, em USD

Visão geral

O que a API do Seedream faz

O Seedream, da ByteDance, do Seedream 5.0 Flash para rascunhos ao Seedream 5.5, o mais novo e o padrão, com cenas detalhadas, texto legível e edições a partir de até 10 referências ou Characters, até 4K no Seedream 4.5. Filtro rigoroso: prompts e primeiras imagens são verificados antes de cada execução.

A família de modelos de imagem Seedream, da ByteDance, para cenas detalhadas, textos legíveis e edições a partir de até 10 referências ou Characters: Seedream 5.5 (`seedream-5.5`), o mais novo e o padrão, com imagens mais realistas, textos pequenos mais nítidos e edições repetidas mais estáveis; Seedream 5.0 Pro (`seedream-5.0-pro`), o principal modelo anterior; Seedream 5.0 Flash (`seedream-5.0-flash`), com preço único e imagens de entrada incluídas, o mais barato em 2K ou com imagens de entrada (o Seedream 5.5 custa menos para um prompt sozinho em 1K); Seedream 5.0 Lite (`seedream-5.0-lite`), até 3K; Seedream 4.5 (`seedream-4.5`), até 4K; e Seedream 4.0 (`seedream-4.0`). Filtro rigoroso: o Mage verifica o prompt e a primeira imagem antes da execução; uma solicitação recusada falha com `content_blocked` e um motivo, e o valor é reembolsado.

Aceita image e additional_images como entradas.

Início rápido

Chame a API do Seedream

Defina MAGE_API_KEY, envie para /seedream/generate e consulte status_url até a solicitação ser concluída.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seedream/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "seedream-5.5"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('seedream', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'seedream-5.5',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("seedream", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "seedream-5.5",
})

print(request["result"]["url"])

Modelos

Valores de model_id do Seedream

Envie model_id para escolher uma variante. Uma solicitação sem ele usa a padrão.

model_idNomePadrão
seedream-4.0Seedream 4.0
seedream-4.5Seedream 4.5
seedream-5.0-liteSeedream 5.0 Lite
seedream-5.0-proSeedream 5.0 Pro
seedream-5.0-flashSeedream 5.0 Flash
seedream-5.5Seedream 5.5Sim

Opções

Parâmetros do Seedream

Valores permitidos em todas as variantes; uma variante pode oferecer menos. A documentação lista as opções de cada variante.

CampoValores
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K, 3K, 4K

Entradas

Entradas de mídia aceitas pelo Seedream

Envie cada uma como URL https, data URL ou upload de até 100 MB.

CampoFunção
imageA imagem de referência.
additional_imagesImagens de referência adicionais.

Mais modelos de imagem

Outras APIs de geração de imagens no Mage

Perguntas frequentes

Perguntas frequentes

Quanto custa a API do Seedream?
Uma requisição do Seedream com as configurações padrão (Seedream 5.5) custa 42 Gems, cerca de US$ 0,042. Outras resoluções, durações e variantes alteram o preço; a resposta informa o valor exato cobrado. Uma geração que falha é reembolsada; uma bloqueada pela política de conteúdo do Mage não é.
Qual é o endpoint da API do Seedream?
POST https://api.mage.space/v1/seedream/generate com um cabeçalho Authorization: Bearer contendo sua chave de API do Mage. A resposta inclui um status_url para consultar o resultado.
Quais modelos do Seedream posso chamar?
seedream-4.0 (Seedream 4.0), seedream-4.5 (Seedream 4.5), seedream-5.0-lite (Seedream 5.0 Lite), seedream-5.0-pro (Seedream 5.0 Pro), seedream-5.0-flash (Seedream 5.0 Flash), seedream-5.5 (Seedream 5.5). O padrão é o Seedream 5.5.
O Seedream aceita imagens de referência ou personagens?
O Seedream aceita image, additional_images. O Seedream aceita personagens salvos e referências por @handle no prompt.
Posso usar o Seedream no Claude ou no ChatGPT?
Sim. Conecte o servidor MCP do Mage ao Claude, ChatGPT, Claude Code, Grok ou Cursor e peça o Seedream pelo nome. Seu assistente lê as opções dele com get_model e informa o preço antes de gerar.
Por quanto tempo os resultados do Seedream são mantidos?
Resultados e entradas ficam salvos por 30 dias. Baixe o que quiser guardar para o seu próprio armazenamento.

Comece a criar com o Mage

Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.

Obter uma chave de APIExperimente o Seedream no playground