开始使用 AngeMedia Gateway

先跑通一个 Provider 和一次生成，再增加更多模型、视频任务或 Agent 接入。

Web Studio图片视频

开始前确认

已安装 Docker 和 Docker Compose V2，或 Python 3.10+ 与虚拟环境工具。
准备一个实际可用的图片 Provider API Key。视频功能需要对应的视频 Provider。
为数据库、上传和生成文件准备持久化目录。

使用 Docker Compose 启动

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

export ADMIN_USERNAME=admin
export ADMIN_DEFAULT_PASSWORD='换成足够长的随机密码'
export GATEWAY_API_KEY='换成足够长的随机网关密钥'

docker compose up -d --build

当前 Compose 默认 Web Studio 地址为：

http://localhost:9892/studio

本地 Python 运行

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.lock
export ADMIN_USERNAME=admin
export ADMIN_DEFAULT_PASSWORD='换成足够长的随机密码'
python -m uvicorn scripts.angemedia_gateway.server:app --host 127.0.0.1 --port 9890

Python 方式适合开发和排障；长期运行优先使用经过验证的 Compose 配置。

打开 Web Studio。
使用你启动前设置的管理员账号登录。
进入 Provider/渠道页面，只配置一个准备使用的 Provider。
执行连接测试，确认密钥和 Base URL 正确。

检查服务

curl http://127.0.0.1:9890/health

Compose 端口可能不同，请以实际映射为准。健康检查成功后再继续生成。

生成第一张图片

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"}'

成功响应会返回 URL 或本地化后的媒体信息。先确认结果能打开，再继续配置图片编辑和视频任务。

下一步

日常使用界面：使用 Web Studio。
添加更多模型：配置渠道与模型。
调用图片或视频接口：API 示例。
开放给其他设备前：安全设置。