Athenian Video Suite
product details.
Athenian Video Suite adds a structured AI video production layer to WordPress with guided prompts, style previews, queued rendering, credit controls, and Media Library delivery. It helps teams turn AI generation into a repeatable content workflow with clear job status, cost control, and asset ownership while keeping data, permissions, and automation aligned with the broader…
Athenian Video Suite is a WordPress-native AI video generation workflow for guided prompting, reference-aware style previews, Sora-family video submission, credit-aware usage, queue tracking, background polling, and completed MP4 delivery through the WordPress Media Library.
Instead of treating AI video generation as a disconnected API test or one-off creative tool, the plugin turns the full process into a managed site experience. Users can build structured prompts, add reference images, generate a style-preview still, submit a video render, monitor progress in a frontend queue, and receive the final video as a retained WordPress media asset.
The plugin uses the [apf_video] shortcode to embed a creative interface with prompt controls, reference collection, style preview generation, model/size/length selection, cost estimation, and a live Video Generation Queue. Behind the scenes, each render is stored as an apf_video_job record with prompt metadata, status, progress, model, size, duration, credit cost, remote provider ID, result URL, and Media Library attachment ID.
For Athenian Platform deployments, Athenian Video Suite acts as the AI video execution layer for creative commerce, creator portals, PrintForge-style design flows, branded media tools, credit-gated AI products, product promo clips, and customer-facing generative media experiences.
AI Creative Studio
Guide Users From Creative Direction to Video-Ready Prompts
Athenian Video Suite gives users a structured prompt-building interface for
defining creative goals, scenes, subjects, style, camera motion, dialogue,
sound, and negative guidance before submitting a video render.
| Creative Layer | Customer Experience Value |
|---|---|
| Prompt Builder | Capture structured guidance for goal, energy, subject, location, action, visual style, camera, audio, and ending behavior. |
| Editable Prompt | Compile a detailed prompt while still allowing advanced users to edit the final text before submission. |
| References | Accept uploaded images, Media Library selections, URL references, canvas data, and generated preview stills. |
| Style Preview | Generate or consolidate a still image through GPT-Image / Images API workflows before committing to video generation. |
- Embed the full interface with
[apf_video]. - Use preset guidance from
assets/presets/avg-presets.json. - Store style-preview images as WordPress attachments with prompt and guidance metadata.
- Use the style-preview endpoint
/wp-json/apf-video/v1/style/preview.
Video Generation
Submit Sora-Family Video Jobs and Deliver Finished MP4s Through WordPress
The plugin creates a managed video job record, submits the render to the
OpenAI video API, polls status through WP-Cron, downloads completed output,
and saves the finished MP4 into the WordPress Media Library.
Support
sora-2 and sora-2-pro model selection
Normalize video length to supported 4, 8, or 12 second clips
Track queued, rendering, completed, and failed jobs in a frontend queue
| Runtime Layer | How It Helps |
|---|---|
| Job Records | Store each render as an apf_video_job post with status, progress, prompt, model, size, cost, and remote ID. |
| Reference Coercion | Consolidate multiple references into one guidance still and coerce it to the exact video dimensions required by the provider. |
| Background Worker | Use the recurring avg_tick worker to poll queued and in-progress jobs and fetch completed output. |
| Media Library | Download completed MP4 content and sideload it as a WordPress attachment for durable delivery. |
- Submit video jobs through
/wp-json/apf-video/v1/submit. - Expose user jobs through
/wp-json/apf-video/v1/jobs. - Support manual admin recovery through
admin-post.php?action=avg_fetch_result. - Keep completed video URLs and attachment IDs attached to the job record for playback and delivery.
Credits & Operations
Control AI Video Usage With Credits, Pricing, Job Records, and Recovery Tools
Athenian Video Suite includes configurable pricing, credit-balance resolution,
charge hooks, admin job visibility, OpenAI credential resolution, debug paths,
and recovery workflows for production-facing AI video portals.
| Operations Layer | Operational Purpose |
|---|---|
| Credit Estimates | Estimate video cost from rate per second, duration, size multiplier, quality multiplier, and image-preview cost. |
| Credit Bridges | Resolve balances from PrintForge credit services, user meta, Athenian balance filters, and custom credit hooks. |
| Admin Jobs | Inspect status, progress, user, credits, remote ID, result URL, attachment, and errors from the Video Jobs admin screen. |
| Platform Delivery | Support creator portals, PrintForge-style design tools, membership credit products, branded media workflows, and WooCommerce AI services. |
Managed AI video generation for WordPress:
prompts, references, credits, queue status, remote provider IDs,
generated files, Media Library attachments, and admin recovery all remain
inside the site’s operational workflow instead of living in disconnected
external tools.
- Expose credit balances through
/wp-json/apf-video/v1/credits. - Charge integrations through the
avg/credits/chargefilter. - Resolve OpenAI credentials from options, constants, environment variables, Secure API Store, and filters.
- Build toward saved prompt templates, video galleries, webhook events, retry actions, credit holds, reporting, and Action Scheduler support.