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. Якщо у вас є будь-які питання, будь ласка, звертайтеся до нашої команди технічної підтримки.