Docs/AngeMedia

Start using AngeMedia Gateway

Validate one provider and one successful job before adding more models, video workflows or agent integrations.

Web StudioImagesVideo

Before you start

Start with Docker Compose

git clone https://github.com/AngeVox/AngeMedia-gateway.git
cd AngeMedia-gateway

export ADMIN_USERNAME=admin
export ADMIN_DEFAULT_PASSWORD='replace-with-a-long-random-password'
export GATEWAY_API_KEY='replace-with-a-long-random-gateway-key'

docker compose up -d --build

The current Compose Web Studio entry is:

http://localhost:9892/studio

Run locally with Python

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.lock
export ADMIN_USERNAME=admin
export ADMIN_DEFAULT_PASSWORD='replace-with-a-long-random-password'
python -m uvicorn scripts.angemedia_gateway.server:app --host 127.0.0.1 --port 9890

The Python path is useful for development and troubleshooting. Prefer the verified Compose configuration for long-running deployments.

First sign-in

  1. Open Web Studio.
  2. Sign in with the administrator credentials configured before startup.
  3. Open the provider page and configure only one provider first.
  4. Run the connection test and verify the key and Base URL.

Check health

curl http://127.0.0.1:9890/health

Compose may map a different host port. Use the port from the actual deployment.

Generate the first image

curl -X POST http://127.0.0.1:9890/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_GATEWAY_KEY" \
  -d '{"prompt":"a calm product photo on a clean desk","size":"1024x1024","response_format":"url"}'

Confirm that the returned or localized media can be opened before configuring image editing or video jobs.

Next steps