Athenian Video Suite
Overview
Product overview
AI video generation is powerful, but most implementations are still too fragile for production use. Prompt submission happens in one custom UI, reference handling in another script, billing logic somewhere else, job polling in cron code, and finished files often never make it cleanly back into the CMS. The result is a poor customer experience, unreliable cost control, and a workflow that creates more operational overhead than it removes.
Athenian Video Suite solves that by packaging the full render lifecycle into one WordPress-native system. It captures prompts and references, can generate a style-preview image to consolidate creative direction, submits Sora-based video jobs, tracks them in the background, enforces or integrates with platform credits, stores completed videos in WordPress, and notifies users when the render is ready.
Use cases
- AI video
- Media generation
- Style previews
- Video libraries
Developer
Developer starting point
This baseline documents the Video Suite architecture. It does not claim that an external video request, generated artifact, credit mutation, media-library write, or playback session has been exercised.
Ecosystem integration story
WordPress
Athenian Video Suite is designed to live natively inside WordPress. It uses shortcode rendering for the frontend experience, REST routes for job actions, custom post types for job records, cron or scheduler-style background polling, and Media Library storage for finished outputs.
OpenAI
Athenian Video Suite is the operational bridge between WordPress and OpenAI media generation services. It uses GPT-Image-1 for style-preview workflows and Sora-family video models for queued render generation, while normalizing model, size, duration, credential, and reference-image handling inside the plugin.
Athenian PrintForge and APF-style experiences
Athenian Video Suite aligns naturally with APF-driven creative workflows because it supports credit-backed generation, compact embedded UI, and media-first creation experiences. It can sit alongside Athenian PrintForge-style user journeys where visual generation and branded output are already central to the product experience.
Credit Pack Manager and platform credit systems
Athenian Video Suite is structured to work with CPM-backed credits as a native operational control. It can read balances, place holds, consume usage, and release held credits when jobs fail, making it suitable for gated AI experiences, subscription bundles, or usage-metered customer portals.
Admin and operations teams
Because every render becomes a tracked job inside WordPress, support, operations, and content teams get a clearer system of record. They can inspect status, credits, remote job IDs, and final assets without tracing the workflow across disconnected systems.
Install
- Reviewed source folder: athenian-video-gen
- Plugin version reviewed: 1.3.8
- Local source inventory: 31 files (temporary, test, and Git metadata excluded).
- GitHub baseline: https://github.com/Athenian-Brands/athenian-video-suite at main / 0c9fa25160bbefde1b8c0b5872be7147cdc74a3f.
- WordPress and the configured media environment.
- OpenAI or external video-provider credentials, paid requests, generated artifacts, credits, storage, and playback require separate verification.
Configuration
- Working positioning — see the linked technical reference excerpt.
- Executive summary — see the linked technical reference excerpt.
- Core marketing message — see the linked technical reference excerpt.
- The problem Athenian Video Suite solves — see the linked technical reference excerpt.
- What Athenian Video Suite does — see the linked technical reference excerpt.
- Ecosystem integration story — see the linked technical reference excerpt.
- Why this matters commercially — see the linked technical reference excerpt.
- Key differentiators — see the linked technical reference excerpt.
- Suggested messaging pillars — see the linked technical reference excerpt.
- Short-form copy options — see the linked technical reference excerpt.
- Sales narrative — see the linked technical reference excerpt.
- Best-fit use cases — see the linked technical reference excerpt.
- Positioning statement — see the linked technical reference excerpt.
- Platform-focused primary functionality copy — see the linked technical reference excerpt.
Usage
- Shortcodes detected in local PHP source: 2
- Static action/filter hooks detected in local PHP source: 19
- REST route registrations detected in local PHP source: 9
Shortcodes
- apf_video — athenian-video-gen.php
- apf_video — includes/class-avg-shortcode.php
REST Endpoints
- /credits — athenian-video-gen.php
- /credits — includes/class-rest.php
- /debug/openai — includes/class-rest.php
- /jobs — athenian-video-gen.php
- /jobs — includes/class-rest.php
- /style/preview — athenian-video-gen.php
- /submit — athenian-video-gen.php
- /submit — includes/class-rest.php
- / — athenian-video-gen.php
Hooks
- add_meta_boxes_ — includes/class-video-cpt.php
- add_meta_boxes — includes/class-video-cpt.php
- admin_init — athenian-video-gen.php
- admin_notices — athenian-video-gen.php
- admin_notices — includes/class-video-cpt.php
- admin_post_avg_fetch_result — includes/class-video-cpt.php
- admin_post_avg_tick_now — includes/class-workers.php
- avg/enqueue_frontend — athenian-video-gen.php
- avg_tick — includes/class-workers.php
- cron_schedules — includes/class-workers.php
- init — athenian-video-gen.php
- init — includes/class-video-cpt.php
- manage_ — includes/class-video-cpt.php
- plugins_loaded — includes/class-workers.php
- post_row_actions — includes/class-video-cpt.php
- rest_api_init — athenian-video-gen.php
- rest_api_init — includes/class-rest.php
- wp_mail_content_type — includes/class-workers.php
- wp — athenian-video-gen.php
Data Model
- Ecosystem integration story — described in the local technical reference.
API Reference
- Local source digest: 712d798abe79e2300f1b078c627764c3fef9fade68952ce6904171f48f1ef1bb
- Repository URL: https://github.com/Athenian-Brands/athenian-video-suite
- Repository reference: main
- Repository commit: 0c9fa25160bbefde1b8c0b5872be7147cdc74a3f
Source files include: assets/css/apf-bridge.css, assets/css/avg-prompt-builder.css, assets/css/avg-queue.css, assets/css/canvas-overlay.css, assets/css/frontend.css, assets/js/avg-app.js, assets/js/avg-core.js, assets/js/avg-viewer.js, assets/js/canvas-overlay.js, assets/js/prompt-builder.js, assets/js/spinner.js, assets/presets/avg-presets.json, athenian-video-gen-icon.png, athenian-video-gen.php, athenian-video-gen.php.bak, athenian-video-gen.zip, avg-marketing-document.md, docs/athenian-platform-marketing.md, docs/athenian-platform-technical.md, docs/technical-marketing.md, includes/class-avg-log.php, includes/class-avg-shortcode.php, includes/class-cpm-adapter.php, includes/class-credits.php, includes/class-images-client.php, includes/class-notify.php, includes/class-openai-client.php, includes/class-rest.php, …
Troubleshooting
This baseline documents the Video Suite architecture. It does not claim that an external video request, generated artifact, credit mutation, media-library write, or playback session has been exercised.
- Confirm the deployed plugin version, active dependencies, and current repository tree before using implementation details as a release contract.
Treat payment, carrier, vendor, shipment, inventory, account, credential, tax, AI, and external-provider behavior as integration-dependent until exercised in the target environment.
FAQ
What is this page intended to establish?
A versioned, product-linked starting point for iterative developer documentation. It combines the local implementation reference with a detected-code inventory and a committed GitHub baseline.
Is the linked repository baseline verified?
Yes. The repository URL, ref, and commit recorded on this page were verified from the clean GitHub baseline prepared for this documentation pass. That does not by itself prove fleet deployment parity.
What remains for release-grade documentation?
Reconcile the recorded source baseline with the deployed plugin version, then exercise the relevant authenticated, store, provider, payment, tax, carrier, or generated-artifact paths in the target environment.