GET `/v1/ai/providers`

Which AI vendors are available, and whether this organization can use each.

Autenticazione

Invia una chiave API come token di tipo bearer. La chiave deve disporre dell'autorizzazione links.view; una chiave sprovvista di tale autorizzazione viene rifiutata con 403 anziché 404.

L'ID della tua organizzazione va qui

Questo endpoint accetta org_id come parametro di query. Omettilo e la chiamata coprirà l'intero sottoalbero del tuo tenant; invialo per limitare la chiamata a una singola organizzazione.

L'identificativo della tua organizzazione si trova nella schermata delle chiavi API nella tua dashboard, accanto alla chiave stessa. È lo stesso identificativo in ogni chiamata che effettui.

Provalo

Sostituisci qualsiasi elemento tra parentesi angolari con i tuoi valori e il segnaposto key con una chiave dalla tua dashboard.

curl -X GET https://api.zinndigital.com/v1/ai/providers \
  -H "Authorization: Bearer zdk_live_…"

Hai effettuato l'accesso? La console API nella tua dashboard inserisce il tuo ID organizzazione reale e la tua chiave personale, ed esegue la richiesta sull'API live in modo da poter vedere la risposta effettiva. Apri questo endpoint nella console API

Dettagli

⚖️ The owner's *"it should first only be available if they have ai keys set and tell them which ones"* as data. Each entry says whether **our credits** cover that vendor, what state **this org's** key for it is in, and how many of its models we have proven against our own prompts. ⚖️ Note the funding order the owner settled on 2026-08-20: credit packs are the **default** route and BYO keys the alternative, so a provider with `covered_by_credits: true` is usable with no key at all. Requires `links.view`.

Parametri

Nome	Tipo	Obbligatorio	Che cos'è
`org_id (query)`	`Uuid`	No	—

Risposta

Nome	Tipo	Obbligatorio	Che cos'è
`data`	`AiProviderOption[]`	Sì	—

Errori che questo endpoint può restituire

401 · 403 · 429