Responses API — POST /v1/responses

Der /v1/responses-Endpunkt implementiert die OpenAI Responses API, die zustandsbehaftete Mehrfachdialoge mit integrierter Verwaltung des Gesprächsverlaufs unterstützt. Er ist eine Alternative zu /v1/chat/completions für Workflows, die das neuere Antwortformat von OpenAI erfordern. Übergeben Sie eine previous_response_id, um ein Gespräch fortzusetzen, ohne den vollständigen Nachrichtenverlauf erneut zu senden.

Endpunkt

POST https://router.flatkey.ai/v1/responses

Wann dieser Endpunkt verwendet werden sollte

Verwenden Sie /v1/responses, wenn:

Ihre Anwendung auf der OpenAI Responses API aufgebaut ist
Sie eine zustandsbehaftete Gesprächsverwaltung benötigen
Sie den Parameter previous_response_id für Mehrfachdialoge verwenden

Für die meisten neuen Integrationen ist /v1/chat/completions der empfohlene Endpunkt und bietet breitere Modellunterstützung.

Anfrage

Header	Wert
`Authorization`	`Bearer $FLATKEY_API_KEY`
`Content-Type`	`application/json`

Body-Parameter

string

erforderlich

Zu verwendende Modell-ID. Hier sind nur Modelle gültig, die das Responses-API-Format unterstützen.

string | array

erforderlich

Die Benutzereingabe für diesen Gesprächsschritt. Kann ein String oder ein Array von Inhaltsobjekten sein.

string

Anweisungen auf Systemebene für das Modell (entspricht der system-Nachricht bei Chat-Completions).

string

Die id einer vorherigen Antwort. Wenn angegeben, setzt das Modell das Gespräch von diesem Punkt an fort, ohne dass der Client den Verlauf erneut senden muss.

integer

Maximale Anzahl der zu generierenden Token.

boolean

Wenn true, wird ein Stream von Server-Sent Events zurückgegeben. Standard: false.

Beispielanfrage

python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FLATKEY_API_KEY"],
    base_url="https://router.flatkey.ai/v1",
)

response = client.responses.create(
    model="gpt-4o",
    input="What is the capital of Japan?",
    instructions="Answer concisely.",
)

print(response.output_text)

Mehrfachdialog mit previous_response_id

python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FLATKEY_API_KEY"],
    base_url="https://router.flatkey.ai/v1",
)

# First turn
response1 = client.responses.create(
    model="gpt-4o",
    input="My name is Alice.",
)

# Second turn — continue from the first
response2 = client.responses.create(
    model="gpt-4o",
    input="What is my name?",
    previous_response_id=response1.id,
)

print(response2.output_text)  # "Your name is Alice."

Antwort

{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1710000000,
  "model": "gpt-4o",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {"type": "output_text", "text": "The capital of Japan is Tokyo."}
      ]
    }
  ],
  "usage": {
    "input_tokens": 15,
    "output_tokens": 9,
    "total_tokens": 24
  }
}

Antwortfelder

string

Eindeutiger Bezeichner für diese Antwort. Übergeben Sie ihn als previous_response_id, um das Gespräch fortzusetzen.

string

Immer "response".

integer

Unix-Zeitstempel des Zeitpunkts, zu dem die Antwort erstellt wurde.

string

Das Modell, das die Antwort generiert hat.

array

Array von Ausgabeobjekten, die vom Modell erzeugt wurden.

Anzeigen Eigenschaften des Ausgabeelements

string

Der Ausgabetyp. "message" für Textantworten.

string

Immer "assistant" für generierte Ausgaben.

array

Array von Inhaltsblöcken. Jeder Block hat einen type ("output_text") und einen text-String.

object

Token-Anzahl für die Abrechnung.

Anzeigen Eigenschaften der Nutzung

integer

Anzahl der verarbeiteten Eingabe-Token.

integer

Anzahl der generierten Ausgabe-Token.

integer

Summe der Eingabe- und Ausgabe-Token.

Überblick

Endpunkte

Responses API — POST /v1/responses

Endpunkt

Wann dieser Endpunkt verwendet werden sollte

Anfrage

Header

Body-Parameter

Beispielanfrage

Mehrfachdialog mit previous_response_id

Antwort

Antwortfelder

​Endpunkt

​Wann dieser Endpunkt verwendet werden sollte

​Anfrage

​Header

​Body-Parameter

​Beispielanfrage

​Mehrfachdialog mit previous_response_id

​Antwort

​Antwortfelder

Endpunkt

Wann dieser Endpunkt verwendet werden sollte

Anfrage

Header

Body-Parameter

Beispielanfrage

Mehrfachdialog mit previous_response_id

Antwort

Antwortfelder