מדריך API

API מודלים

GET /v1/models ו-GET /v1/models/{id} מציגים את המודלים הציבוריים עם המגבלות, המחירים והיכולות שלהם.

רשימת המודלים

GEThttps://api.notholy.com/v1/models

GET https://api.notholy.com/v1/models

הרשימה ציבורית ולא צריך מפתח כדי לקרוא אותה. היא כוללת כל מודל פעיל או מיושן (deprecated), לפי סדר הקטלוג, בפורמט הרשימה של OpenAI עם שדות נוספים.

JSON

{
  "object": "list",
  "data": [
    {
      "id": "notholy-specter",
      "object": "model",
      "created": 1794014537,
      "owned_by": "notholy",
      "base_model": "GLM 5.3 Abliterated",
      "capabilities": {
        "reasoning": true,
        "reasoning_efforts": [
          "low",
          "high",
          "max"
        ],
        "tools": true
      },
      "context_length": 1048576,
      "input_modalities": [
        "text"
      ],
      "max_output_tokens": 131072,
      "name": "NotHoly Specter",
      "pricing": {
        "currency": "USD",
        "unit": "1M tokens",
        "cached_input": "0.273000",
        "input": "1.820000",
        "output": "3.640000"
      },
      "status": "active"
    }
  ]
}

שדות

שדה	סוג	הערות
`id`	string	הערך שנשלח בשדה `model`
`name`	string	שם לתצוגה
`status`	string	`active` או `deprecated`
`context_length`	integer	טוקני קלט ופלט יחד
`max_output_tokens`	integer	המקסימום שבקשה אחת יכולה לייצר
`input_modalities`	string[]	`text`, ובנוסף `image` במודלים שמקבלים תמונות
`capabilities`	object	`tools`, `reasoning` ורשימת `reasoning_efforts` המותרים
`pricing`	object	USD למיליון טוקנים, כמחרוזות עשרוניות: `input`, `output`, `cached_input`
`base_model`	string	המודל במשקלים פתוחים שעליו הוא מבוסס, אם המידע פורסם
`default`	boolean	קיים ומכיל `true` במודל שלקוחות צריכים להשתמש בו כשלא נבחר מודל

עם הכותרת anthropic-version הרשימה מגיעה במבנה של Anthropic: {data, has_more, first_id, last_id} עם פריטים מסוג {type: "model", id, display_name, created_at}.

שליפת מודל

GEThttps://api.notholy.com/v1/models/notholy-specter

GET https://api.notholy.com/v1/models/notholy-specter

מחזיר את אותו אובייקט עבור מודל אחד. מזהה לא מוכר או מודל שהוצא משימוש מחזירים 404 model_not_found.

curl https://api.notholy.com/v1/models/notholy-specter -H "Authorization: Bearer $NOTHOLY_API_KEY"

import os
from openai import OpenAI

client = OpenAI(base_url="https://api.notholy.com/v1", api_key=os.environ["NOTHOLY_API_KEY"])

for m in client.models.list():
    print(m.id)