Design

Transformação Projetiva de Imagem

Aplicar transformação projetiva avançada para mapeamento de superfície 3D complexa e efeitos de projeção

file· Resultado de arquivoAbrir ferramenta

Início rápido

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

cURL

# 1) Request a presigned URL → returns { uploadUrl, storageKey }
curl -X POST 'https://api.elysiatools.com/api/upload/presign/image-projective' \
  -H 'Content-Type: application/json' \
  -d '{"filename":"imageFile.ext","contentType":"application/octet-stream","size":12345}'

# 2) PUT the file bytes directly to the presigned uploadUrl
curl -X PUT '<presigned uploadUrl>' \
  --data-binary @/path/to/file.ext

# 3) Call the tool, passing the returned storageKey for each file field
curl -X POST 'https://api.elysiatools.com/pt/api/tools/image-projective' \
  -F 'imageFile=uploads/2026/01/01/your-tool-1700000000000-abc123.ext' \
  -F 'matrixRows=Enter 3x3 transformation matrix (e.g., [[1, 0, 0], [0, 1, 0], [0.001, 0.002, 1]])...' \
  -F 'interpolation=bilinear' \
  -F 'background=transparent' \
  -F 'format=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-projective

Parâmetros

Nome	Tipo	Obrigatório	Descrição
imageFile	fileupload necessário	Sim	Carregue qualquer arquivo de imagem (JPEG, PNG, WebP, GIF, BMP, TIFF) para transformação projetiva
matrixRows	textarea	Sim	Matriz de transformação projetiva 3x3 em coordenadas homogêneas. Formato: [[a,b,c],[d,e,f],[g,h,i]]
interpolation	select	Não	Método para interpolar valores de pixels durante a transformação
background	text	Não	Cor de fundo para áreas vazias (hex #RRGGBB ou #RRGGBBAA, ou nome da cor)
format	select	Não	Formato de saída para a imagem resultante (PNG recomendado para transparência)
quality	number	Não	Qualidade de saída para formatos com perda

Parâmetros do tipo arquivo devem ser enviados primeiro via POST /upload/image-projective; 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-projective": {
      "name": "image-projective",
      "description": "Aplicar transformação projetiva avançada para mapeamento de superfície 3D complexa e efeitos de projeção",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-projective",
      "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-projective",
    "arguments": {
  "imageFile": "https://example.com/file.ext",
  "matrixRows": "Enter 3x3 transformation matrix (e.g., [[1, 0, 0], [0, 1, 0], [0.001, 0.002, 1]])...",
  "interpolation": "bilinear",
  "background": "transparent",
  "format": "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]