网关地址
默认推荐:
https://vip.zpika.com
以下地址同样可用:
https://aivideo.zpika.com
文档示例统一使用 https://vip.zpika.com。若你的客户端已配置为 aivideo.zpika.com,把域名替换即可,路径不变。
认证方式
所有请求都需要在请求头中携带 API Key:
Authorization: Bearer sk-你的密钥
调用时请选择分组:gpt-image-2 超分。
错误提示(单独说明)
出现 400 / 内容拒绝时,通常不是网络问题
多半是提示词触发了上游内容安全策略(违规、版权、可识别真人等)。请修改 prompt 后重试,不要反复提交同一条内容。完整避坑请看 内容审查指南(视频 / 图片)。
- 测试时请使用有意义的提示词,例如
cat、一只西瓜在跳舞;避免只用test这类无意义词。 - 尽量避免:可识别真人正脸、未成年人、品牌 Logo、受保护 IP、色情暴力等敏感内容。
- 若返回鉴权失败 / 401 / 403,优先检查 Key、分组是否选对(应为 gpt-image-2 超分)。
- 若返回超时或 5xx,可稍后重试;内容审查类拒绝重试无效。
请求示例
curl
curl -s https://vip.zpika.com/v1/images/generations \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "一只西瓜在跳舞,电影级光影,超高细节,写实质感",
"n": 1,
"size": "4096*4096"
}'
使用 aivideo 网关
curl -s https://aivideo.zpika.com/v1/images/generations \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "一只西瓜在跳舞,电影级光影,超高细节,写实质感",
"n": 1,
"size": "4096*4096"
}'
请求参数
| 字段 | 说明 |
|---|---|
model | 固定为 gpt-image-2 |
prompt | 必填,图片描述文本 |
n | 生成数量,示例为 1 |
size | 输出尺寸。示例高清尺寸:4096*4096 |
返回说明
接口遵循 OpenAI Images 风格返回。常见字段:
| 字段 | 说明 |
|---|---|
created | 创建时间戳 |
data | 结果数组 |
data[].b64_json | base64 图片数据(若返回该字段) |
data[].url | 图片链接(若返回该字段) |
具体是返回 base64 还是 URL,取决于上游与当前渠道配置。客户端建议同时兼容两种字段。
返回示例(示意)
{
"created": 1714200000,
"data": [
{
"b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
}
]
}
接入注意
- 这是同步生图接口,请求会阻塞到生成完成再返回。
- 高分辨率(如
4096*4096)耗时更长,请把客户端超时时间调大(建议 ≥ 180s)。 - 分组请选择 gpt-image-2 超分,模型名必须是
gpt-image-2。 - 若你还需要 Gemini 原生格式 / 4K banana 渠道,请看 Gemini 生图文档。