Skip to main content
OpenAI недавно предоставила интерфейс для создания ответов модели. Предоставьте текстовый или графический ввод для генерации текстового или графического вывода. Позвольте модели вызывать ваш собственный пользовательский код или использовать встроенные инструменты, такие как веб-поиск или поиск по файлам, чтобы использовать ваши собственные данные в качестве ввода для ответов модели. Этот документ в основном описывает процесс использования OpenAI Responses API, с помощью которого мы можем легко использовать официальную функцию создания ответов модели OpenAI.

Процесс заявки

Чтобы использовать OpenAI Responses API, сначала перейдите в консоль Ace Data Cloud, чтобы получить ваш API Token, оставив его на всякий случай. Если вы еще не вошли в систему или не зарегистрированы, вы будете автоматически перенаправлены на страницу входа, пригласив вас зарегистрироваться и войти, после чего вы будете автоматически возвращены на текущую страницу. Один API Token позволяет вызывать все услуги платформы, не нужно отдельно запрашивать для каждой услуги. При первой заявке предоставляется бесплатный лимит, чтобы вы могли бесплатно протестировать; если лимит исчерпан, вы можете пополнить общий баланс в консоли.
📘 Полная документация: OpenAI Responses API →

Основное использование

Теперь вы можете заполнить соответствующие поля на интерфейсе, как показано на изображении:

При первом использовании этого интерфейса нам необходимо заполнить как минимум три поля: одно из них — authorization, которое можно выбрать прямо из выпадающего списка. Другой параметр — model, model — это категория модели, которую мы выбираем для использования с OpenAI ChatGPT, здесь у нас в основном есть 20 моделей, подробности можно посмотреть в предоставленных моделях. Последний параметр — input, input — это массив наших вопросов, который представляет собой массив, позволяющий одновременно загружать несколько вопросов, каждый из которых содержит role и content, где role обозначает роль задающего вопрос, мы предоставили три идентичности: user, assistant, system. Другой content — это конкретное содержание нашего вопроса. Также вы можете заметить, что справа есть соответствующий сгенерированный код вызова, вы можете скопировать код и сразу запустить его, или просто нажать кнопку «Попробовать» для тестирования. Распространенные дополнительные параметры:
  • max_tokens: ограничивает максимальное количество токенов в одном ответе.
  • temperature: генерирует случайность, от 0 до 2, чем больше значение, тем более разнообразным будет ответ.
  • n: сколько вариантов ответа генерировать за раз.
  • response_format: настройки формата ответа.
  • tools: определение вызова функций/инструментов.
  • background: будет ли выполняться в фоновом режиме асинхронно.

После вызова мы получаем следующий результат:
Возвращаемый результат содержит несколько полей, описание которых приведено ниже:
  • id, ID задачи диалога, созданной для уникальной идентификации этой задачи диалога.
  • model, выбранная модель OpenAI ChatGPT.
  • output, информация о ответе ChatGPT на заданные вопросы.
  • usage: статистическая информация о токенах для данного вопроса и ответа.
Где output содержит информацию о ответе ChatGPT, внутри которой output — это ответ ChatGPT, как показано на изображении.

Можно увидеть, что поле content внутри output содержит конкретное содержание ответа ChatGPT.

Потоковые ответы

Этот интерфейс также поддерживает потоковые ответы, что очень полезно для веб-интеграции, позволяя веб-странице реализовать эффект отображения по буквам. Если вы хотите получить потоковый ответ, вы можете изменить параметр stream в заголовке запроса на true. Изменение показано на изображении, однако код вызова должен быть соответствующим образом изменен, чтобы поддерживать потоковые ответы.

