Przejdź do głównej treści
OpenAI niedawno udostępniło interfejs do tworzenia odpowiedzi modelu. Udostępniaj wejście tekstowe lub obrazowe, aby generować wyjście tekstowe lub obrazowe. Pozwól modelowi wywoływać własny niestandardowy kod lub używać wbudowanych narzędzi, takich jak wyszukiwanie w sieci lub wyszukiwanie plików, aby używać własnych danych jako wejścia do odpowiedzi modelu. Ten dokument przedstawia głównie proces korzystania z OpenAI Responses API, dzięki któremu możemy łatwo korzystać z oficjalnej funkcji OpenAI do tworzenia odpowiedzi modelu.

GPT-6.1 Sol

Użyj model: "gpt-6.1-sol", aby wybrać ten model. Obsługuje wyjście strumieniowe, wywoływanie funkcji, wyjście strukturalne i wejście obrazowe. W pierwszym tygodniu od udostępnienia jest dostępny wyłącznie dla zweryfikowanych posiadaczy ACE T1+ (co najmniej 100 000 ACE) lub upoważnionych użytkowników; dokładny czas dostępności zależy od komunikatu o dostępie w konsoli. Poziom rozumowania obsługuje low, medium, high, xhigh i max, tymczasowo nie obsługuje none ani minimal. Zaleca się rozpoczęcie od reasoning: {"effort": "low"}. Gdy wejście przekracza 272 000 tokenów, do całego żądania stosowana jest cena długiego kontekstu, a opłata zależy od aktualnej ceny w konsoli.

Proces składania wniosku

Aby korzystać z OpenAI Responses API, najpierw przejdź do konsoli Ace Data Cloud, aby uzyskać swój API Token i zachować go jako zapasowy. Jeśli nie jesteś jeszcze zalogowany lub zarejestrowany, zostaniesz automatycznie przekierowany na stronę logowania z zaproszeniem do rejestracji i logowania, a po zakończeniu automatycznie wrócisz na bieżącą stronę. Jeden API Token umożliwia wywoływanie wszystkich usług platformy, bez konieczności osobnego składania wniosku dla każdej usługi. Przy pierwszym wniosku otrzymasz darmowy limit, który pozwala na bezpłatne wypróbowanie; gdy limit jest niewystarczający, możesz doładować uniwersalne saldo w konsoli.
📘 Pełna dokumentacja: OpenAI Responses API →

Podstawowe użycie

Następnie można w interfejsie wypełnić odpowiednią treść, jak pokazano na ilustracji:

Przy pierwszym użyciu tego interfejsu musimy wypełnić co najmniej trzy elementy: jednym jest authorization, który można bezpośrednio wybrać z listy rozwijanej. Innym parametrem jest model, model to wybrany przez nas typ modelu z oficjalnej strony OpenAI ChatGPT, tutaj mamy głównie 20 modeli, szczegóły można zobaczyć w udostępnionych przez nas modelach. Ostatnim parametrem jest input, input to tablica wprowadzonych przez nas promptów, jest to tablica, co oznacza, że można jednocześnie przesłać wiele promptów, każdy prompt zawiera role i content, gdzie role oznacza rolę osoby zadającej pytanie, udostępniamy trzy tożsamości: user, assistant, system. Drugie content to konkretna treść naszego pytania. Jednocześnie można zauważyć, że po prawej stronie znajduje się generowanie odpowiedniego kodu wywołania, można skopiować kod i uruchomić go bezpośrednio, można też bezpośrednio kliknąć przycisk „Try”, aby przeprowadzić test. Często używane opcjonalne parametry:
  • max_tokens: ogranicza maksymalną liczbę tokenów pojedynczej odpowiedzi.
  • temperature: losowość generowania, między 0 a 2, im większa wartość, tym większe rozproszenie.
  • n: ile kandydatów odpowiedzi generować jednorazowo.
  • response_format: ustawienie formatu zwracanego wyniku.
  • tools: definicja wywołania funkcji/narzędzi.
  • background: czy uruchamiać asynchronicznie w tle.

Po wywołaniu widzimy, że zwrócony wynik jest następujący:
Zwrócony wynik ma wiele pól, opisanych poniżej:
  • id, ID wygenerowanego zadania tej rozmowy, używane do jednoznacznej identyfikacji zadania tej rozmowy.
  • model , wybrany model z oficjalnej strony OpenAI ChatGPT.
  • output, informacje o odpowiedzi udzielonej przez ChatGPT na prompt.
  • usage : informacje statystyczne o tokenach dla tej sesji pytań i odpowiedzi.
Wśród nich output zawiera informacje o odpowiedzi ChatGPT, a znajdujące się w nim output to ChatGPT, co można zobaczyć, jak pokazano na ilustracji.

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

Odpowiedź strumieniowa

Ten interfejs obsługuje również odpowiedź strumieniową, co jest bardzo przydatne przy integracji ze stronami internetowymi i umożliwia stronie uzyskanie efektu wyświetlania znak po znaku. Jeśli chcesz zwracać odpowiedź strumieniowo, możesz zmienić parametr stream w nagłówku żądania na true. Modyfikacja jest pokazana na ilustracji, jednak kod wywołania musi zostać odpowiednio zmieniony, aby obsługiwać odpowiedź strumieniową.

