Процесс заявки
Чтобы использовать OpenAI Images Generations API, сначала перейдите на страницу OpenAI Images Generations API и нажмите кнопку «Acquire», чтобы получить необходимые для запроса учетные данные:
Если вы еще не вошли в систему или не зарегистрированы, вас автоматически перенаправят на страницу входа, пригласив зарегистрироваться и войти в систему. После входа или регистрации вы автоматически вернетесь на текущую страницу.
При первой подаче заявки вам будет предоставлен бесплатный лимит, который позволяет бесплатно использовать этот API.
Основное использование
Теперь вы можете заполнить соответствующие поля на интерфейсе, как показано на рисунке:
authorization, которое можно выбрать прямо из выпадающего списка. Другой параметр — это model, model — это категория модели, которую мы выбираем для использования на официальном сайте OpenAI DALL-E, здесь у нас в основном есть 1 модель, подробности можно посмотреть в предоставленной модели. Последний параметр — это prompt, prompt — это подсказка, которую мы вводим для генерации изображения.
Также вы можете заметить, что справа есть соответствующий сгенерированный код вызова, вы можете скопировать код и сразу запустить его, или просто нажать кнопку «Try» для тестирования.
created, ID, созданный для этой генерации изображения, используется для уникальной идентификации этой задачи.data, содержит информацию о результате генерации изображения.
data содержится конкретная информация о сгенерированном изображении, где url — это ссылка на детали сгенерированного изображения, как показано на рисунке.
Параметр качества изображения quality
Далее будет описано, как установить некоторые детализированные параметры результата генерации изображения, среди которых параметр качества изображения quality включает два варианта: первый standard обозначает стандартное изображение, другой hd обозначает, что создаваемое изображение имеет более тонкие детали и большую согласованность.
Ниже установлен параметр качества изображения на standard, конкретные настройки показаны на рисунке:
standard выглядит следующим образом:
hd, можно получить изображение, показанное на следующем рисунке:
hd, имеет более тонкие детали и большую согласованность по сравнению с standard.
Параметр размера изображения size
我们还可以设置生成图片的尺寸大小，我们可以进行下面的设置。
下面设置图片的尺寸大小为 1024 * 1024 ，具体设置如下图：
1024 * 1024 的生成图片如下图所示：
1792 * 1024 ，可以得到如下图所示的图片：
可以看到图片的尺寸大小很明显不一样，另外还可以设置更多尺寸大小，详情信息参考我们官网文档。
图片风格参数 style
图片风格参数 style 包含俩个参数，第一种 vivid 表示生成的图片是更加生动的，另一种 natural 表示生成的图片更加的自然一点。
下面设置图片风格参数为 vivid ，具体设置如下图：
vivid 的生成图片如下图所示：
natural ，可以得到如下图所示的图片：
vivid 比 natural 生成的图片具有更加生动逼真。
图片链接的格式参数 response_format
最后一个图片链接的格式参数 response_format 也有俩种，第一种 b64_json 是对图片链接进行 Base64 编码，另一种 url 就是普通的图片链接，可以直接查看图片。
下面设置图片链接的格式参数为 url ，具体设置如下图：
url для сгенерированного изображения — Изображение URL это можно напрямую открыть, содержание изображения показано на следующем изображении:
b64_json, можно получить результат с закодированной в Base64 ссылкой на изображение, конкретный результат показан на следующем изображении:
Асинхронный обратный вызов
Поскольку время генерации изображений API OpenAI может быть относительно долгим, если API долго не отвечает, HTTP-запрос будет поддерживать соединение, что приведет к дополнительному расходу системных ресурсов, поэтому этот API также поддерживает асинхронные обратные вызовы. Общий процесс таков: когда клиент инициирует запрос, он дополнительно указывает полеcallback_url, после чего API немедленно возвращает результат, содержащий информацию о поле task_id, представляющем текущий идентификатор задачи. Когда задача завершена, результат сгенерированного изображения будет отправлен на указанный клиентом callback_url в формате POST JSON, который также включает поле task_id, так что результат задачи можно связать по ID.
Давайте рассмотрим конкретные действия на примере.
Во-первых, Webhook-обратный вызов — это служба, которая может принимать HTTP-запросы, разработчик должен заменить его на URL своего собственного HTTP-сервера. Здесь для удобства демонстрации используется публичный сайт примера Webhook https://webhook.site/, открыв этот сайт, вы получите URL Webhook, как показано на изображении:
Скопировав этот URL, вы можете использовать его в качестве Webhook, пример здесь — https://webhook.site/3d32690d-6780-4187-a65c-870061e8c8ab.
Далее мы можем установить поле callback_url на указанный выше URL Webhook, а также заполнить соответствующие параметры, как показано в следующем коде:
task_id, поле data содержит такие же результаты генерации изображений, как и при синхронном вызове, с помощью поля task_id можно связать задачи.
Обработка ошибок
При вызове API, если возникнет ошибка, API вернет соответствующий код ошибки и информацию. Например:400 token_mismatched: Неверный запрос, возможно, из-за отсутствующих или недействительных параметров.400 api_not_implemented: Неверный запрос, возможно, из-за отсутствующих или недействительных параметров.401 invalid_token: Неавторизован, недействительный или отсутствующий токен авторизации.429 too_many_requests: Слишком много запросов, вы превысили лимит частоты.500 api_error: Внутренняя ошибка сервера, что-то пошло не так на сервере.