ai

GET /v1/ai/images/providers

Which image providers this organisation can actually generate with.

Всички крайни точки в ai

Всички документи за разработчици

Упълномощаване

Изпратете API ключ като токен за носене. Ключът трябва да притежава разрешението sites.view; ключ без него се отхвърля с 403, а не с 404.

Където отива идентификаторът на вашата организация

Този ендпойнт приема org_id като параметър на заявката. Оставете го празен и извикването ще обхване цялото ви поддървано дърво; изпратете го, за да ограничите извикването до една организация.

ИД на вашата организация се намира на екрана с API ключове във вашето табло за управление, до самия ключ. Това е същият ИД във всяко заявка, която правите.

Опитайте

Заменете всичко в квадратни скоби със собствени стойности, а ключовия заместващ символ – с ключ от вашето табло за управление.

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

Влязохте ли в профила си? API конзолата във вашето табло за управление попълва действителното идентификационно число на вашата организация и вашия собствен ключ и изпълнява заявката спрямо реалното API, за да можете да видите действителния отговор. Отворете този крайpoint в API конзолата

Детайли

Whether each provider can draw right now, for this org, and a machine-readable reason when it cannot. Requires sites.view. ⚖️ Owner ruling 2026-08-20 — "declare capabilities; warn BEFORE they pick". That was built for a model's capabilities and never for the provider itself, which is the coarser and far more expensive version of the same question. Measured on production 2026-08-21: the live picker offered OpenAI and xAI Grok as ordinary enabled choices and both answered 422 on every request, because the estate holds a key for neither and no customer key could promote a model on its own. ⛔ reason is a code, never a sentence — no_key, no_model, key_broken, or empty when usable. Every string a customer reads is translated into 57 languages (§2.19), so a message assembled in the engine is an English message on a German screen. ⛔ usable and key_broken are independent. With platform credits behind it, a provider whose customer key has failed its last check is still usable — and the customer still needs telling, which is why both fields travel.

Параметри

ИмеТипЗадължителноКакво представлява
org_id (query)UuidНе

Отговор

ИмеТипЗадължителноКакво представлява
dataAiImageProviderAvailability[]Да

Грешки, които този крайpoint може да върне

401 · 403 · 422 · 429