Po zmianie stream na true API będzie zwracać odpowiednie dane JSON wiersz po wierszu, a na poziomie kodu musimy wprowadzić odpowiednie zmiany, aby uzyskać wyniki wiersz po wierszu. Przykładowy kod wywołania w Pythonie:
Efekt wyjściowy jest następujący:
Można zauważyć, że w odpowiedzi znajduje się wiele data, a delta wewnątrz data jest najnowszą treścią odpowiedzi, co jest zgodne z treścią przedstawioną powyżej. delta jest nowo dodaną treścią odpowiedzi, którą można na podstawie wyniku zintegrować z własnym systemem. Odpowiedź strumieniowa kończy się stanem response.completed lub response.incomplete; usage w stanie końcowym jest końcowym zużyciem tokenów dla tego żądania, a także podstawą rozliczenia. Jeśli klient rozłączy się przed osiągnięciem stanu końcowego, to żądanie zostanie zarejestrowane jako zamknięte przez klienta (499), a opłata nie zostanie naliczona na podstawie lokalnie oszacowanych tokenów; jeśli połączenie zakończy się normalnie, ale nie zostanie otrzymany stan końcowy ani końcowe usage, to żądanie zostanie zarejestrowane jako niekompletna odpowiedź (502), również bez naliczania opłaty na podstawie oszacowanych tokenów. W przypadku wystąpienia tych dwóch sytuacji należy ponownie wysłać żądanie. Zwrócony wynik data zawiera łącznie wiele pól, które przedstawiono poniżej:
  • item_id, ID wygenerowanego zadania tej rozmowy, używane do jednoznacznej identyfikacji tego zadania rozmowy.
  • type, typ wygenerowanego zadania Responses tej rozmowy.
  • model , wybrany model z oficjalnej strony OpenAI ChatGPT.
  • delta, informacje odpowiedzi udzielonej przez ChatGPT na słowa zapytania.
JavaScript jest również obsługiwany, na przykład kod wywołania strumieniowego w Node.js wygląda następująco:
Przykładowy kod Java:
Inne języki można dodatkowo samodzielnie dostosować, zasada jest taka sama.

Wieloturowa rozmowa

Jeśli chcesz zintegrować funkcję wieloturowej rozmowy, musisz przesłać wiele słów zapytania w polu input, a konkretny przykład wielu słów zapytania pokazano na poniższym obrazku:

Przykładowy kod wywołania w Pythonie:
Przesyłając wiele słów zapytania, można łatwo zrealizować wieloturową rozmowę i uzyskać następującą odpowiedź:
Można zauważyć, że informacje zawarte w output są zgodne z treścią podstawowego użycia; obejmuje to szczegółową treść odpowiedzi ChatGPT na wiele rozmów, dzięki czemu można odpowiadać na odpowiednie pytania na podstawie wielu treści rozmów.

Model wizualny

gpt-4o to wielomodalny duży model językowy opracowany przez OpenAI, który na podstawie GPT-4 dodaje zdolność rozumienia obrazu. Model ten może jednocześnie przetwarzać dane wejściowe w postaci tekstu i obrazów, realizując rozumienie i generowanie między modalnościami. Przetwarzanie tekstu przy użyciu modelu gpt-4o jest zgodne z podstawową zawartością użycia opisaną powyżej, poniżej krótko przedstawiono sposób korzystania ze zdolności przetwarzania obrazów modelu. Korzystanie ze zdolności przetwarzania obrazów modelu gpt-4o polega głównie na dodaniu pola type na podstawie oryginalnej zawartości content, poprzez to pole można określić, czy przesyłany jest tekst, czy obraz, a tym samym korzystać ze zdolności przetwarzania obrazów modelu gpt-4o, poniżej opisano głównie użycie tej funkcji na dwa sposoby: Curl i Python.
  • Sposób za pomocą skryptu Curl
  • Sposób za pomocą skryptu Python
Następnie można uzyskać poniższy wynik, informacje o polach w wyniku są zgodne z opisem powyżej, a szczegóły są następujące:
Można zauważyć, że treść odpowiedzi jest oparta na obrazie, dlatego za pomocą powyższych dwóch sposobów można łatwo korzystać ze zdolności przetwarzania tekstu i obrazów modelu gpt-4.1. Oprócz gpt-4.1 istnieje również model o niższym koszcie, nazywany gpt-4o-mini. gpt-4o-mini jest najnowszą generacją dużego modelu językowego opracowanego przez OpenAI, nie tylko szybko odpowiada, ale również jest tańszy i także obsługuje multimodalność. Korzystanie z funkcji vision można sprawdzić w treści dotyczącej użycia modelu gpt-4.1 powyżej.

Tworzenie modelu przetwarzania plików

Przykład żądania:
Przykładowy wynik:
Można zauważyć, że przetworzyliśmy również plik wejściowy, a wynik jest podobny do powyższego.

Obsługa błędów

Podczas wywoływania API, jeśli wystąpi błąd, API zwróci odpowiedni kod błędu i informację. Na przykład:
  • 400 token_mismatched: Bad request, possibly due to missing or invalid parameters.
  • 400 api_not_implemented: Bad request, possibly due to missing or invalid parameters.
  • 401 invalid_token: Unauthorized, invalid or missing authorization token.
  • 429 too_many_requests: Too many requests, you have exceeded the rate limit.
  • 500 api_error: Internal server error, something went wrong on the server.

Przykład odpowiedzi błędu

Wnioski

Dzięki temu dokumentowi dowiedziałeś się już, jak korzystać z OpenAI Responses API, aby łatwo zaimplementować funkcję tworzenia Responses oficjalnego OpenAI. Mamy nadzieję, że ten dokument pomoże Ci lepiej zintegrować i korzystać z tego API. Jeśli masz jakiekolwiek pytania, skontaktuj się w dowolnym momencie z naszym zespołem wsparcia technicznego.