Design

Composição de Imagens

Compor múltiplas imagens juntas com controle preciso sobre posição, opacidade e modos de mistura

file· Resultado de arquivoAbrir ferramenta

Início rápido

Chame esta ferramenta a partir do seu código em três idiomas.

cURL

# 1) Upload each file first → returns { filePath }
curl -X POST 'https://api.elysiatools.com/upload/image-composite' \
  -F 'file=@/path/to/baseImage.ext'
curl -X POST 'https://api.elysiatools.com/upload/image-composite' \
  -F 'file=@/path/to/compositeImages.ext'

# 2) Call the tool with the returned filePath values
curl -X POST 'https://api.elysiatools.com/pt/api/tools/image-composite' \
  -F 'baseImage=/path/to/file.ext' \
  -F 'compositeImages=/path/to/file.ext' \
  -F 'layoutMode=grid' \
  -F 'blendMode=over' \
  -F 'canvasWidth=0' \
  -F 'canvasHeight=0' \
  -F 'backgroundColor=transparent' \
  -F 'outputFormat=png' \
  -F 'quality=95'

Referência da API

Envie uma requisição POST com suas entradas em JSON. Parâmetros do tipo arquivo exigem upload prévio.

Endpoint

HTTP

POST https://api.elysiatools.com/pt/api/tools/image-composite

Parâmetros

Nome	Tipo	Obrigatório	Descrição
baseImage	fileupload necessário	Sim	Imagem base na qual outras imagens serão compostas
compositeImages	fileupload necessário	Sim	Selecionar 1-8 imagens para compor na imagem base
layoutMode	select	Sim	Como organizar as imagens compostas
blendMode	select	Não	Modo de mistura para imagens compostas
canvasWidth	number	Não	Largura da tela final (deixar vazio para usar largura da imagem base)
canvasHeight	number	Não	Altura da tela final (deixar vazio para usar altura da imagem base)
backgroundColor	color	Não	Cor de fundo para áreas transparentes (padrão: transparente)
outputFormat	select	Não	Formato de saída para a imagem composta
quality	number	Não	Qualidade de saída para formatos com perda (JPEG, WebP, AVIF)

Parâmetros do tipo arquivo devem ser enviados primeiro via POST /upload/image-composite; o filePath retornado é então passado ao campo correspondente.

Formato de resposta

Resultado de arquivo

JSON

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}

Integração MCP

Adicione esta ferramenta ao seu servidor Model Context Protocol para que agentes de IA possam listá-la e chamá-la.

Configuração do servidor

Adicione este bloco à configuração do seu cliente MCP:

mcp.json

{
  "mcpServers": {
    "elysiatools-image-composite": {
      "name": "image-composite",
      "description": "Compor múltiplas imagens juntas com controle preciso sobre posição, opacidade e modos de mistura",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-composite",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Listar ferramentas disponíveis

Após conectar ao endpoint SSE, liste as ferramentas expostas:

tools/list

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Chamar esta ferramenta

Invoque a ferramenta pelo seu id; os argumentos são construídos a partir de seus parâmetros:

tools/call

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "image-composite",
    "arguments": {
  "baseImage": "https://example.com/file.ext",
  "compositeImages": "https://example.com/file.ext",
  "layoutMode": "grid",
  "blendMode": "over",
  "canvasWidth": 0,
  "canvasHeight": 0,
  "backgroundColor": "transparent",
  "outputFormat": "png",
  "quality": 95
}
  }
}

Encadeie várias ferramentas em uma sessão com uma lista toolId separada por vírgulas, p. ex. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (máx. 20).

Parâmetros de arquivo aceitam somente uma URL de arquivo pública (https://…). Caminhos locais, data: URI e strings Base64 não são suportados.

Dúvidas ou problemas? Contate [email protected]