aisplice

API-Referenz

Responses

Modelle für diesen Endpunkt (5)

gpt-5.6-lunagpt-6-astragpt-6-lunagpt-6-sol+1
In der Workbench ausprobieren
POST/v1/responses

Das Format der OpenAI Responses API — ein einzelnes input-Feld, strukturierte Ausgabeelemente und Reasoning-Zusammenfassungen bei Modellen, die sie bereitstellen.

#Anfrageparameter

  • modelstringerforderlich

    Modell-ID aus /v1/models. Das Gateway ermittelt daraus den Upstream-Anbieter.

  • inputstring | arrayerforderlich

    Der Prompt: ein einfacher String oder ein Array von Eingabeelementen.

  • instructionsstringoptional

    Anweisungen auf Systemebene, entspricht einer system-Nachricht.

  • streambooleanoptional

    Streamt response.*-SSE-Events statt eines einzelnen JSON-Bodys.

  • max_output_tokensintegeroptional

    Obergrenze für generierte Tokens; begrenzt auch die vorab reservierte Kontingentschätzung.

  • toolsarrayoptional

    Funktionsdeklarationen, die das Modell aufrufen darf — siehe Leitfaden zum Tool-Calling.

  • previous_response_idstringoptional

    Eine Folgerunde an eine frühere Antwort anhängen, ohne den Verlauf erneut zu senden.

#Lange Gespräche komprimieren

POST/v1/responses/compact

Compaction verdichtet ein Gespräch, das zu lang geworden ist, um es immer wieder mitzusenden, und gibt die gekürzte Fassung zum Weiterverwenden zurück. Diesen Aufruf machen Coding-Agents, wenn sich eine Sitzung dem Kontextlimit nähert.

  • modelstringerforderlich

    Ein Modell, das Compaction unterstützt. Andere lehnen diesen Pfad mit unsupported_endpoint ab.

  • inputarray | stringoptional

    Das zu komprimierende Gespräch im input-Format der Responses API.

  • instructionsstring | arrayoptional

    Was beim Komprimieren erhalten bleiben soll — zum Beispiel „jeden Dateipfad und jede Entscheidung beibehalten“.

  • previous_response_idstringoptional

    Von einer gespeicherten Antwort aus fortfahren, statt den gesamten Verlauf erneut zu senden.

compacted.json
{
  "id": "resp_…",
  "object": "response",
  "created_at": 1789000000,
  "output": [ /* the compacted conversation */ ],
  "usage": {"input_tokens": 8120, "output_tokens": 240, "total_tokens": 8360}
}

Nie gestreamt, immer nach Tokens abgerechnet

Compaction hat keine Streaming-Variante — stream:true gehört nicht zu dieser Anfrage. Der Preis richtet sich wie bei jedem anderen Responses-Aufruf nach den gelesenen und geschriebenen Tokens, komprimieren Sie also gezielt und nicht in jeder Runde.

#Zugehörige Fehler

  • 400 invalid_request_errorFehlerhafter Body oder für dieses Modell nicht unterstützter Parameter.
  • 401Ungültiges oder fehlendes Bearer-Token. Auf diesem Pfad gibt es kein error.code — werten Sie den Status aus.
  • 402 insufficient_user_quotaDas Wallet-Guthaben deckt die vorab reservierte Schätzung nicht.
  • 429Drosselung pro Schlüssel. Leerer Body; warten Sie Retry-After ab. Ein 429, das insufficient_user_quota enthält, ist dagegen ein tägliches Ausgabenlimit.
  • 503 model_not_foundUnbekanntes Modell, oder derzeit bedient es kein funktionsfähiger Kanal.

Vollständige Fehlercode-Tabelle →

#Beispielanfrage

curl https://www.aisplice.store/v1/responses \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-luna",
    "input": "Say hello."
  }'

#Antwort

response.json
{
  "id": "resp_…",
  "object": "response",
  "model": "gpt-5.6-luna",
  "output": [{
    "type": "message",
    "role": "assistant",
    "content": [{"type": "output_text", "text": "Hello!"}]
  }],
  "usage": {"input_tokens": 9, "output_tokens": 3, "total_tokens": 12}
}

Immer noch nicht gelöst?

Senden Sie uns die Anfrage-ID oder die Fehlermeldung, und wir sehen uns das an.

ZurückChat CompletionsWeiterMessages (Anthropic-Format)