Skip to main content
OpenAI har nyligen tillhandahållit ett gränssnitt för att skapa modellrespons. Ge text- eller bildinmatning för att generera text- eller bildutdata. Låt modellen anropa din egen anpassade kod eller använda inbyggda verktyg, som webbsökning eller fil sökning, för att använda dina egna data som inmatning för modellrespons. Detta dokument beskriver huvudsakligen användningsflödet för OpenAI Responses API, vilket gör att vi enkelt kan använda den officiella OpenAI:s funktion för att skapa modellrespons.

Ansökningsprocess

För att använda OpenAI Responses API, börja med att gå till Ace Data Cloud-konsolen för att hämta din API-token, som du kan spara för framtida bruk. Om du inte är inloggad eller registrerad kommer du automatiskt att omdirigeras till inloggningssidan där du uppmanas att registrera dig och logga in, och efter att ha slutfört detta kommer du automatiskt att återvända till den aktuella sidan. En API-token kan anropa alla plattformens tjänster, utan att behöva ansöka separat för varje tjänst. Första ansökan ger en gratis kvot, så att du kan prova gratis; när kvoten är slut kan du ladda på allmän balans i konsolen.
📘 Fullständig dokumentation: OpenAI Responses API →

Grundläggande Användning

Därefter kan du fylla i motsvarande innehåll på gränssnittet, som visas i bilden:

Vid första användning av detta gränssnitt behöver vi fylla i minst tre innehåll, en är authorization, som du direkt väljer i rullgardinsmenyn. Den andra parametern är model, model är den vi väljer att använda från OpenAI ChatGPT:s officiella modellkategorier, här har vi huvudsakligen 20 olika modeller, detaljer kan ses i de modeller vi tillhandahåller. Den sista parametern är input, input är vår inmatade frågaordarray, som är en array som representerar flera frågor som kan laddas upp samtidigt, varje fråga innehåller role och content, där role representerar frågeställarens roll, vi har tillhandahållit tre identiteter: user, assistant, system. Den andra content är det specifika innehållet i vår fråga. Samtidigt kan du notera att det finns motsvarande anropskod som genereras till höger, du kan kopiera koden för att köra den direkt, eller klicka på “Try” knappen för att testa. Vanliga valfria parametrar:
  • max_tokens: Begränsar det maximala antalet tokens för ett enda svar.
  • temperature: Genererar slumpmässighet, mellan 0-2, ju högre värde desto mer spritt.
  • n: Hur många kandidatsvar som ska genereras på en gång.
  • response_format: Inställningar för returformat.
  • tools: Definition av funktions-/verktygsanrop.
  • background: Om det ska köras asynkront i bakgrunden.

Efter anropet upptäckte vi att returresultatet ser ut som följer:
Returresultatet har flera fält, som beskrivs nedan:
  • id, ID för att generera denna dialoguppgift, används för att unikt identifiera denna dialoguppgift.
  • model, den valda OpenAI ChatGPT-modellen.
  • output, ChatGPT:s svarsinformation på frågeordet.
  • usage: Statistik över tokens för denna fråge- och svarspost.
Där output innehåller ChatGPT:s svarsinformation, och output är ChatGPT, som kan ses i bilden.

Det kan ses att content-fältet i output innehåller det specifika innehållet i ChatGPT:s svar.

Strömmande Respons

Detta gränssnitt stöder också strömmande respons, vilket är mycket användbart för webbgränssnitt, och kan låta webbplatsen visa text ord för ord. Om du vill ha en strömmande respons kan du ändra stream-parametern i begärningshuvudet till true. Ändringen visas i bilden, men anropskoden behöver ha motsvarande ändringar för att stödja strömmande respons.

