1 分钟配置：用你自己的 Colab 出片
不用从头读。先选你现在的情况，页面只显示你要做的那一步。
STEP 01
先确认算力
H3 运行在你自己账号的 Colab 上。已经有 Colab Pro+、Google AI Pro 或 Ultra，就直接去第 2 步。
STEP 02
开通 Drama Pie 套餐
套餐提供点数、项目与画布；H3 的算力仍然走你的 Colab。
价格、点数与权益都在购买页，按实时价格结算。
套餐里有什么？
- 点数：按月发放，用于生成扣费。
- 项目与集数：按你选的套餐额度。
- 媒体存储：放素材与成片。
- 画布：包含在套餐内。
买完会回到 plan.dramapie.com；下一步在左侧「账户」。
STEP 03
连接 Colab
一次授权。之后每个 H3 任务都会跑在你自己账号的 Colab 上。
在「Colab」卡片里点「连接 Colab」，选开通 Colab 的那个 Google 账号，允许即可。
怎么确认连上了？
卡片会显示「已连接：你的邮箱」。再点「测试并查看剩余 CU」，能看到余额就通了。
STEP 04 · 可选
出片：三条路，选一条
不用全看。点开你要用的那一条。
三条路共用同一个账户与点数。
Playground · 最快看到结果
- 进 Playground 的「视频」页签，模型选 colab-h3。
- 放参考图，点缩略图上的标签切换「参考 / 首帧 / 尾帧」。
- 写提示词，用 <Picture 1>、<Picture 2> 指图；选 5–15 秒、720p，提交。
- 第一次只发一条 5 秒；角色对了再开「多任务模式」批量。
示例：一张角色卡 + 一张场景图，5 秒；提示词写「<Picture 1> 是林夏，<Picture 2> 是天台」。
画布 · 边排边改
API · 接进自己的流程
- 在 plan.dramapie.com 的「API Keys」页创建一把 Key；完整 Key 只显示一次。
- Base URL 用 https://api.dramapie.com，请求头带 Authorization: Bearer <key>。
- 建任务后拿 id 轮询，status 变成 completed 就能下载。
完整字段与错误码见 API 文档。
export DRAMA_API_KEY="sk-..."
curl https://api.dramapie.com/v1/videos \
-H "Authorization: Bearer $DRAMA_API_KEY" \
-F model=minimax-h3 \
-F prompt="<Picture 1> 是林夏，<Picture 2> 是天台。夜，中景，递信，霓虹反光，写实电影感。" \
-F seconds=5 \
-F resolution_name=720p \
-F "image[]=@linxia.png" \
-F "image[]=@rooftop.png"
curl https://api.dramapie.com/v1/videos/$VIDEO_ID \
-H "Authorization: Bearer $DRAMA_API_KEY"TROUBLESHOOTING
遇到问题再看
正常流程不需要读这一节。
开通了 Google AI Pro，CU 却没到账？
Google 的 Colab 权益分批开放，可能延迟。先在 Colab 新建一个 GPU 运行时；没到账就先别批量提交，或直接用 Colab Pro+。
选不到 GPU，或者开机很慢？
Colab 的卡是动态分配的，没容量时会排队。换个时间再看；排队超过设定时间会判失败并退回点数。
任务失败，点数会退吗？
会，手续费全额退回；超过 2 小时没完成的也会自动退。Colab 已经开机消耗的 CU 由 Google 计费，退不回来。
参考图的 <Picture N> 怎么编号？
按上传顺序。首帧、尾帧排最前，然后才是普通参考图：只给首帧 + 两张参考图时，就是 <Picture 1> 首帧、<Picture 2/3> 参考图。没显式标首尾帧、只发 image[] 时，文件名里的 first_ / _last 才会被用来判断角色。
成片存多久？和套餐的存储是一回事吗？
成片临时寄存 24 小时、每账号 1 GB，超时或超量会清理；套餐的媒体存储是另一层，放项目素材。要留的片子及时下载。
能同时跑几条？
Colab 对单账号的并发有上限。批量时一条拿到 id 再建下一条，复用同一台机器更省 CU。
一定要 Colab Pro+ 吗？
不用。Google AI Pro 就够用：价格更低，也包含 Colab 算力。Pro+ 也能用，但我们这条链路是一次几分钟的生成，跑完就停，不依赖后台执行。