Text & Chat

Response erstellen

Erstellt eine Response im Format der OpenAI Responses API

POST
/v1/responses

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

modelstringerforderlich

ID des zu verwendenden Modells. Siehe Modelle für verfügbare Optionen.

inputstring | array

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 Inhalt
  • function_call: Eine Funktionsaufruf-Anforderung
  • function_call_output: Ausgabe eines Funktionsaufrufs
  • reasoning: 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,..." }
instructionsstring

Systemanweisungen für das Modell (äquivalent zur System-Message).

max_output_tokensinteger

Maximale Anzahl der zu generierenden Tokens.

temperaturenumber

Sampling-Temperatur. Unterstützte Werte und Standardeinstellungen hängen vom ausgewählten Modell ab.

toolsarray

Tools, die das Modell aufrufen darf. Unterstützte Typen und Kombinationen hängen vom ausgewählten Modell ab.

streambooleanStandard: false

Wenn true, wird ein Stream von Ereignissen zurückgegeben. Siehe Streaming.

previous_response_idstring

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.

storebooleanStandard: true

Gibt 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.

backgroundbooleanStandard: false

Fordert 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.

tool_choicestring | object

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.

includearray

Zusätzliche Ausgabeabschnitte, die zurückgegeben werden sollen, sofern das ausgewählte Modell diese unterstützt.

stream_optionsobject

Streaming-Optionen. include_obfuscation wird weitergeleitet, sofern das ausgewählte Modell dies unterstützt.

truncationstring

Kürzungsstrategie (Truncation) für lange Konversationen, sofern das ausgewählte Modell dies unterstützt.

service_tierstring

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.

promptobject

Referenz auf eine wiederverwendbare Prompt-Vorlage und Variablen.

metadataobject

Benutzerdefinierte Metadaten, die mit der Response gespeichert werden.

textobject

Einstellungen für die Textausgabe. Die Unterstützung für text.format hängt vom ausgewählten Modell ab.

parallel_tool_callsboolean

Gibt an, ob mehrere parallele Tool-Aufrufe erlaubt sind, sofern dies vom ausgewählten Modell unterstützt wird.

top_pnumber

Nucleus-Sampling-Parameter (0–1).

reasoningobject

Reasoning-Optionen, einschließlich effort, hängen vom ausgewählten Modell ab.

Antwort

idstring

Eindeutige Kennung für die Response.

objectstring

Immer response.

created_atinteger

Unix-Zeitstempel der Erstellung der Response.

statusstring

Status der Response: queued, in_progress, completed, incomplete, failed oder cancelled. Prüfen Sie dieses Feld auch dann, wenn die HTTP-Anfrage erfolgreich ist.

outputarray

Liste der vom Modell generierten Ausgabeelemente.

usageobject

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/compact komprimiert eine Konversation und gibt ein response.compaction-Objekt zurück.
  • wss://api.tokenlab.sh/v1/responses erstellt Responses über WebSocket. Siehe Streaming.
  • Endpunkte für Abbrechen (Cancel), Input-Items und Input-Tokens sind derzeit nicht verfügbar.

Anfrage

cURL
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
  }'
Python
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)
JavaScript
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);
Go
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
<?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

Response
{
  "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
AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Header

X-TokenLab-Delivery-Policy?string

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"
Idempotency-Key?string

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.

Länge1 <= length <= 255

Anfragekörper

application/json

Antwort

application/json

application/json

application/json

application/json

application/json