图片生成接入

Aivisx Link 支持通过 OpenAI 兼容的图片接口 进行文生图与图生图。这一页讲怎么把它接进你的程序或工具。

前置条件

图片生成需要 支持图片能力的分组。请先在控制台的「模型广场」确认你的分组是否包含图片模型，或咨询客服。

可用端点

方法	路径	用途
POST	/v1/images/generations	文生图（同步）
POST	/v1/images/edits	图生图 / 图片编辑
POST	/v1/images/generations/async	文生图（异步，提交任务）
POST	/v1/images/edits/async	图生图（异步）
GET	/v1/images/tasks/{task_id}	查询异步任务结果

快速调用

文生图

curl https://aivisx.link/v1/images/generations \
  -H "Authorization: Bearer sk-你的KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "一只戴着宇航头盔的橘猫，坐在月球表面，背景是地球，写实摄影风格",
    "size": "1024x1024"
  }'

返回结果里会包含图片的 URL 或 base64 数据，取决于你的 response_format 参数。

图生图 / 编辑

curl https://aivisx.link/v1/images/edits \
  -H "Authorization: Bearer sk-你的KEY" \
  -F "model=gpt-image-1" \
  -F "image=@./input.png" \
  -F "prompt=把背景换成雪山，保持主体不变"

同步 vs 异步

	同步接口	异步接口
适用场景	单张、交互式	批量、耗时长的任务
返回方式	请求结束后直接返回结果	先返回 task_id，再轮询结果
超时风险	高清图可能超时	无

高清大图或批量任务建议用异步接口：

# 1. 提交任务
curl https://aivisx.link/v1/images/generations/async \
  -H "Authorization: Bearer sk-你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-1","prompt":"赛博朋克风格的城市夜景","size":"2048x2048"}'

# 2. 用返回的 task_id 轮询
curl "https://aivisx.link/v1/images/tasks/TASK_ID" \
  -H "Authorization: Bearer sk-你的KEY"

批量生图

需要一次生成很多张图时，用批量接口：

方法	路径	用途
POST	/v1/images/batches	创建批量任务
GET	/v1/images/batches	列出任务
GET	/v1/images/batches/{id}	任务详情
GET	/v1/images/batches/{id}/items	逐项结果
GET	/v1/images/batches/{id}/download	打包下载
POST	/v1/images/batches/{id}/cancel	取消任务

批量任务适合「一次生成几十上百张」的场景，平台会串行/限流处理，避免打爆上游。

计费说明

图片按张计费，价格取决于分辨率档位（1K / 2K / 4K）。具体单价以站点「模型广场」页面实时展示为准。

• 批量任务可能有折扣倍率
• 失败的任务不计费

提示词技巧

• 具体比抽象好：一只橘色的短毛猫，坐在木质窗台上，午后阳光，浅景深 远好于 一只猫
• 指定风格：加上 写实摄影、吉卜力动画风格、3D 渲染、水彩插画
• 指定构图：特写、全身、俯视角度、广角
• 指定画质：高细节、电影级打光、8K

常见问题

Q：返回 403 或提示不支持 当前分组的 Key 没有图片权限。换一个支持图片的分组，或联系客服开通。

Q：生成很慢 高清图本身耗时就长，用异步接口避免超时。

Q：图片链接打不开 生成结果的 URL 有时效性，需要及时下载保存到自己的存储。

相关文档

• API 参考
• 模型选择
• 疑难杂症