- Third-party
- Zero data retention
OpenAI 的新一代图像模型,可根据文本提示词创建和编辑图像,支持多种质量级别、尺寸和输出格式。注意:不支持透明背景——如需透明 PNG,请使用 openai/gpt-image-1.5。
| 模型信息 | |
|---|---|
| 条款和许可证 | 链接 ↗ |
| 更多信息 | 链接 ↗ |
| 零数据保留 | 是 |
| 定价 | 在 Cloudflare 仪表板中查看定价 ↗ |
用法
const response = await env.AI.run(
'openai/gpt-image-2',
{ prompt: 'A golden retriever puppy playing in autumn leaves' },
)
console.log(response)curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"model": "openai/gpt-image-2",
"input": {
"prompt": "A golden retriever puppy playing in autumn leaves"
}
}'
{
"gatewayMetadata": {
"keySource": "BYOK"
},
"result": {
"image": "https://pub-04a6d208d361438ea01b797e6973bd19.r2.dev/catalog/openai__gpt-image-2/simple-generation.png"
},
"state": "Completed"
}示例
高质量 — 生成高质量的精细图像
const response = await env.AI.run(
'openai/gpt-image-2',
{
prompt:
'A detailed botanical illustration of exotic tropical flowers with fine line work and watercolor textures',
quality: 'high',
},
)
console.log(response)curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"model": "openai/gpt-image-2",
"input": {
"prompt": "A detailed botanical illustration of exotic tropical flowers with fine line work and watercolor textures",
"quality": "high"
}
}'
{
"gatewayMetadata": {
"keySource": "BYOK"
},
"result": {
"image": "https://pub-04a6d208d361438ea01b797e6973bd19.r2.dev/catalog/openai__gpt-image-2/high-quality.png"
},
"state": "Completed"
}自定义尺寸 — 生成竖版图像
const response = await env.AI.run(
'openai/gpt-image-2',
{
prompt: 'A towering redwood forest with sunbeams filtering through the canopy, misty atmosphere',
size: '1024x1536',
},
)
console.log(response)curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"model": "openai/gpt-image-2",
"input": {
"prompt": "A towering redwood forest with sunbeams filtering through the canopy, misty atmosphere",
"size": "1024x1536"
}
}'
{
"gatewayMetadata": {
"keySource": "BYOK"
},
"result": {
"image": "https://pub-04a6d208d361438ea01b797e6973bd19.r2.dev/catalog/openai__gpt-image-2/custom-size.png"
},
"state": "Completed"
}WebP 输出 — 以 WebP 格式生成图像,以减小文件大小
const response = await env.AI.run(
'openai/gpt-image-2',
{
prompt:
'A neon-lit cyberpunk cityscape at night with rain-slicked streets and holographic billboards',
output_format: 'webp',
quality: 'high',
},
)
console.log(response)curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"model": "openai/gpt-image-2",
"input": {
"prompt": "A neon-lit cyberpunk cityscape at night with rain-slicked streets and holographic billboards",
"output_format": "webp",
"quality": "high"
}
}'
{
"gatewayMetadata": {
"keySource": "BYOK"
},
"result": {
"image": "https://pub-04a6d208d361438ea01b797e6973bd19.r2.dev/catalog/openai__gpt-image-2/webp-output.webp"
},
"state": "Completed"
}图像编辑 — 通过在 images 数组中以 base64 形式(原始字符串或 data:image/{png|jpeg|webp};base64,... URI)提供现有图像来对其进行编辑。此调用会被路由到 OpenAI 的 /v1/images/edits 端点。示例使用了一张 32x32 的笑脸 PNG 小图——实际输入应为您源图像的完整 base64 编码。
const response = await env.AI.run(
'openai/gpt-image-2',
{
prompt:
'Transform this cartoon smiley into a photorealistic 3D clay sculpture sitting on a marble pedestal, studio lighting',
images: [
'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAnklEQVR42u2XQRLAIAgD8/839i/26qFCACm0ozPe1KwcQsAoXvgcAABxpwFowl4QWITHxW0LCBhxVngF4gKIirMQyBRnIJAtrkE8AuwWnyFEgKzfS1UA+3sWTju3BGAu7gKYIfBW+Q/AAQgBeMCkt1wVsLZjcwUYG2Z9wGLHZitWk1DEisubUYt2XB5IWkSyFqG0RSxvMZi0Gc1+Ox3fm00ZJ5mGVtkAAAAASUVORK5CYII=',
],
},
)
console.log(response)curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"model": "openai/gpt-image-2",
"input": {
"prompt": "Transform this cartoon smiley into a photorealistic 3D clay sculpture sitting on a marble pedestal, studio lighting",
"images": [
"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAnklEQVR42u2XQRLAIAgD8/839i/26qFCACm0ozPe1KwcQsAoXvgcAABxpwFowl4QWITHxW0LCBhxVngF4gKIirMQyBRnIJAtrkE8AuwWnyFEgKzfS1UA+3sWTju3BGAu7gKYIfBW+Q/AAQgBeMCkt1wVsLZjcwUYG2Z9wGLHZitWk1DEisubUYt2XB5IWkSyFqG0RSxvMZi0Gc1+Ox3fm00ZJ5mGVtkAAAAASUVORK5CYII="
]
}
}'
{
"gatewayMetadata": {
"keySource": "BYOK"
},
"result": {
"image": "https://pub-04a6d208d361438ea01b797e6973bd19.r2.dev/catalog/openai__gpt-image-2/image-edit.png"
},
"state": "Completed"
}多图像编辑 — 在 images 数组中传入最多 16 个 base64 字符串,以合成多张输入图像。模型会融合这些参考图像,适用于组合主体、风格或参考镜头。示例将一张笑脸 PNG 与一张红球 PNG 组合在一起。
const response = await env.AI.run(
'openai/gpt-image-2',
{
prompt:
'Combine these into a single photorealistic scene: a ceramic smiley-face mug next to a red rubber ball on a sunlit wooden table',
images: [
'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAnklEQVR42u2XQRLAIAgD8/839i/26qFCACm0ozPe1KwcQsAoXvgcAABxpwFowl4QWITHxW0LCBhxVngF4gKIirMQyBRnIJAtrkE8AuwWnyFEgKzfS1UA+3sWTju3BGAu7gKYIfBW+Q/AAQgBeMCkt1wVsLZjcwUYG2Z9wGLHZitWk1DEisubUYt2XB5IWkSyFqG0RSxvMZi0Gc1+Ox3fm00ZJ5mGVtkAAAAASUVORK5CYII=',
'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAhklEQVR42u2XsRHAMAgDNY73nye7OG2KgGUnGCWH76j/oTACPfnhcwIA3AoTGIFXRTADPlqjakYEDJwFWyJLAk/hrAQi4YwEouEjiVuBt+FXCVcgqntvCtjVvTUF7OremkIJlEAJ6Aikf0QSX3H6MpJYx+mBRCKSSYRSiVgucZjInGa/vY5PvB72/7IdMuAAAAAASUVORK5CYII=',
],
},
)
console.log(response)curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"model": "openai/gpt-image-2",
"input": {
"prompt": "Combine these into a single photorealistic scene: a ceramic smiley-face mug next to a red rubber ball on a sunlit wooden table",
"images": [
"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAnklEQVR42u2XQRLAIAgD8/839i/26qFCACm0ozPe1KwcQsAoXvgcAABxpwFowl4QWITHxW0LCBhxVngF4gKIirMQyBRnIJAtrkE8AuwWnyFEgKzfS1UA+3sWTju3BGAu7gKYIfBW+Q/AAQgBeMCkt1wVsLZjcwUYG2Z9wGLHZitWk1DEisubUYt2XB5IWkSyFqG0RSxvMZi0Gc1+Ox3fm00ZJ5mGVtkAAAAASUVORK5CYII=",
"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAhklEQVR42u2XsRHAMAgDNY73nye7OG2KgGUnGCWH76j/oTACPfnhcwIA3AoTGIFXRTADPlqjakYEDJwFWyJLAk/hrAQi4YwEouEjiVuBt+FXCVcgqntvCtjVvTUF7OremkIJlEAJ6Aikf0QSX3H6MpJYx+mBRCKSSYRSiVgucZjInGa/vY5PvB72/7IdMuAAAAAASUVORK5CYII="
]
}
}'
{
"gatewayMetadata": {
"keySource": "BYOK"
},
"result": {
"image": "https://pub-04a6d208d361438ea01b797e6973bd19.r2.dev/catalog/openai__gpt-image-2/multi-image-edit.png"
},
"state": "Completed"
}参数
prompt
stringrequired描述要生成或编辑的图像的文本提示词▶images[]
arraymaxItems: 16用于图像编辑的输入图像,1-16 项。每一项均为 base64 编码(原始字符串或 data:image/{png|jpeg|webp};base64,... URI)。quality
stringenum: low, medium, high, auto生成图像的质量size
stringenum: 1024x1024, 1024x1536, 1536x1024, auto生成图像的尺寸background
stringenum: transparent, opaque, auto背景透明度设置。使用 transparent 生成无背景图像,使用 opaque 生成纯色背景,或使用 auto 由模型决定。output_format
stringenum: png, webp, jpeg生成图像的输出格式image
stringformat: uri生成图像的 URL