H3Hub 是一个跑在 GPU 上的 AI 视频生成平台。简单说，你给它一段文字、几张参考图或一段参考视频，它帮你生成一段视频。本文档是给要写自动化脚本、或者要把 H3Hub 接进 Agent（Claude Code、Codex 这类工具）的人看的，不解释前端页面怎么点。
Base URL
| 环境 | 地址 |
|---|---|
| 生产 | https://api.h3hub.cn |
| 本地 | http://localhost:8001 |
所有请求路径都以 /api/v1 开头。生产环境前面还有一层 Cloudflare Worker，普通调用方不用关心，直接按这个地址用就行。
核心概念
- 任务（Task）：一次视频生成请求。提交后状态会从
queued走到running，最后变成completed或failed。 - 作品（Work）：任务完成之后，你可以把它发布到社区。发布后进入审核，状态是
pending / published / rejected。 - API Key：以
h3k_开头的密钥，服务端调用时放在X-API-Key头里。
快速开始
按这个顺序走一遍，基本就能跑通：
- 注册账号：
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}
第一次跑通大概十分钟。卡住的时候先看返回的 detail，大部分问题都是参数没填对或者 Key 权限不对。
完整示例见 提交任务。