图片生成

除了文本对话，Aivisx Link 还提供图片生成能力。

前置条件

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

基础用法

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"
  }'

主要参数：

参数	说明
model	图片模型名，见「模型广场」
prompt	提示词
size	分辨率，如 1024x1024、2048x2048
n	生成张数
response_format	返回 URL 还是 base64

图生图与编辑

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

异步任务

高清图生成耗时长，同步请求容易超时。改用异步接口：

# 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 换成上一步返回的 id）
curl "https://aivisx.link/v1/images/tasks/TASK_ID" \
  -H "Authorization: Bearer sk-你的KEY"

轮询建议间隔 3~5 秒，状态变为成功后再取结果。

批量生图

方法	路径	用途
POST	/v1/images/batches	创建批量任务
GET	/v1/images/batches	任务列表
GET	/v1/images/batches/{id}	任务详情
GET	/v1/images/batches/{id}/items	逐项结果
GET	/v1/images/batches/{id}/items/{custom_id}/content	单项图片内容
GET	/v1/images/batches/{id}/download	打包下载全部结果
POST	/v1/images/batches/{id}/cancel	取消
DELETE	/v1/images/batches/{id}	删除记录
DELETE	/v1/images/batches/{id}/outputs	删除输出文件

批量任务适合「一次几十上百张」的场景，平台会做并发控制，避免打爆上游。

计费

• 按张计费，价格随分辨率档位（1K / 2K / 4K）变化
• 批量任务可能享受折扣倍率
• 失败的任务不计费

实时单价以站点「模型广场」展示为准。

提示词技巧

维度	示例
主体	一只橘色短毛猫（具体优于抽象）
场景	坐在木质窗台上，午后阳光
风格	写实摄影 / 吉卜力动画风格 / 3D 渲染 / 水彩插画
构图	特写 / 全身 / 俯视角度 / 广角
画质	高细节 / 电影级打光 / 8K

组合起来效果最好：

一只橘色短毛猫，坐在木质窗台上，午后阳光透过纱帘，
浅景深，写实摄影风格，高细节

常见问题

Q：403 或提示不支持 当前分组没有图片权限，换分组或联系客服。

Q：一直超时 用异步接口。

Q：返回的图片链接失效 生成的 URL 有时效，需及时下载保存到自己的存储。

相关文档

• API 参考
• 模型选择