Multimedia

Sube imágenes y vídeos a Marsial antes de publicarlos.

Pedir una URL de subida

POST/v1/media/upload-url

JPEG, PNG, WebP y GIF hasta 20 MB; MP4, MOV y WebM hasta 1 GB. Sube el archivo con PUT a uploadUrl y usa publicUrl en el post.

Cuerpo

• filenamestringobligatorio

  máx. 255

• contentTypestringobligatorio

  mín. 3

• sizeintegerobligatorio

  máx. 9.007.199.254.740.991

Respuesta 200

data

• uploadUrlstring (uri)obligatorio

  URL prefirmada: sube el archivo con PUT y el mismo Content-Type.

• publicUrlstring (uri)obligatorio

  Úsala en el media del post una vez subido.

• kindstringobligatorio

  Valores: image · gif · video

• expiresInintegerobligatorio

  Segundos que vale la URL de subida.

  máx. 9.007.199.254.740.991

curl

curl -X POST "https://api.marsial.dev/v1/media/upload-url" \
  -H "Authorization: Bearer $MARSIAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "autumn.mp4",
    "contentType": "video/mp4",
    "size": 48211234
  }'

Node

const res = await fetch('https://api.marsial.dev/v1/media/upload-url', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.MARSIAL_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "filename": "autumn.mp4",
    "contentType": "video/mp4",
    "size": 48211234
  }),
});
const { data } = await res.json();

Python

import os, requests

res = requests.post(
    "https://api.marsial.dev/v1/media/upload-url",
    headers={"Authorization": f"Bearer {os.environ['MARSIAL_API_KEY']}"},
    json={
        "filename": "autumn.mp4",
        "contentType": "video/mp4",
        "size": 48211234
    },
)
data = res.json()["data"]