Points de terminaison/Media

Obtenir une tâche média

Récupérez le statut et le résultat d'une tâche média asynchrone par son identifiant. Interrogez ce point de terminaison jusqu'à ce que le statut soit succeeded ou failed.

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

#Authentification

Toutes les requêtes transportent votre clé dans l'en-tête Authorization.

http

Authorization: Bearer sk-corr-...

#Paramètres de chemin

Paramètre	Type	Obligatoire	Description
`id`	string	Oui	L'identifiant de tâche renvoyé par le point de terminaison de création de tâche.

#Exemple de requête

bash

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

#Réponse

Renvoie l'objet tâche. Champs courants :

Champ	Type	Description
`id`	string	Obtenir une tâche média id
`status`	string	Statut de la tâche : queued / submitted / succeeded / failed / timeout.
`type`	string	Type de média : image / video / music.
`model`	string	Le modèle que vous avez demandé.
`result.urls`	string[]	Présent en cas de succès. result.urls est un tableau d'URL de fichiers permanentes.
`error`	string	Message d'erreur, présent lorsque la tâche a échoué.
`cost`	string	Montant facturé pour cette tâche — une chaîne en USD (ex. "0.1200"). Voir le champ currency.

Exemples de réponse

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

#Valeurs de statut

status	Description
`queued`	En file d'attente, en attente de démarrage.
`running`	Génération en cours chez le fournisseur amont.
`succeeded`	Terminé — result.urls est disponible.
`failed`	Échec — voir error. La réservation est automatiquement remboursée.

succeeded

Présent en cas de succès. result.urls est un tableau d'URL de fichiers permanentes.

#Codes d'erreur

Statut	Signification
`401`	Clé invalide ou manquante
`404`	Le modèle demandé n'existe pas ou n'est pas disponible

json

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