Api Halo 文档中心

GPT Image API 接入与图片生成教程

使用 Api Halo 的 OpenAI 兼容图片生成接口调用 GPT Image 模型,包含 curl、Python 和安全建议。

发布与更新:2026-07-12 · 中文技术教程

接口与模型

图片生成使用 OpenAI 兼容 Images API。模型名称、尺寸、价格和可用性可能调整,调用前应查看模型广场。

接口:https://apihalo.cn/v1/images/generations
示例模型:gpt-image-2

curl 示例

curl https://apihalo.cn/v1/images/generations \
  -H "Authorization: Bearer 你的_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只戴宇航头盔的橘猫,电影级灯光",
    "size": "1024x1024"
  }'

Python 示例

from openai import OpenAI
client = OpenAI(api_key="你的_API_KEY", base_url="https://apihalo.cn/v1")
result = client.images.generate(
    model="gpt-image-2",
    prompt="极简未来城市海报,蓝紫色调",
    size="1024x1024"
)
print(result)

处理返回结果

不同模型或渠道可能返回图片 URL 或编码数据。程序应依据实际响应字段处理,并为网络超时、429 和无效参数增加错误处理。

常见问题

为什么尺寸参数无效?

模型支持的尺寸不一定相同,应以模型广场和接口实际能力为准。

为什么生成失败?

检查令牌分组、模型名、余额、提示词合规性和请求参数。

可以把 API Key 放网页里吗?

不可以。浏览器前端会暴露密钥,应由服务器端代发请求。

配套在线工具

教程看完后,可进入模型测试台,在同一个工作台中进行对话和图片生成。