H3Hub is an AI video generation platform running on GPUs. You give it text, reference images, or a reference video, and it generates a video. This documentation is for people writing automation scripts or connecting H3Hub to agents like Claude Code and Codex. It does not explain how to click through the web UI.

Base URL

All request paths start with /api/v1. In production there is a Cloudflare Worker in front, but you do not need to care about that for normal calls.

Core Concepts

• Task: one video generation request. It goes from queued to running, then completed or failed.
• Work: a completed task published to the community. Moderation status is pending / published / rejected.
• API Key: a secret starting with h3k_, sent in the X-API-Key header.

Quick Start

1. Register: POST /api/v1/auth/register
2. Create an API Key: POST /api/v1/me/api-keys
3. Submit generation: POST /api/v1/video/generate
4. Poll the task: GET /api/v1/task/{task_id}
5. Download the result: GET /api/v1/result/{task_id}

The first end-to-end run usually takes about ten minutes. If something fails, read the detail field first. Most problems are missing parameters or wrong key permissions.

See Generate Video for a complete example.