Skip to main content
OpenAI niedawno udostępniło interfejs do tworzenia odpowiedzi modeli. Umożliwia on wprowadzenie tekstu lub obrazu w celu wygenerowania tekstu lub obrazu jako wyjścia. Pozwala modelowi na wywołanie własnego kodu lub korzystanie z wbudowanych narzędzi, takich jak wyszukiwanie w sieci lub wyszukiwanie plików, aby wykorzystać własne dane jako wejście do odpowiedzi modelu. Dokument ten głównie opisuje proces korzystania z OpenAI Responses API, dzięki któremu możemy łatwo korzystać z oficjalnej funkcji tworzenia odpowiedzi modeli OpenAI.

申请流程

Aby korzystać z OpenAI Responses API, najpierw przejdź do Ace Data Cloud 控制台, aby uzyskać swój token API, który należy zachować na przyszłość. Jeśli nie jesteś zalogowany lub zarejestrowany, automatycznie zostaniesz przekierowany na stronę logowania, aby zarejestrować się i zalogować, a po zakończeniu zostaniesz automatycznie przekierowany z powrotem na bieżącą stronę. Jeden token API wystarczy do wywołania wszystkich usług platformy, nie ma potrzeby składania osobnych wniosków dla każdej usługi. Przy pierwszym wniosku przyznawana jest darmowa kwota, aby można było skorzystać z doświadczenia; w przypadku niewystarczającej kwoty można doładować saldo ogólne w kontrolerze.
📘 Pełna dokumentacja: OpenAI Responses API →

基本使用

Następnie możesz wypełnić odpowiednie treści w interfejsie, jak pokazano na rysunku:

Podczas pierwszego korzystania z tego interfejsu musimy wypełnić co najmniej trzy pola: jedno to authorization, które można wybrać bezpośrednio z rozwijanej listy. Kolejnym parametrem jest model, model to kategoria modelu, którą wybieramy z oficjalnej strony OpenAI ChatGPT, mamy tutaj głównie 20 modeli, szczegóły można zobaczyć w dostarczonych modelach. Ostatnim parametrem jest input, input to tablica naszych pytań, jest to tablica, która pozwala na jednoczesne przesyłanie wielu pytań, każde pytanie zawiera role i content, gdzie role oznacza rolę pytającego, oferujemy trzy tożsamości: user, assistant, system. Drugie content to konkretna treść naszego pytania. Możesz również zauważyć, że po prawej stronie znajduje się odpowiedni kod wywołania, który możesz skopiować i uruchomić, lub możesz bezpośrednio kliknąć przycisk „Try”, aby przetestować. Często używane opcjonalne parametry:
  • max_tokens: ogranicza maksymalną liczbę tokenów w pojedynczej odpowiedzi.
  • temperature: generuje losowość, w zakresie od 0 do 2, im wyższa wartość, tym bardziej rozproszone.
  • n: ile kandydatów odpowiedzi generować jednocześnie.
  • response_format: ustawienia formatu zwrotu.
  • tools: definicja wywołania funkcji/narzędzi.
  • background: czy działa w tle asynchronicznie.

Po wywołaniu zauważamy, że wynik zwrotny wygląda następująco:
Wynik zwrotny zawiera wiele pól, które są opisane poniżej:
  • id, identyfikator zadania rozmowy, używany do unikalnego oznaczenia tego zadania rozmowy.
  • model, wybrany model OpenAI ChatGPT.
  • output, informacje o odpowiedzi ChatGPT na pytanie.
  • usage: statystyki dotyczące tokenów dla tej sesji pytania i odpowiedzi.
W tym przypadku output zawiera informacje o odpowiedzi ChatGPT, a wewnątrz output można zauważyć, jak pokazano na rysunku.

Można zauważyć, że pole content w output zawiera konkretną treść odpowiedzi ChatGPT.

流式响应

Ten interfejs obsługuje również odpowiedzi strumieniowe, co jest bardzo przydatne w integracji z witrynami internetowymi, umożliwiając wyświetlanie efektu wyświetlania słowo po słowie. Aby uzyskać odpowiedź strumieniową, można zmienić parametr stream w nagłówku żądania na true. Zmiana jak pokazano na rysunku, jednak kod wywołania musi być odpowiednio zmieniony, aby obsługiwał odpowiedzi strumieniowe.

