---
title: "Get Settings"
method: GET
path: "/settings"
tags: ["accepts-api-key"]
---

# Get Settings

`GET /settings`

## Request

- Base URL: `https://api.tellers.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tellers.ai/settings`
- Auth: none declared

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Response `200`

Successful Response

- AppSettings
  - `maintenance_mode` boolean, required
  - `cost_wan_ai_hd_generation` number, required
  - `cost_wan_ai_sd_generation` number, required
  - `social_publishing_platforms` SocialPublishingPlatformSetting[], required
    - `id` string, required
    - `label` string, required
    - `supported_media_types` string[], required
  - `project_aspect_ratios` AspectRatio[], required
  - `available_agent_tools` object[], required
  - `available_llm_models` AvailableModel[], required
    - `name` string, required
    - `codename` string, required
    - `compatible_models` string[], required
    - `options` TellersAvailableOptions, required
      - `verbosity` string[], required
      - `reasoning_effort` string[], required
      - `compaction` boolean
      - `compaction_threshold` integer, nullable
    - `available_priorities` string[], required
    - `pricing_level` 1 | 2 | 3 | 4 | 5, required
    - `required_subscription_tier` 'basic' | 'pro' | 'expert' | 'enterprise_user': Named subscription offer; subscriptions that predate tiers read as basic. ``enterprise_user`` is granted by hand outside Stripe (see :mod:`tellers_common.enterprise_user_subscription`) and ranks above every paid tier.
    - `subscription_locked` boolean: True when the caller's plan is below `required_subscription_tier`: show the model as an upgrade, a request with it is refused (402).
    - `priority_required_subscription_tiers` object: Lowest subscription tier for each of `available_priorities` that needs one (e.g. `ultra`); priorities not listed are open to all.
    - `locked_priorities` string[]: Entries of `available_priorities` the caller's plan cannot use: show them as an upgrade, a request with one is refused (402).
  - `llm_model_tiers` LlmModelTier, required
    - `low` 'gpt-6-astra' | 'gpt-6.1-sol' | 'gpt-6.1-terra' | 'gpt-6-sol' | 'gpt-6-luna' | 'gpt-5.6-sol' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | 'gpt-5.5-2026-04-23' | 'gpt-5.5-pro-2026-04-23' | 'gpt-5.4-pro-2026-03-05' | 'gpt-5.4' | 'gpt-5.4-mini' | 'gpt-5.3-codex' | 'gpt-5.2-2025-12-11' | 'gpt-5-mini-2025-08-07' | 'gpt-5-nano', nullable
    - `medium` 'gpt-6-astra' | 'gpt-6.1-sol' | 'gpt-6.1-terra' | 'gpt-6-sol' | 'gpt-6-luna' | 'gpt-5.6-sol' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | 'gpt-5.5-2026-04-23' | 'gpt-5.5-pro-2026-04-23' | 'gpt-5.4-pro-2026-03-05' | 'gpt-5.4' | 'gpt-5.4-mini' | 'gpt-5.3-codex' | 'gpt-5.2-2025-12-11' | 'gpt-5-mini-2025-08-07' | 'gpt-5-nano', nullable
    - `high` 'gpt-6-astra' | 'gpt-6.1-sol' | 'gpt-6.1-terra' | 'gpt-6-sol' | 'gpt-6-luna' | 'gpt-5.6-sol' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | 'gpt-5.5-2026-04-23' | 'gpt-5.5-pro-2026-04-23' | 'gpt-5.4-pro-2026-03-05' | 'gpt-5.4' | 'gpt-5.4-mini' | 'gpt-5.3-codex' | 'gpt-5.2-2025-12-11' | 'gpt-5-mini-2025-08-07' | 'gpt-5-nano', nullable
  - `presets` TellersPreset[], required
    - `name` string, required
    - `model` 'gpt-6-astra' | 'gpt-6.1-sol' | 'gpt-6.1-terra' | 'gpt-6-sol' | 'gpt-6-luna' | 'gpt-5.6-sol' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | 'gpt-5.5-2026-04-23' | 'gpt-5.5-pro-2026-04-23' | 'gpt-5.4-pro-2026-03-05' | 'gpt-5.4' | 'gpt-5.4-mini' | 'gpt-5.3-codex' | 'gpt-5.2-2025-12-11' | 'gpt-5-mini-2025-08-07' | 'gpt-5-nano', nullable, required
    - `options` TellersPresetOptions, required
      - `reasoning_effort` 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max', nullable, required
      - `verbosity` 'low' | 'medium' | 'high', nullable, required
      - `priority` 'low' | 'default' | 'high' | 'ultra', nullable, required
    - `required_subscription_tier` 'basic' | 'pro' | 'expert' | 'enterprise_user': Named subscription offer; subscriptions that predate tiers read as basic. ``enterprise_user`` is granted by hand outside Stripe (see :mod:`tellers_common.enterprise_user_subscription`) and ranks above every paid tier.
    - `subscription_locked` boolean: True when the caller's plan is below `required_subscription_tier`: show the preset as an upgrade, a request with it is refused (402).
  - `default_preset` string, required: Name of the preset in `presets` that a request with no LLM settings runs under. Seed a fresh chat from this preset rather than hard-coding a copy of its values: a copy is what drifts off the default when the preset changes.
  - `parallel_tool_calls` boolean, required
  - `disabled_effects` string[], required: Timeline effects the user may not pick, as the agent may not add them: an effect name (`Stabilize`) or one parameter of one (`Transform.follow`). Leave them out of the effect pickers; one already on a clip or track still shows and can be configured, disabled or deleted.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tellers/apis/tellers-api.md) - [All operations](https://skmtc.dev/tellers/apis/tellers-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tellers/apis/tellers-api/revisions/fdaa0fa44a26?raw)