H3Hub 是一个 AI 视频生成平台。本文档面向外部开发者，用于构建自动化工作流，也供 Claude Code / Codex 等 Agent 读取。
Base URL
| 环境 | 地址 |
|---|---|
| 生产 | https://api.h3hub.cn |
| 本地 | http://localhost:8001 |
所有请求路径都以 /api/v1 开头。
核心概念
- 任务（Task）：一次视频生成请求，有
queued → running → completed | failed状态。 - 作品（Work）：完成任务发布到社区后的实体，审核状态为
pending / published / rejected。 - API Key：以
h3k_开头的密钥，用于服务端调用。
快速开始
- 注册账号：
POST /api/v1/auth/register - 创建 API Key：
POST /api/v1/me/api-keys - 提交生成：
POST /api/v1/video/generate - 轮询任务：
GET /api/v1/task/{task_id} - 下载结果：
GET /api/v1/result/{task_id}
完整示例见 提交任务。