OpenAI Images Edits API 的应用与使用

OpenAI 的图像编辑服务允许用户输入任意数量的图像和编辑指令输出修改后的图像。这篇文章将手把手地介绍如何使用 OpenAI Images Edits API使你能够轻松利用 OpenAI 官方的图像编辑功能。环境准备在开始之前请确保你已经注册并登录到 Ace Data Cloud。你需要一个有效的 API 密钥来进行身份验证。申请流程要使用 OpenAI Images Edits API首先访问 OpenAI Images Edits API 页面点击“获取”按钮以获得所需的凭据如果你尚未登录或注册系统会自动重定向到登录页面。登录或注册后你将被自动返回到当前页面。首次申请时系统会提供一个免费的配额让你可以免费使用该 API。基本使用接下来我们可以通过代码发起调用以下是使用CURL的示例curl -s -D (grep -i x-request-id 2) \ -o (jq -r .data[0].b64_json | base64 --decode gift-basket.png) \ -X POST https://api.acedata.cloud/v1/images/edits \ -H Authorization: Bearer {token} \ -F modelgpt-image-1 \ -F image[]test.png \ -F promptCreate a lovely gift basket with these items in it在使用此接口时我们需要填写至少四个信息authorization可以直接从下拉列表中选择model这是我们选择使用的 OpenAI 官方模型的类别prompt是生成图像的输入提示最后是image需要编辑图像的路径如下图所示使用 Python 的示例代码如下import base64 from openai import OpenAI client OpenAI() prompt Generate a photorealistic image of a gift basket on a white background labeled Relax Unwind with a ribbon and handwriting-like font, containing all the items in the reference pictures. result client.images.edit( modelgpt-image-1, image[ open(test.png, rb) ], promptprompt ) image_base64 result.data[0].b64_json image_bytes base64.b64decode(image_base64) # 保存图像到文件 with open(gift-basket.png, wb) as f: f.write(image_bytes)在使用 Python 时我们需要导入两个环境变量一个是OPENAI_BASE_URL其值为https://api.acedata.cloud/openai另一个是凭证OPENAI_API_KEY其值为从authorization中获取的值。在 Mac OS 中你可以使用以下命令设置环境变量export OPENAI_BASE_URLhttps://api.acedata.cloud/openai export OPENAI_API_KEY{token}调用后我们将在当前目录中生成一个名为gift-basket.png的图像具体结果如下至此我们完成了图像编辑操作。目前官方 Edits 任务仅支持两种模型dall-e-2和gpt-image-1。异步回调由于 OpenAI Images Edits API 的图像编辑可能需要较长时间如果 API 长时间未响应HTTP 请求会保持连接导致额外的系统资源消耗。因此该 API 也支持异步回调。整体流程为当客户端发起请求时指定一个额外的callback_url字段。客户端发起 API 请求后API 会立即返回一个包含task_id字段的结果表示当前的任务 ID。任务完成后编辑图像的结果将以 POST JSON 格式发送到客户端指定的callback_url并包含task_id字段以便通过 ID 关联任务结果。具体操作示例首先Webhook 回调是一个可以接收 HTTP 请求的服务开发者应将其替换为自己的 HTTP 服务器的 URL。为方便起见我们使用公共 Webhook 示例网站 https://webhook.site/打开此网站将获得一个 Webhook URL如下图所示复制此 URL可以用作 Webhook示例为https://webhook.site/3d32690d-6780-4187-a65c-870061e8c8ab。接下来我们可以将callback_url字段设置为上述 Webhook URL并填写相应参数代码如下curl -X POST https://api.acedata.cloud/v1/images/edits \ -H Authorization: Bearer {token} \ -F modelgpt-image-1 \ -F image[]test.png \ -F promptCreate a lovely gift basket with these items in it \ -F callback_urlhttps://webhook.site/3d32690d-6780-4187-a65c-870061e8c8ab调用后你将立即收到如下结果{ task_id: 6a97bf49-df50-4129-9e46-119aa9fca73c }片刻后我们可以在 Webhook URL 观察编辑图像的结果内容如下{ success: true, task_id: 6a97bf49-df50-4129-9e46-119aa9fca73c, trace_id: 9b4b1ff3-90f2-470f-b082-1061ec2948cc, data: { created: 1721626477, data: [ { b64_json: iVBORw0KGgo... } ] } }可以看到结果包含task_id字段并且data字段中包含与同步调用相同的图像编辑结果通过task_id字段能够关联任务。常见问题在调用 API 时如果出现错误API 将返回相应的错误代码和消息。例如400 token_mismatched错误请求可能是由于缺少或无效的参数。400 api_not_implemented错误请求可能是由于缺少或无效的参数。401 invalid_token未授权令牌无效或缺失。429 too_many_requests请求过多超出速率限制。500 api_error内部服务器错误服务器出现问题。错误响应示例{ success: false, error: { code: api_error, message: fetch failed }, trace_id: 2cf86e86-22a4-46e1-ac2f-032c0f2a4e89 }总结通过本文你已学习如何轻松使用 OpenAI 的图像编辑功能与 OpenAI Images Edits API。希望本文能帮助你更好地集成与使用该 API。如果你有任何问题请随时联系技术支持团队。技术标签#OpenAI #图像编辑 #API #开发教程 #AceDataCloud