Skip to main content
POST
Batch erstellen
Erfordert Zugriff auf die Vorschau im Arbeitsbereich. Informationen zu Einrichtung, Webhooks und Ergebnisverarbeitung findest du unter Video- und Stapelaufträge.

Autorisierungen

Authorization
string
header
erforderlich

Authentifizierung mit Bearer-Token

Body

application/json
provider_options
object

Erweiterungen nach kanonischer Anbieter-ID. OpenAI akzeptiert output_expires_after; Mistral akzeptiert metadata. Nur Optionen des gewählten Anbieters werden angewandt. Optionen nicht auf oberster Ebene duplizieren. Optionen dürfen bepreiste Zeilen, Modelle oder Dateien nicht überschreiben.

model
string

Modell-ID zum Ableiten des Batch-Anbieters. Anfragezeilen können auch body.model enthalten; das Modell auf oberster Ebene wird bevorzugt.

prompts
string[]

Kurzform für einfache Prompts. Phaseo wandelt jeden Prompt in eine anbietereigene Batch-Zeile für das gewählte Modell um.

items
object[]

Kurzform für strukturierte Prompts. Einträge können id, custom_id, prompt, messages, input, system, max_tokens, temperature oder einen erweiterten body enthalten.

system
string

Optionale Systemanweisung für Prompt-Kurzformzeilen.

max_tokens
integer

Optionales maximales Tokenlimit für Prompt-Kurzformzeilen.

temperature
number

Optionale Sampling-Temperatur für Prompt-Kurzformzeilen.

input_file_id
string

Vorhandene Anbieter-Datei-ID zur Batch-Erstellung per Datei-Upload.

requests
object[]

Erweiterte Batch-Anfragezeilen. Genau eines von prompts, items, requests oder input_file_id angeben.

endpoint
enum<string>

Anfrageformat für den Aufrufer. Jede Anfrage eines Batches verwendet diesen Endpunkt. Ohne Angabe wählt Phaseo anhand des Modells einen anbietereigenen Standard.

Verfügbare Optionen:
/v1/chat/completions,
/v1/responses,
/v1/messages,
/v1/embeddings,
/v1/generateContent
completion_window
string
metadata
object
session_id
string

Eindeutige Kennung, um zusammengehörige Anfragen (zum Beispiel eine Unterhaltung oder einen Agenten-Workflow) für die Beobachtbarkeit zu gruppieren.

Maximum string length: 256
webhook
object
webhook_endpoint_id
string

Praktischer Alias für webhook.endpoint_id.

debug
object

Gateway-Debug-Steuerungen. Diese Flags werden niemals an den Anbieter weitergeleitet.

provider
object

Erweiterte Routing-Einschränkung. Die meisten Anfragen sollten die modellbasierte Anbieterableitung nutzen.

Antwort

Batch-Statusantwort

id
string
native_batch_id
string | null

Anbietereigene Batch-ID, wenn sie von der Gateway-ID abweicht.

object
string
endpoint
string
errors
object
input_file_id
string
completion_window
string
status
string
lifecycle_status
enum<string>

Normalisierter asynchroner Lebenszyklusstatus für Polling-, WebSocket- und Webhook-Empfänger.

Verfügbare Optionen:
pending,
running,
completed,
failed,
cancelled,
expired
progress
integer

Grober Batch-Abschlussprozentsatz aus den Anfragezahlen des Anbieters, sofern verfügbar. Abgeschlossene Batches melden 100.

Erforderlicher Bereich: 0 <= x <= 100
polling_url
string<uri>
websocket_url
string<uri>

WebSocket-URL zum Abonnieren normalisierter Lebenszyklusaktualisierungen asynchroner Aufträge.

cancel_url
string<uri> | null

Für Kompatibilität reserviert; derzeit immer null.

results_url
string<uri> | null

Authentifizierte Phaseo-JSONL-Download-URL für unterstützte Batches im Endstatus. Während der Verarbeitung null. Ein finaler Batch kann ohne Ausgabe sein. API-Schlüssel des besitzenden Workspaces verwenden; Aufbewahrungsfristen des Anbieters gelten.

output_file_id
string
error_file_id
string
created_at
integer
in_progress_at
integer
expires_at
integer
finalizing_at
integer
completed_at
integer
failed_at
integer
expired_at
integer
cancelling_at
integer
cancelled_at
integer
request_counts
object
metadata
object
request_id
string
provider
string
session_id
string
webhook
object

Bereinigte asynchrone Webhook-Konfiguration und Zustellstatus. Geheimnisse werden nie zurückgegeben; has_secret zeigt an, ob signierte Zustellungen aktiviert sind. Signierte Zustellungen enthalten die Header x-phaseo-signature, x-phaseo-timestamp, x-phaseo-event-id, x-phaseo-event-type, x-phaseo-delivery-key, x-phaseo-attempt und x-phaseo-max-attempts.

next_webhook_retry_at
string | null
last_webhook_progress
number | null
last_webhook_progress_at
string | null
last_webhook_dispatched_at
string | null
finalized_at
string | null
pricing_lines
object[]
usage
object

Normalisierte Gesamtnutzung und Gesamtkosten nach Abschluss.

billing
object
Zuletzt geändert am 2. Oktober 2026