После изменения stream на true, API будет возвращать соответствующие JSON данные построчно, на уровне кода нам нужно внести соответствующие изменения, чтобы получить построчные результаты. Пример кода вызова на Python:
Вывод будет следующим:
Можно увидеть, что в ответе много data, а delta внутри data является последним ответом, что соответствует содержанию, описанному выше. delta — это новый ответ, который вы можете интегрировать в вашу систему. Завершение потокового ответа определяется по содержимому data, если type равно response.completed, это означает, что потоковый ответ завершен. Возвращаемые результаты data содержат несколько полей, описанных ниже:
  • item_id, ID задачи диалога, созданной для уникальной идентификации этой задачи.
  • type, тип задачи Responses, созданной для этого диалога.
  • model, выбранная модель OpenAI ChatGPT.
  • delta, информация о ответе ChatGPT на заданный вопрос.
JavaScript также поддерживается, например, код потокового вызова для Node.js выглядит следующим образом:
Пример кода на Java:
Другие языки можно переписать самостоятельно, принцип остается тем же.

Многоуровневый диалог

Если вы хотите интегрировать функцию многоуровневого диалога, вам нужно загрузить несколько вопросов в поле input, конкретные примеры нескольких вопросов показаны на изображении ниже:

Пример кода на Python:
Загрузив несколько вопросов, вы можете легко реализовать многоуровневый диалог и получить следующий ответ:
Можно увидеть, что информация в output соответствует основному использованию, это включает в себя конкретное содержание ответов ChatGPT на несколько диалогов, что позволяет отвечать на соответствующие вопросы на основе нескольких диалогов.

Визуальная модель

gpt-4o — это многомодальная большая языковая модель, разработанная OpenAI, которая добавляет возможности визуального понимания на основе GPT-4. Эта модель может одновременно обрабатывать текстовые и графические входные данные, реализуя кросс-модальное понимание и генерацию. Обработка текста с использованием модели gpt-4o аналогична основному использованию, описанному выше, ниже будет кратко описано, как использовать возможности обработки изображений модели. Использование возможностей обработки изображений модели gpt-4o в основном осуществляется путем добавления поля type к исходному содержимому content, с помощью которого можно определить, загружен ли текст или изображение, чтобы использовать возможности обработки изображений модели gpt-4o, ниже в основном описываются два способа вызова этой функции с помощью Curl и Python.
  • Curl скрипт
  • Python скрипт
Затем можно получить следующий результат, информация о полях в результате совпадает с вышеуказанным, конкретно следующим образом:
Можно увидеть, что содержание ответа основано на изображении, поэтому с помощью вышеуказанных двух способов можно легко использовать текстовые и визуальные возможности модели gpt-4.1. Кроме gpt-4.1, есть ещё одна более экономичная модель, называемая gpt-4o-mini. gpt-4o-mini — это последняя версия крупной языковой модели, разработанная OpenAI, которая не только быстро реагирует, но и стоит дешевле, также поддерживает мультимодальность. Использование функции vision можно посмотреть в содержании использования модели gpt-4.1 выше.

Создание модели обработки файлов

Пример запроса:
Пример результата:
可以看到,我们对输入的文件也进行了处理文件,结果与上文类似。

Ошибка обработки

При вызове API, если возникает ошибка, API возвращает соответствующий код ошибки и информацию. Например:
  • 400 token_mismatched:Неверный запрос, возможно, из-за отсутствующих или недействительных параметров.
  • 400 api_not_implemented:Неверный запрос, возможно, из-за отсутствующих или недействительных параметров.
  • 401 invalid_token:Неавторизованный, недействительный или отсутствующий токен авторизации.
  • 429 too_many_requests:Слишком много запросов, вы превысили лимит частоты.
  • 500 api_error:Внутренняя ошибка сервера, что-то пошло не так на сервере.

Пример ответа об ошибке

Заключение

С помощью этого документа вы узнали, как использовать OpenAI Responses API для легкой реализации функции создания Responses от официального OpenAI. Надеюсь, этот документ поможет вам лучше интегрировать и использовать этот API. Если у вас есть какие-либо вопросы, пожалуйста, не стесняйтесь обращаться в нашу техническую поддержку.