Endpunkte/Media

Medienaufgabe abrufen

Rufen Sie Status und Ergebnis einer asynchronen Medienaufgabe anhand ihrer ID ab. Fragen Sie diesen Endpunkt ab, bis der Status succeeded oder failed ist.

GEThttps://api.foxwire.ai/v1/media/generations/{id}

#Authentifizierung

Alle Anfragen tragen Ihren Schlüssel im Authorization-Header.

http

Authorization: Bearer sk-corr-...

#Pfadparameter

Parameter	Typ	Erforderlich	Beschreibung
`id`	string	Ja	Die vom Endpunkt zur Aufgabenerstellung zurückgegebene Task-ID.

#Anfragebeispiel

bash

curl https://api.foxwire.ai/v1/media/generations/task_abc123 \
  -H "Authorization: Bearer $CORRY_KEY"

#Antwort

Gibt das Task-Objekt zurück. Gängige Felder:

Feld	Typ	Beschreibung
`id`	string	Medienaufgabe abrufen id
`status`	string	Aufgabenstatus: queued / submitted / succeeded / failed / timeout.
`type`	string	Medientyp: image / video / music.
`model`	string	Das von Ihnen angeforderte Modell.
`result.urls`	string[]	Bei Erfolg vorhanden. result.urls ist ein Array permanenter Datei-URLs.
`error`	string	Fehlermeldung, vorhanden wenn die Aufgabe fehlgeschlagen ist.
`cost`	string	Für diese Aufgabe berechneter Betrag — ein USD-String (z. B. "0.1200"). Siehe das currency-Feld.

Antwortbeispiele

{
  "id": "task_abc123",
  "status": "running",
  "type": "image",
  "model": "gpt-image-2"
}

#Statuswerte

status	Beschreibung
`queued`	In Warteschlange, wartet auf Start.
`running`	Wird beim Upstream-Anbieter generiert.
`succeeded`	Fertig — result.urls ist verfügbar.
`failed`	Fehlgeschlagen — siehe error. Die Reservierung wird automatisch erstattet.

succeeded

Bei Erfolg vorhanden. result.urls ist ein Array permanenter Datei-URLs.

#Fehlercodes

Status	Bedeutung
`401`	Ungültiger oder fehlender Schlüssel
`404`	Das angeforderte Modell existiert nicht oder ist nicht verfügbar

json

{
  "error": {
    "message": "Task not found",
    "type": "not_found"
  }
}