Como Utilizar a API

Esta seção apresenta o fluxo de trabalho e o passo a passo para converter seu JSON em um vídeo MP4.

Fluxo de Trabalho

1. Autenticação: Utilize sua API Key para autenticar a requisição.
2. Envio dos Dados: Estruture seu JSON com os elementos desejados para compor o vídeo.
3. Processamento: A API processa a requisição e gera o vídeo conforme os parâmetros informados.
4. Entrega: Você recebe o vídeo final por meio de um webhook ou por consulta de status.

Exemplo Prático de Requisição

Requisição HTTP

curl --location 'https://api.json-to-mp4.online/v1/api/video/criar' \
--header 'Content-Type: application/json' \
--header 'api-key: <YOUR_API_KEY>' \
--data '<YOUR_BODY_IN_JSON>'

Estrutura do JSON

Abaixo, um exemplo de como deve ser estruturado o JSON enviado:

{
  "webhook": "https://seusite.com/webhook",
  "width": 1280,
  "height": 720,
  "generalAudiosMerge": true,
  "generalAudios": [
    {
      "url": "https://seusite.com/audio1.mp3",
      "volume": 10
    },
    {
      "url": "https://seusite.com/audio2.mp3",
      "volume": 10
    }
  ],
  "effects": {
    "scaleZoom": true
  },
  "scenes": [
    {
      "type": "normal",
      "duration": "visualElements",
      "audio": {
        "url": "https://seusite.com/audio3.mp3",
        "volume": 100
      },
      "visualElements": [
        {
          "type": "image",
          "url": "https://seusite.com/imagem1.jpg",
          "duration": 3
        },
        {
          "type": "image",
          "url": "https://seusite.com/imagem2.jpg",
          "duration": 3
        },
        {
          "type": "image",
          "url": "https://seusite.com/imagem3.jpg",
          "duration": 3
        }
      ]
    },
    {
      "type": "end",
      "duration": "auto",
      "visualElements": [
        {
          "type": "video",
          "url": "https://seusite.com/video1.mp4",
          "duration": "auto"
        }
      ]
    }
  ]
}

Resposta da API

Após o envio da requisição, você receberá uma resposta indicando o status do processamento, como por exemplo:

{
  "status": "processing",
  "message": "O vídeo está sendo processado. Um webhook será chamado quando estiver pronto.",
  "videoUuid": "33fa2172-c89e-4d55-80d1-e2d8c72437a7"
}

Nota: Se ocorrer algum erro, verifique a estrutura do JSON e os dados de autenticação. Consulte os logs de resposta para mais detalhes.