Quickstart

This guide gets you from zero to a processed image in under 5 minutes — no credit card, no setup beyond signing in.

1. Get an API key

Sign in at mediamoana.com/login, open your account, and create an API key under API Keys. Copy it.

export MOANA_API_KEY=...

All API calls authenticate via the Authorization: ApiKey <your-key> header.

2. Make your first call

A simple read-only call to confirm your key works — list the AI models available to your account:

curl https://api.mediamoana.com/api/v1/ai-models \
  -H "Authorization: ApiKey $MOANA_API_KEY"

3. Process an image (REST)

Processing runs as an async job. Submit a process job referencing existing media and a preset, then poll for completion.

# Submit: run the built-in web-optimize preset over a media item, save the result as a new file
curl https://api.mediamoana.com/api/v1/jobs \
  -H "Authorization: ApiKey $MOANA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "process",
    "mediaIds": ["<media-id>"],
    "presetId": "builtin-preset-util-web-optimize",
    "mode": "NEW_MEDIA"
  }'

The response is a Job object with an id and status. Poll GET /api/v1/jobs/{id} until status is COMPLETED, then read the per-item results to find the produced media.

Other job types: ai-generate (text-to-image), ai-edit (AI edit on existing media), parse (AI metadata extraction).

What's next

• Browse the API Reference for every endpoint.
• Skip the glue with Automations.