När stream ändras till true, kommer API:et att returnera motsvarande JSON-data rad för rad, och på kodnivå behöver vi göra nödvändiga ändringar för att få radresultaten. Python-exempel på anropskod:
Utdataeffekten ser ut som följer:
Det kan ses att svaret innehåller många data, där data innehåller delta som är det senaste svaret, vilket stämmer överens med innehållet som beskrivs ovan. delta är det nya svaret, och du kan koppla det till ditt system baserat på resultatet. Samtidigt avgörs slutet av det strömmande svaret baserat på innehållet i data, om type-innehållet är response.completed, indikerar det att det strömmande svaret har avslutats helt. De returnerade data-resultaten har flera fält, som beskrivs nedan:
  • item_id, ID för att generera denna dialoguppgift, används för att unikt identifiera denna dialoguppgift.
  • type, typ av den genererade dialogresponsuppgiften.
  • model, den valda OpenAI ChatGPT-modellen.
  • delta, ChatGPT:s svarsinformation på frågeordet.
JavaScript stöds också, till exempel Node.js strömmande anropskod ser ut så här:
Java-exempel på kod:
Andra språk kan skrivas om på egen hand, principen är densamma.

Flera rundor av dialog

Om du vill koppla flera rundor av dialogfunktionalitet, behöver du ladda upp flera frågeord i input-fältet, specifika exempel på flera frågeord visas nedan:

Python-exempel på anropskod:
Genom att ladda upp flera frågeord kan du enkelt genomföra flera rundor av dialog och få följande svar:
Det kan ses att output innehåller information som är i linje med det grundläggande användningsinnehållet, vilket inkluderar ChatGPT:s specifika svar på flera dialoger, så att du kan svara på motsvarande frågor baserat på flera dialoginnehåll.

Visuella modeller

gpt-4o är en multimodal stor språkmodell utvecklad av OpenAI, som har ökat den visuella förståelseförmågan baserat på GPT-4. Denna modell kan hantera både text- och bildinmatningar samtidigt, vilket möjliggör korsmodal förståelse och generering. Användningen av gpt-4o-modellens textbehandling är densamma som det grundläggande användningsinnehållet som beskrivs ovan, nedan kommer en kort introduktion om hur man använder modellens bildbehandlingsförmåga. Användningen av gpt-4o-modellens bildbehandlingsförmåga sker huvudsakligen genom att lägga till ett type-fält på den ursprungliga content-innehållet, genom vilket fältet kan avgöra om det som laddas upp är text eller bild, och därmed använda gpt-4o-modellens bildbehandlingsförmåga. Nedan beskrivs huvudsakligen hur man anropar denna funktion med Curl och Python.
  • Curl skriptmetod
  • Python skriptmetod
Därefter kan man få följande resultat, där fältinformationen är densamma som ovan, specifikt som följer:
Man kan se att svaret är baserat på bilden, så genom ovanstående två metoder kan man enkelt använda gpt-4.1-modellens text- och bildbehandlingsförmåga. Förutom gpt-4.1 finns det en kostnadseffektivare modell som kallas gpt-4o-mini. gpt-4o-mini är OpenAI:s senaste generation av stora språkmodeller, som inte bara har snabbare svarstider utan också är billigare och stödjer multimodalitet. Användningen av vision-funktionen kan refereras till ovanstående innehåll om användningen av gpt-4.1-modellen.

Skapande av filhanteringsmodell

Begärningsexempel:
Exempelresultat:
可以看到,我们对输入的文件也进行了处理文件,结果与上文类似。

Felhantering

Vid anrop av API:et, om ett fel uppstår, kommer API:et att returnera motsvarande felkod och information. Till exempel:
  • 400 token_mismatched: Felaktig begäran, möjligtvis på grund av saknade eller ogiltiga parametrar.
  • 400 api_not_implemented: Felaktig begäran, möjligtvis på grund av saknade eller ogiltiga parametrar.
  • 401 invalid_token: Obefogad, ogiltig eller saknad auktoriseringstoken.
  • 429 too_many_requests: För många begärningar, du har överskridit hastighetsgränsen.
  • 500 api_error: Internt serverfel, något gick fel på servern.

Exempel på felrespons

Slutsats

Genom detta dokument har du fått en förståelse för hur du använder OpenAI Responses API för att enkelt implementera den officiella OpenAI:s skapande av Responses-funktion. Vi hoppas att detta dokument kan hjälpa dig att bättre integrera och använda API:et. Om du har några frågor, tveka inte att kontakta vårt tekniska supportteam.