图像
两条路由，都是异步的：POST /v1/images/generations（文生图）与 POST /v1/images/edits（图生图，可带遮罩）。两者都返回 202 Accepted 与任务信封，成品像素从 GET /v1/jobs/{job_id}/assets 取回。
注意 SDK 助手不适用
OpenAI SDK 的 client.images.generate() 期望同步返回 {"data": [{"url": …}]}，而我们返回任务。请用普通 HTTP 调用这两条路由。
生成
curl https://hypit.video/v1/images/generations \
-H "Authorization: Bearer $HYPIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-pro",
"prompt": "a paper boat drifting down a rain gutter, shallow depth of field",
"n": 1,
"aspect_ratio": "16:9",
"resolution": "1k"
}'{
"id": "job_5a0ce31f78b246d9c0117e42",
"status": "queued",
"kind": "image",
"model": "nano-banana-pro",
"progress": 0,
"created_at": 1787824589
}常用参数
| 参数 | 说明 |
|---|---|
| model | 必填，取值见模型目录 |
| prompt | 必填，文本提示 |
| n | 生成数量 |
| aspect_ratio | 例如 16:9、9:16、1:1 |
| resolution | 例如 1k、2k，影响倍率与积分 |
| mask | 仅编辑路由支持，用于局部重绘 |
FAQ
多久能拿到图？
通常数秒到数十秒；用任务轮询直到终态，再从 assets 取签名链接。
签名链接有效期？
15 分钟，过期重新请求即可。
分辨率会改变价格吗？
会，倍率表（如 resolution_ratio）是基准费率的乘数。