BeefAPI图片能力
用 hy-image-v3 生成图片，并区分图片生成与视频图片输入。
当前企业目录中的图片型号为 hy-image-v3，支持文生图和参考图生图，同步返回结果。用图片去指导视频属于 视频生成，与本页的图片输出是两件事。
型号与单价以带企业 Key 的 模型目录 和 模型与价格 为准。
文生图
curl --fail-with-body https://enterprise.beefapi.com/v1/images/generations \
-H "Authorization: Bearer $BEEFAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"hy-image-v3","prompt":"一只橙色小猫坐在窗台上，阳光洒落","size":"1024x1024"}'| 字段 | 说明 |
|---|---|
model | hy-image-v3 |
prompt | 图片描述，不超过 8,192 字符 |
size | 可选，${宽}x${高}；宽高均在 512–2048 之间，且宽×高不超过 1024×1024 |
n | 必须为 1；一次请求生成一张，需要多张请分别调用 |
images | 可选，0–3 张参考图，URL 或 Base64，单张不超过 10 MB |
seed | 可选整数，范围 1–4294967295，仅在生成一张时生效 |
revise | 可选布尔值，开启后由模型改写提示词 |
footnote | 可选，最多 16 个字符的右下角水印 |
不传 size 时由模型从预设尺寸中选择。越界的尺寸和大于 1 的 n 都会在发往上游之前被拒绝，不会被静默忽略或降级。
返回与保存
{"created":1789984602,"data":[{"url":"https://aigc-output-image-....cos.ap-guangzhou.myqcloud.com/....png","revised_prompt":"..."}]}data[].url 是有效期 12 小时的临时地址，请在生成后尽快下载并转存到自己的存储或 CDN，不要把它当作长期素材链接，也不要在客户端长期缓存。结果里没有图片内容时请求会失败，不会按成功计费。
计费
按实际生成的张数计费，单价见 模型与价格。尺寸会影响上游用量，但不改变按张的计费方式；不要用其他模型的按 token 报价推算本型号。
容易混淆的三种「图片」
| 需求 | 用哪个能力 |
|---|---|
| 从文字生成一张图片 | 本页的 POST /v1/images/generations |
| 用一张图片生成视频 | 视频生成，用 image 或 first_frame 素材 |
| 多张图片指导 Seedance 视频 | Seedance 素材角色 |
| 让文本模型理解图片 | 需单独确认所选文本模型的视觉能力，不等于生成图片 |
不要把视频模型填进图片接口，也不要用图片接口代替视频的首帧能力。