Api.Airforce
API REFERENCE

Modeller

Yetenek bayrakları, bağlam sınırları ve belirteç başına fiyatlandırmayla birlikte API anahtarınızda bulunan her modeli listeleyin.

API'nin geri kalanının bağlı olduğu her şey tek bir çağrıyla keşfedilebilir: hangi modellerin görselleri, tool'ları, akıl yürütmeyi veya caching'i kabul ettiği, context window'ları ve token başına fiyatları. Uygulamanızda model listelerini sabit kodlamak yerine models endpoint'ini sorgulayın ve aşağıdaki yetenek bayraklarına göre filtreleyin.

created alanının, model başına bir yayın tarihi değil, listelemenin güncel sunucu zamanı olduğunu ve status alanının canlı sağlığı yansıttığını unutmayın — uzun süre cache'lemek yerine yeniden çekin.

GET /v1/models

Şu anda kullanabileceğiniz modellerin listesini döndürür. Kimliği doğrulanmış istekler, kontrol panelinde etkinleştirdiğiniz kullanıcı başına modelleri içerir. Şekil OpenAI'ninkini yansıtıyor GET /v1/models Ekstra Airforce yetenek alanları ile.

GEThttps://api.airforce/v1/models

Örnek

curl https://api.airforce/v1/models \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY"

Tepki şekli

Üst düzey zarf { object: "list", data: Model[] }. Her biri Model aşağıdaki alanları içerir; isteğe bağlı olarak işaretlenen alanlar, bilinmediğinde atlanabilir.

ParameterTypeRequiredDescription
idstringOptionalPublic model identifier you pass as the "model" field on every other endpoint, e.g. "claude-sonnet-4.6" or "gpt-5.1-chat".
objectstringOptionalAlways "model".
createdintegerOptionalUnix timestamp at which this listing was generated (current server time) — not a stable per-model creation date.
owned_bystringOptionalVendor name: "openai", "anthropic", "google", "deepseek", …
catalog_idstringOptionalCanonical vendor identifier for the underlying model family (e.g. "anthropic/claude-sonnet-4-6"). Stable across Airforce ID changes.
context_lengthintegerOptionalTotal context window in tokens (input + output).
max_output_tokensintegerOptionalHard cap on a single response. Use this as the upper bound when picking max_tokens.
input_modalitiesarrayOptionalSubset of ["text", "image", "audio", "document", "video"] the model accepts as input.
output_modalitiesarrayOptionalSubset of ["text", "image", "audio", "video"] the model can produce.
supports_chatbooleanOptionalAvailable on /v1/chat/completions and /v1/messages.
supports_streamingbooleanOptionalHonors stream: true.
supports_visionbooleanOptionalAccepts image_url content blocks.
supports_toolsbooleanOptionalAccepts the tools / tool_choice parameters.
supports_reasoningbooleanOptionalHonors reasoning_effort / thinking / thinking_budget.
supports_documentsbooleanOptionalAccepts document content blocks (PDF, etc.).
supports_cachingbooleanOptionalHonors cache_control on Anthropic-style system prompts.
supports_audio_inputbooleanOptionalAccepts audio content blocks (multimodal STT-in-chat).
supports_video_inputbooleanOptionalAccepts video content blocks.
knowledge_cutoffstringOptionalVendor-published knowledge cutoff month, e.g. "2025-09".
statusstringOptionalLive health: "operational" | "degraded" | "partial_outage" | "major_outage" (legacy "stable" / "down" / "offline" may also appear).
pricepermilliontokensintegerOptionalInput cost in cents per 1M tokens. Output side has output_pricepermilliontokens.
cache_read_pricepermilliontokensintegerOptionalDiscounted rate for cache-hit input tokens (Anthropic-style caching).

Örnek yanıt

{
  "object": "list",
  "data": [
    {
      "id": "claude-sonnet-4.6",
      "object": "model",
      "created": 1740000000,
      "owned_by": "anthropic",
      "catalog_id": "anthropic/claude-sonnet-4-6",
      "context_length": 200000,
      "max_output_tokens": 64000,
      "input_modalities": ["text", "image", "document"],
      "output_modalities": ["text"],
      "supports_chat": true,
      "supports_streaming": true,
      "supports_vision": true,
      "supports_tools": true,
      "supports_reasoning": true,
      "supports_documents": true,
      "supports_caching": true,
      "knowledge_cutoff": "2025-08",
      "status": "operational",
      "pricepermilliontokens": 300,
      "output_pricepermilliontokens": 1500,
      "cache_read_pricepermilliontokens": 30
    }
    // … more models
  ]
}

Yeteneğe göre filtreleme

Yetenek filtreleme, aşağıdaki bayraklarla istemci tarafında yapılır. En yaygın filtreler:

const res = await fetch('https://api.airforce/v1/models', {
  headers: { Authorization: `Bearer ${API_KEY}` },
});
const { data } = await res.json();

// Vision-capable chat models
const visionModels = data.filter(m => m.supports_chat && m.supports_vision);

// Cheapest reasoning model with at least 100k context
const reasoning = data
  .filter(m => m.supports_reasoning && (m.context_length ?? 0) >= 100_000)
  .sort((a, b) => (a.pricepermilliontokens ?? 0) - (b.pricepermilliontokens ?? 0))[0];

// All models from one vendor, by canonical catalog family
const allClaude = data.filter(m => m.catalog_id?.startsWith('anthropic/'));

İsteğe bağlı bir sunucu tarafı sorgu parametresi vardır: GET /v1/models?channels=1 ek olarak kanal başına alias girdileri döndürür (routing'in farkında olan istemciler için); bu parametre olmadan o alias'lar dahil edilmez.


Fiyatlandırma alanları

Tüm *pricepermilliontokens alanlar 1.000.000 jeton başına tam sayı sentlerdir. Milyon ABD doları için 100'e bölün.

ParameterTypeRequiredDescription
pricepermilliontokensintegerOptionalInput tokens, cents per 1M.
output_pricepermilliontokensintegerOptionalOutput tokens, cents per 1M.
cache_write_5m_pricepermilliontokensintegerOptionalCache-write rate for 5-minute TTL caches (Anthropic).
cache_write_1h_pricepermilliontokensintegerOptionalCache-write rate for 1-hour TTL caches (Anthropic).
cache_read_pricepermilliontokensintegerOptionalCache-read rate (typically 10× cheaper than uncached input).

Model durumu ve kullanımdan kaldırılması

ParameterTypeRequiredDescription
operationalstatusOptionalHealthy — recent calls are succeeding. The usual value for an available model.
degradedstatusOptionalCallable, but with elevated errors or latency.
partial_outagestatusOptionalA subset of upstream channels is failing.
major_outagestatusOptionalMost or all calls are currently failing.
stable / down / offlinestatusOptionalLegacy or admin-set values that may also appear.

Tamamen devre dışı bırakılan modeller bir durum değeri değildir — /v1/models'ten tamamen hariç tutulurlar (yöneticiler dahil her çağıran için) ve yalnızca admin araçları aracılığıyla tam adlarıyla çağrılırlar.

Göz atılabilir bir görünüm ister misiniz?

The /modeller sayfası aynı verileri gruplama, arama ve fiyatlandırma karşılaştırmalarıyla işler.