Media

Converter MP4 para GIF

Converte vídeos MP4 para formato GIF com limite de 30 segundos e configurações de qualidade personalizáveis

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/mp4-to-gif' \
  -H 'Content-Type: application/json' \
  -d '{"filename":"videoFile.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/mp4-to-gif' \
  -F 'videoFile=uploads/2026/01/01/your-tool-1700000000000-abc123.ext' \
  -F 'width=0' \
  -F 'height=0' \
  -F 'fps=10' \
  -F 'startTime=0' \
  -F 'duration=30' \
  -F 'quality=80' \
  -F 'colors=256' \
  -F 'optimize=true' \
  -F 'dithering=true'

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/mp4-to-gif

Parâmetros

Nome	Tipo	Obrigatório	Descrição
videoFile	fileupload necessário	Sim	—
width	number	Não	Largura alvo em pixels (máx 2048)
height	number	Não	Altura alvo em pixels (máx 2048)
fps	number	Não	Taxa de quadros de animação (1-30 fps)
startTime	number	Não	Iniciar conversão a partir deste tempo (segundos)
duration	number	Não	Máximo 30 segundos para GIF
quality	number	Não	Qualidade mais alta = tamanho de arquivo maior
colors	number	Não	Mais cores = melhor qualidade mas arquivo maior
optimize	checkbox	Não	Usar paleta de cores otimizada para melhor compressão
dithering	checkbox	Não	Aplicar pontilhamento para transições de cor mais suaves

Parâmetros do tipo arquivo devem ser enviados primeiro via POST /upload/mp4-to-gif; 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-mp4-to-gif": {
      "name": "mp4-to-gif",
      "description": "Converte vídeos MP4 para formato GIF com limite de 30 segundos e configurações de qualidade personalizáveis",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=mp4-to-gif",
      "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": "mp4-to-gif",
    "arguments": {
  "videoFile": "https://example.com/file.ext",
  "width": 0,
  "height": 0,
  "fps": 10,
  "startTime": 0,
  "duration": 30,
  "quality": 80,
  "colors": 256,
  "optimize": true,
  "dithering": true
}
  }
}

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]