Media Gateway

Express.js API gateway for AI video/image generation, Cloudflare R2 storage, and automated asset management.

Endpoints

Endpoint	Method	Description
`/health`	GET	Provider status
`/auth/jimeng/qr`	POST	Start Jimeng QR login
`/auth/jimeng/qr/poll`	GET	Poll QR login status
`/auth/jimeng/status`	GET	Jimeng auth status
`/auth/flow4api/login`	POST	Flow4API login
`/auth/kling/login`	POST	Kling login
`/models`	GET	List available models
`/images/generate`	POST	Text-to-image
`/images/transform`	POST	Image-to-image
`/videos/generate`	POST	Text-to-video
`/videos/generate-from-image`	POST	Image-to-video
`/videos/generate-transition`	POST	Video transition (first+last frame)
`/videos/omni`	POST	Unified video generation
`/generations/:provider/:id`	GET	Poll generation status
`/assets/:provider/images/:id`	GET	Get image URL
`/assets/:provider/videos/:id`	GET	Get video URL
`/credits`	GET	Credit balance
`/credits/history`	GET	Credit history
`/credits/claim-daily`	POST	Claim daily credits
`/storage/upload`	POST	Upload to R2/GDrive
`/storage/list`	GET	List files
`/storage/mkdir`	POST	Create folder
`/audio/tts`	POST	Text-to-speech
`/social/publish`	POST	Submit publish task
`/social/discover`	POST	Submit discovery task
`/social/track`	POST	Submit tracking task

All endpoints are under /api/v1/creative/ and require CF Access headers. See Interactive API Docs for full details.

See .env.example for the full list. Key variables:

Variable	Description
`JIMENG_SIGN_SERVICE_URL`	Sidecar URL (default `http://localhost:3457`)
`R2_ACCOUNT_ID`	Cloudflare R2 account
`R2_ACCESS_KEY_ID` / `R2_SECRET_ACCESS_KEY`	R2 credentials
`SOCIAL_WORKER_URL`	CF Worker URL for social gateway
`OPENAI_API_KEY`	OpenAI API key (Sora provider)
`KLINGAI_ACCESS_KEY` / `KLINGAI_SECRET_KEY`	Kling AI credentials
`XAI_API_KEY`	xAI API key
`SLACK_BOT_TOKEN`	Slack bot token for notifications
`SOCIAL_API_SECRET`	Shared secret for social worker auth