Api.Airforce
API REFERENCE

نماذج

قم بإدراج كل نموذج متاح على مفتاح API الخاص بك، مع استكماله بعلامات القدرة وحدود السياق والتسعير لكل رمز مميز.

كل ما يعتمد عليه باقي الـ API قابل للاكتشاف من استدعاء واحد: أي الموديلات تقبل الصور أو الـ tools أو الـ reasoning أو الـ caching، ونافذة السياق الخاصة بها، وسعرها لكل token. استعلم من الـ models endpoint وصفِّ على رايات القدرات أدناه بدلاً من تثبيت قوائم الموديلات في تطبيقك.

لاحظ أن الحقل created هو وقت الخادم الحالي للقائمة، وليس تاريخ إصدار خاصاً بكل موديل، وأن الحقل status يعكس الحالة الحية — أعد جلبه بدلاً من تخزينه مؤقتاً لمدة طويلة.

GET /v1/models

إرجاع قائمة النماذج التي يمكنك استخدامها الآن. تتضمن الطلبات التي تمت مصادقتها أي نماذج لكل مستخدم قمت بتمكينها في لوحة المعلومات. يعكس الشكل OpenAI GET /v1/models مع حقول قدرة Airforce إضافية.

GEThttps://api.airforce/v1/models

مثال

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

شكل الرد

المغلف المستوى الأعلى هو { object: "list", data: Model[] }. كل Model يحتوي على الحقول أدناه - قد يتم حذف الحقول التي تم وضع علامة عليها كاختيارية عندما تكون غير معروفة.

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).

رد المثال

{
  "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
  ]
}

التصفية حسب القدرة

تتم تصفية القدرات من جانب العميل باستخدام العلامات أدناه. أكثر عوامل التصفية شيوعًا:

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/'));

يوجد معامل استعلام اختياري واحد من جانب الخادم: يُرجِع GET /v1/models?channels=1 إضافةً إلى ذلك إدخالات الأسماء البديلة لكل قناة (للعملاء المدركين للتوجيه)؛ وبدونه تُحذَف تلك الأسماء البديلة.


مجالات التسعير

الجميع *pricepermilliontokens الحقول عبارة عن عدد صحيح لكل 1000000 رمز. القسمة على 100 دولار لكل مليون.

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).

حالة النموذج والإهمال

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.

النماذج المعطّلة كلّياً ليست قيمة حالة — بل تُستبعَد من /v1/models بالكامل (لكل مُستدعٍ، بما في ذلك المسؤولون) ولا تُستدعى إلا بالاسم الدقيق عبر أدوات المسؤولين.

هل تريد عرضًا قابلاً للتصفح؟

ال /صفحة النماذج يعرض هذه البيانات نفسها مع مقارنات التجميع والبحث والتسعير.