Endpoints/Media

Mediataak ophalen

Haal de status en het resultaat van een asynchrone mediataak op via de id. Vraag dit endpoint op totdat de status succeeded of failed is.

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

#Authenticatie

Alle aanvragen dragen je sleutel in de Authorization-header.

http

Authorization: Bearer sk-corr-...

Parameter	Type	Verplicht	Beschrijving
`id`	string	Ja	De taak-id die door het endpoint voor taakcreatie is teruggegeven.

bash

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

Geeft het taakobject terug. Veelvoorkomende velden:

Veld	Type	Beschrijving
`id`	string	Mediataak ophalen id
`status`	string	Taakstatus: queued / submitted / succeeded / failed / timeout.
`type`	string	Mediatype: image / video / music.
`model`	string	Het model dat je hebt aangevraagd.
`result.urls`	string[]	Aanwezig bij succes. result.urls is een array van permanente bestands-URL's.
`error`	string	Foutmelding, aanwezig wanneer de taak is mislukt.
`cost`	string	Voor deze taak in rekening gebracht bedrag — een USD-string (bijv. "0.1200"). Zie het currency-veld.

Antwoordvoorbeelden

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

status	Beschrijving
`queued`	In wachtrij, wacht op start.
`running`	Genereren bij de upstream-provider.
`succeeded`	Klaar — result.urls is beschikbaar.
`failed`	Mislukt — zie error. De reservering wordt automatisch terugbetaald.

Aanwezig bij succes. result.urls is een array van permanente bestands-URL's.

Status	Betekenis
`401`	Ongeldige of ontbrekende sleutel
`404`	Het gevraagde model bestaat niet of is niet beschikbaar

json

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