VisionStory AI 图像生成 API 根据文本提示和可选参考素材生成或编辑图像。同步响应会返回图像 URL，你可以直接下载，也可以将其用于图生视频流程。
Beta。 只要账户拥有有效的 Pro 或更高等级订阅，其 API Key 即可调用此接口，无需额外申请能力白名单。
AI 图像接口
| 方法 | 路径 | 功能 |
|---|---|---|
GET | /api/v1/image/models | 查询图像模型、支持尺寸和单张图像的点数成本 |
POST | /api/v1/image | 根据提示词及可选参考素材生成图像 |
查询图像生成模型
Shell
curl -s -H "X-API-Key: $VISIONSTORY_API_KEY" https://openapi.visionstory.ai/api/v1/image/models
每个模型会返回画面比例、分辨率、参考图数量上限和 credit_per_image。当前模型包括：nano-banana（速度快、成本低）、nano-banana-2（均衡、擅长编辑）和 nano-banana-pro（最高质量、支持 2K）。接入时应读取此接口的返回值，不要写死模型能力。
生成或编辑 AI 图像
传入模型接口返回的 model_id 和 prompt。可选传入最多 4 个 refs（参考图），用于指定风格或主体，也可用于编辑图像：通过提示词说明修改要求并附上参考图即可，无需蒙版。
Shell
curl -s -X POST -H "X-API-Key: $VISIONSTORY_API_KEY" -H "Content-Type: application/json" -d '{"model_id": "nano-banana", "prompt": "A red panda barista in a cozy cafe, warm lighting", "aspect_ratio": "1:1", "resolution": "1K"}' https://openapi.visionstory.ai/api/v1/image
JSON
{
"data": {
"url": "https://cdn.visionstory.ai/example.png"
}
}
- 画面比例： 支持
1:1（默认）/2:3/3:2/3:4/4:3/4:5/5:4/9:16/16:9/21:9。 - 分辨率：
1K（默认）或2K。 - 参考图： 最多 4 张，每张使用
asset_id/url/inline_data。
将生成的图像用于视频
返回的 url 是普通图像地址，可以直接传给其他接口，例如作为 AI 视频的 first_frame 或 refs：
JSON
{
"model_id": "seedance-2.0",
"prompt": "the scene gently comes alive, slow camera push-in",
"first_frame": {
"url": "https://cdn.visionstory.ai/example.png"
}
}
计费、限制与存储
- 默认不加入素材库。 接口返回图像 URL，但不会自动保存到素材库。如需可复用的
asset_id，请通过POST /api/v1/asset上传。 - 计费： 按图像张数扣除点数，仅在成功时收费；单张成本见模型接口的
credit_per_image。 - 并发： Beta 期间，每个 API Key 的同步生成并发数较低；超出限制的请求会被拒绝，不会排队。