Umbra

API Key 管理

生成一个 API Key，即可在自己的程序里直接调用图片/视频生成，无需登录网页。Key 只在创建时显示一次，请立即保存。调用会消耗你账号的每日额度。

调用教程

接口

POST /api/chat，请求头带 Authorization: Bearer <你的Key>，返回 SSE 流（text/event-stream）。

请求体（JSON）

字段	说明
type	"image" 或 "video"
model	模型名，见「生成」页下拉框，如 Google Nano Banana 2
prompt	提示词
ratio	宽高比，如 16:9
resolution	图片如 1K/2K/4K；视频如 720/1080
duration	视频时长（秒），仅视频需要
audio	true/false，仅视频

curl 示例

解析响应

响应是 oreate 原生 SSE。逐行读取，只有 event:"generating" 的行携带结果：其 data.result 是一段 markdown 图片/视频链接 ![](https://...)，用正则取出括号里的 URL 即可。start/end 事件可忽略。若某行含 "error" 字段则为报错。

Python 示例

注意

• 每次调用消耗你账号的每日额度（与网页共用），额度用完需等次日重置。
• 单次请求的积分成本受服务端上限约束，成本过高的组合（高分辨率/长时长）会被拒绝。
• Key 泄露请立即在上方吊销，吊销后该 Key 的调用会立刻失效。