Po zmianie stream na true, API będzie zwracać odpowiednie dane JSON linia po linii, w kodzie musimy wprowadzić odpowiednie zmiany, aby uzyskać wyniki linia po linii. Przykładowy kod wywołania w Pythonie:
Efekt wyjściowy wygląda następująco:
Można zauważyć, że odpowiedź zawiera wiele data, a data zawiera delta, który jest najnowszą treścią odpowiedzi, zgodną z opisanymi wcześniej treściami. delta to nowa treść odpowiedzi, którą można zintegrować z własnym systemem. Zakończenie odpowiedzi strumieniowej jest określane na podstawie zawartości data, jeśli zawartość type to response.completed, oznacza to, że odpowiedź strumieniowa została całkowicie zakończona. Zwracane wyniki data mają wiele pól, które są opisane poniżej:
  • item_id, identyfikator zadania rozmowy, używany do unikalnego oznaczenia tego zadania rozmowy.
  • type, typ zadania generowania odpowiedzi.
  • model, wybrany model OpenAI ChatGPT.
  • delta, informacje o odpowiedzi udzielone przez ChatGPT w odpowiedzi na pytanie.
JavaScript jest również obsługiwany, na przykład kod strumieniowego wywołania Node.js wygląda następująco:
Przykład kodu w Javie:
Inne języki można dostosować samodzielnie, zasada jest taka sama.

Wiele rund rozmowy

Jeśli chcesz zintegrować funkcję wielu rund rozmowy, musisz przesłać wiele pytań w polu input, konkretne przykłady wielu pytań są pokazane na poniższym obrazku:

Przykład kodu w Pythonie:
Przesyłając wiele pytań, można łatwo zrealizować wiele rund rozmowy i uzyskać następującą odpowiedź:
Można zauważyć, że informacje zawarte w output są zgodne z podstawowym użyciem, zawierają konkretne treści odpowiedzi ChatGPT na wiele rozmów, co pozwala na odpowiadanie na odpowiednie pytania na podstawie wielu treści rozmowy.

Model wizualny

gpt-4o to wielomodalny model językowy opracowany przez OpenAI, który na podstawie GPT-4 zwiększa zdolności rozumienia wizualnego. Model ten może jednocześnie przetwarzać tekst i obrazy, realizując zrozumienie i generowanie w różnych modalnościach. Przetwarzanie tekstu przy użyciu modelu gpt-4o jest zgodne z podstawowym użyciem opisanym wcześniej, poniżej krótko opisano, jak korzystać z możliwości przetwarzania obrazów modelu. Możliwości przetwarzania obrazów modelu gpt-4o są głównie realizowane poprzez dodanie pola type do istniejącej treści content, dzięki czemu można określić, czy przesyłany jest tekst, czy obraz, co pozwala na wykorzystanie możliwości przetwarzania obrazów modelu gpt-4o. Poniżej opisano, jak wywołać tę funkcję za pomocą Curl i Pythona.
  • Sposób skryptu Curl
  • Sposób skryptu Python
Następnie można uzyskać poniższy wynik, w którym informacje o polach są zgodne z powyższym tekstem, szczegóły są następujące:
Można zauważyć, że treść odpowiedzi opiera się na obrazie, dlatego za pomocą powyższych dwóch metod można łatwo wykorzystać zdolności przetwarzania tekstu i obrazu modelu gpt-4.1. Oprócz gpt-4.1, istnieje również model o niższych kosztach, zwany gpt-4o-mini. gpt-4o-mini to najnowsza generacja dużego modelu językowego opracowanego przez OpenAI, który nie tylko działa szybko, ale także jest tańszy i obsługuje multimodalność. Funkcjonalność wizji można znaleźć w treści dotyczącej użycia modelu gpt-4.1.

Tworzenie modelu przetwarzania plików

Przykład żądania:
Przykład wyniku:
Można zobaczyć, że przetworzyliśmy również przesłany plik, a wyniki są podobne do powyższych.

Obsługa błędów

Podczas wywoływania API, jeśli wystąpią błędy, API zwróci odpowiedni kod błędu i informacje. Na przykład:
  • 400 token_mismatched: Zły wniosek, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
  • 400 api_not_implemented: Zły wniosek, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
  • 401 invalid_token: Nieautoryzowany, nieprawidłowy lub brakujący token autoryzacyjny.
  • 429 too_many_requests: Zbyt wiele żądań, przekroczono limit szybkości.
  • 500 api_error: Błąd wewnętrzny serwera, coś poszło nie tak na serwerze.

Przykład odpowiedzi błędu

Wnioski

Dzięki temu dokumentowi zrozumiałeś, jak łatwo korzystać z OpenAI Responses API, aby zrealizować funkcję tworzenia odpowiedzi oficjalnego OpenAI. Mamy nadzieję, że ten dokument pomoże Ci lepiej zintegrować i korzystać z tego API. W razie jakichkolwiek pytań, prosimy o kontakt z naszym zespołem wsparcia technicznego.