Endpoint/Media

Ottieni attività multimediale

Recupera stato e risultato di un'attività multimediale asincrona tramite il suo id. Interroga questo endpoint finché lo stato non è succeeded o failed.

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

#Autenticazione

Tutte le richieste portano la tua chiave nell'header Authorization.

http

Authorization: Bearer sk-corr-...

#Parametri di percorso

Parametro	Tipo	Obbligatorio	Descrizione
`id`	string	Sì	L'id attività restituito dall'endpoint di creazione attività.

#Esempio di richiesta

bash

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

#Risposta

Restituisce l'oggetto attività. Campi comuni:

Campo	Tipo	Descrizione
`id`	string	Ottieni attività multimediale id
`status`	string	Stato dell'attività: queued / submitted / succeeded / failed / timeout.
`type`	string	Tipo di media: image / video / music.
`model`	string	Il modello che hai richiesto.
`result.urls`	string[]	Presente in caso di successo. result.urls è un array di URL di file permanenti.
`error`	string	Messaggio di errore, presente quando l'attività non è riuscita.
`cost`	string	Importo addebitato per questa attività — una stringa in USD (es. "0.1200"). Vedi il campo currency.

Esempi di risposta

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

#Valori di stato

status	Descrizione
`queued`	In coda, in attesa di avvio.
`running`	Generazione in corso presso il provider upstream.
`succeeded`	Completato — result.urls è disponibile.
`failed`	Non riuscito — vedi error. La prenotazione viene rimborsata automaticamente.

succeeded

Presente in caso di successo. result.urls è un array di URL di file permanenti.

#Codici di errore

Stato	Significato
`401`	Chiave non valida o mancante
`404`	Il modello richiesto non esiste o non è disponibile

json

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