Text & Chat
Response erstellen
Erstellt eine Response im Format der OpenAI Responses API
Verwenden Sie diesen Endpunkt, wenn die accepted_request_formats eines Modells openai_responses enthalten. Anfragen und Antworten verwenden das Format der Responses API und werden nicht konvertiert: Ein Modell ohne dieses Format gibt hier 400 zurück; verwenden Sie dafür stattdessen Chat Completions. Optionale Felder und unterstützte Werte hängen vom ausgewählten Modell ab.
Request-Body
ID des zu verwendenden Modells. Siehe Modelle für verfügbare Optionen.
Eingabe für die Response. Dies ist optional, wenn die Anfrage stattdessen einen wiederverwendbaren prompt verwendet oder eine gespeicherte Response mit previous_response_id fortsetzt.
Jedes Element ist ein Objekt mit einem type. Häufige Typen sind:
message: Eine Konversationsnachricht mit Rolle und Inhaltfunction_call: Eine Funktionsaufruf-Anforderungfunction_call_output: Ausgabe eines Funktionsaufrufsreasoning: Ein Thinking-Element aus einer früheren Response. Senden Sie es unverändert zurück
Andere Elementtypen hängen vom ausgewählten Modell ab.
Für multimodale Eingaben kann message.content entweder ein einfacher String oder ein Array von Inhaltsblöcken sein. Übergeben Sie bei bildfähigen Modellen Bilder als input_image-Blöcke, anstatt URLs oder Base64-Strings direkt in Klartext einzubetten.
Beispielhafte Inhaltsblöcke:
{ "type": "input_text", "text": "Describe this image" }{ "type": "input_image", "image_url": "https://example.com/image.jpg" }{ "type": "input_image", "image_url": "data:image/png;base64,..." }
Systemanweisungen für das Modell (äquivalent zur System-Message).
Maximale Anzahl der zu generierenden Tokens.
Sampling-Temperatur. Unterstützte Werte und Standardeinstellungen hängen vom ausgewählten Modell ab.
Tools, die das Modell aufrufen darf. Unterstützte Typen und Kombinationen hängen vom ausgewählten Modell ab.
falseWenn true, wird ein Stream von Ereignissen zurückgegeben. Siehe Streaming.
ID einer vorherigen Response, um die Konversation fortzusetzen. Die Response muss zu Ihrem Account gehören und noch gespeichert sein; andernfalls gibt die Anfrage 404 mit dem Code response_not_found zurück. Setzen Sie die Konversation mit dem Modell fort, das sie generiert hat. Wenn der Dienst, der die Response generiert hat, vorübergehend nicht verfügbar ist, kann die Anfrage 503 zurückgeben.
trueGibt an, ob die Response für einen späteren Abruf und für previous_response_id gespeichert werden soll. Bei false speichert TokenLab die Response nicht, und GET /v1/responses/{id} kann sie nicht zurückgeben.
falseFordert eine asynchrone Ausführung an. Die Unterstützung hängt vom ausgewählten Modell ab. Der Erstellungsaufruf gibt sofort ein Ergebnis zurück, normalerweise mit dem status queued oder in_progress. Fragen Sie Response abrufen per Polling ab, bis der status completed, incomplete, failed oder cancelled lautet. Eine Hintergrundanfrage kann 503 zurückgeben, solange die Hintergrundverarbeitung vorübergehend nicht verfügbar ist.
Richtlinie für die Tool-Auswahl, wie z. B. auto, none, required oder ein Objekt, das ein einzelnes Tool benennt. Unterstützte Werte hängen vom ausgewählten Modell ab.
Zusätzliche Ausgabeabschnitte, die zurückgegeben werden sollen, sofern das ausgewählte Modell diese unterstützt.
Streaming-Optionen. include_obfuscation wird weitergeleitet, sofern das ausgewählte Modell dies unterstützt.
Kürzungsstrategie (Truncation) für lange Konversationen, sofern das ausgewählte Modell dies unterstützt.
TokenLab verarbeitet und berechnet Responses-Anfragen im Standard-Service-Tier. auto und default werden akzeptiert. Andere Werte wie flex oder priority werden aus der Anfrage entfernt, und die Anfrage wird zum Standardpreis abgerechnet.
Referenz auf eine wiederverwendbare Prompt-Vorlage und Variablen.
Benutzerdefinierte Metadaten, die mit der Response gespeichert werden.
Einstellungen für die Textausgabe. Die Unterstützung für text.format hängt vom ausgewählten Modell ab.
Gibt an, ob mehrere parallele Tool-Aufrufe erlaubt sind, sofern dies vom ausgewählten Modell unterstützt wird.
Nucleus-Sampling-Parameter (0–1).
Reasoning-Optionen, einschließlich effort, hängen vom ausgewählten Modell ab.
Antwort
Eindeutige Kennung für die Response.
Immer response.
Unix-Zeitstempel der Erstellung der Response.
Status der Response: queued, in_progress, completed, incomplete, failed oder cancelled. Prüfen Sie dieses Feld auch dann, wenn die HTTP-Anfrage erfolgreich ist.
Liste der vom Modell generierten Ausgabeelemente.
Statistiken zur Token-Nutzung.
Zugehörige Endpunkte
GET /v1/responses/{id}ruft eine gespeicherte Response ab.DELETE /v1/responses/{id}löscht eine gespeicherte Response. Die Generierung wird dadurch nicht abgebrochen.POST /v1/responses/compactkomprimiert eine Konversation und gibt einresponse.compaction-Objekt zurück.wss://api.tokenlab.sh/v1/responseserstellt Responses über WebSocket. Siehe Streaming.- Endpunkte für Abbrechen (Cancel), Input-Items und Input-Tokens sind derzeit nicht verfügbar.
Anfrage
curl -X POST "https://api.tokenlab.sh/v1/responses" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-terra",
"input": [
{"type": "message", "role": "user", "content": "Hello!"}
],
"max_output_tokens": 1000
}'from openai import OpenAI
client = OpenAI(
api_key="sk-your-api-key",
base_url="https://api.tokenlab.sh/v1"
)
response = client.responses.create(
model="gpt-5.6-terra",
input=[
{"type": "message", "role": "user", "content": "Hello!"}
],
max_output_tokens=1000
)
print(response.output)import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'sk-your-api-key',
baseURL: 'https://api.tokenlab.sh/v1'
});
const response = await client.responses.create({
model: 'gpt-5.6-terra',
input: [
{ type: 'message', role: 'user', content: 'Hello!' }
],
max_output_tokens: 1000
});
console.log(response.output);package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
)
func main() {
payload := map[string]interface{}{
"model": "gpt-5.6-terra",
"input": []map[string]interface{}{
{"type": "message", "role": "user", "content": "Hello!"},
},
"max_output_tokens": 1000,
}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://api.tokenlab.sh/v1/responses", bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer sk-your-api-key")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
fmt.Println(result["output"])
}<?php
$ch = curl_init('https://api.tokenlab.sh/v1/responses');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'Authorization: Bearer sk-your-api-key'
],
CURLOPT_POSTFIELDS => json_encode([
'model' => 'gpt-5.6-terra',
'input' => [
['type' => 'message', 'role' => 'user', 'content' => 'Hello!']
],
'max_output_tokens' => 1000
])
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data['output']);Beispiel für Vision-Eingaben
Verwenden Sie bildfähige Modelle, indem Sie Bilder innerhalb von message.content als input_image-Blöcke einfügen. Der Wert von image_url kann entweder eine öffentliche URL oder eine Base64-Daten-URL sein.
{
"model": "gpt-5.6-terra",
"input": [
{
"type": "message",
"role": "user",
"content": [
{
"type": "input_text",
"text": "Please describe this image."
},
{
"type": "input_image",
"image_url": "https://example.com/demo.jpg"
}
]
}
]
}{
"model": "gpt-5.6-terra",
"input": [
{
"type": "message",
"role": "user",
"content": [
{
"type": "input_text",
"text": "Please describe this image."
},
{
"type": "input_image",
"image_url": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ..."
}
]
}
]
}Antwort
{
"id": "resp_abc123",
"object": "response",
"created_at": 1706000000,
"status": "completed",
"model": "gpt-5.6-terra",
"output": [
{
"id": "msg_abc123",
"type": "message",
"status": "completed",
"role": "assistant",
"content": [
{"type": "output_text", "text": "Hello! How can I help you today?", "annotations": []}
]
}
],
"usage": {
"input_tokens": 10,
"output_tokens": 12,
"total_tokens": 22
}
}Fehler
Fehler verwenden das error-Objekt im OpenAI-Stil. Häufige Fälle: 400 für ein ungültiges Feld oder ein Modell ohne das Responses-Format, 401 für einen ungültigen Key, 402 für unzureichendes Guthaben, 404 für eine unbekannte previous_response_id, 429 bei Überschreitung des Rate-Limits und 503, wenn das Modell die Anfrage derzeit nicht verarbeiten kann. Siehe API-Fehler behandeln.
Autorisierung
BearerAuth API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.
Ort: header
Header
Zustellungsrichtlinie pro Anfrage. Überschreibt die API-Key- und Workspace-Standardeinstellungen. Versucht automatisch zuerst TokenLab Verified und kann vor der Ausgabe, der Annahme der Anfrage oder der Erstellung persistenter Ressourcen einmalig auf Official umstellen.
Zulässige Werte
- "auto"
- "verified"
- "official"
Optionaler Schlüssel, der einen zweiten Durchlauf derselben Anfrage verhindert. Senden Sie für jede Anfrage einen neuen eindeutigen Wert, wie z. B. eine UUID, und behalten Sie diesen für Wiederholungsversuche nach einem Timeout bei. Ein Wiederholungsversuch mit demselben Schlüssel wird nicht erneut ausgeführt: Er gibt 409 mit idempotency_replay_unavailable zurück, oder normalerweise idempotency_conflict, wenn sich der Body geändert hat. Ausnahme: Wenn ein Nicht-Stream-Ergebnis nach dem Verbindungsabbruch des Clients abgeschlossen wurde, gibt ein Wiederholungsversuch mit demselben Schlüssel und Body innerhalb von 24 Stunden dieses Ergebnis (bis zu 1 MB) mit dem Header Idempotent-Replayed: true und ohne erneute Berechnung zurück. Ein Schlüssel, der länger als 255 Zeichen ist, wird ignoriert, und die Anfrage hat dann keinen Idempotenz-Schutz. Mit background: true gibt ein Wiederholungsversuch mit demselben Schlüssel und Body stattdessen das ursprüngliche Antwortobjekt zurück und erstellt oder berechnet keine zweite Antwort; ein abweichender Body wird abgelehnt, und sein Statuscode ist nicht garantiert. Siehe Sicheres Wiederholen mit einem Idempotenz-Schlüssel.
1 <= length <= 255Anfragekörper
application/json
Antwort
application/json
application/json
application/json
application/json
application/json