مدلها
فهرست مدلها
فهرست مدلهایی که این کلید میتواند صدا بزند، با نوع، تواناییها، پنجرهی متن و قیمت هر واحد. قابل فیلتر بر اساس نوع و توانایی.
/v1/modelsپاسخ فقط مدلهایی را دارد که روشن، در API عرضهشده، قیمتگذاریشده و برای کلید شما مجازند. اگر برای کلید فهرست مدلهای مجاز گذاشته باشید، بقیه دیده نمیشوند.
بدنهی هر مدل، فیلدهای OpenAI (id، object، created، owned_by) و فیلدهای Anthropic (type، display_name، created_at) را کنار هم دارد تا کتابخانههای هر دو قالب کار کنند. فیلدهای اضافهی وان ای آی kind، capabilities، context_window، max_output_tokens، architecture، knowledge_cutoff و pricing هستند. pricing نقشهی «واحد به اعتبار» است، مثل input_1k برای هر هزار توکن ورودی. اعتبار را ببینید.
فهرست صفحهبندی ساده دارد: limit تعداد را محدود میکند و after_id از بعد از یک مدل ادامه میدهد. has_more میگوید باز هم مدل هست و last_id را برای after_id بعدی بردارید. ترتیب فهرست ثابت است.
نمونهها
curl "https://1ai.ir/v1/models?kind=chat&capability=tools&limit=2" \
-H "Authorization: Bearer $ONEAI_API_KEY"{
"object": "list",
"data": [
{
"id": "openai/gpt-6-luna",
"object": "model",
"type": "model",
"display_name": "GPT-6 Luna",
"description": "A fast general model.",
"created_at": "2026-01-01T00:00:00.000Z",
"created": 1767225600,
"owned_by": "openai",
"name": "GPT-6 Luna",
"kind": "chat",
"capabilities": [
"tools",
"vision",
"decisions"
],
"context_window": 400000,
"max_output_tokens": 64000,
"architecture": {
"input_modalities": [
"text",
"image"
],
"output_modalities": [
"text"
]
},
"knowledge_cutoff": "2026-03",
"pricing": {
"input_1k": 0.5,
"output_1k": 2,
"cached_input_1k": 0.05
}
},
{
"id": "anthropic/claude-haiku-5.5",
"object": "model",
"type": "model",
"display_name": "Claude Haiku 5.5",
"description": "A small, quick model.",
"created_at": "2026-01-01T00:00:00.000Z",
"created": 1767225600,
"owned_by": "anthropic",
"name": "Claude Haiku 5.5",
"kind": "chat",
"capabilities": [
"tools",
"vision"
],
"context_window": 200000,
"max_output_tokens": 32000,
"architecture": {
"input_modalities": [
"text",
"image"
],
"output_modalities": [
"text"
]
},
"knowledge_cutoff": "2026-02",
"pricing": {
"input_1k": 0.3,
"output_1k": 1.5
}
}
],
"has_more": true,
"first_id": "openai/gpt-6-luna",
"last_id": "anthropic/claude-haiku-5.5"
}پارامترهای کوئری
kindstringفقط مدلهای این نوع. مثلاً
chat،image،embedding،tts،stt،video،music،rerank،moderation،ocr.capabilitystringفقط مدلهایی که این توانایی را دارند، مثل
toolsیاvision.limitintegerحداکثر تعداد مدل در پاسخ. عدد صحیح مثبت. بدون آن همهی مدلها (از
after_idبه بعد) میآیند.after_idstringشناسهی مدلی که فهرست از بعد از آن ادامه مییابد. اگر در فهرست نباشد، از ابتدا شروع میشود.
خطاها
invalid_api_key401کلید نامعتبر، لغوشده یا منقضی است.
صفحههای مرتبط
- دریافت یک مدلمشخصات یک مدل با شناسهی آن، شامل تواناییها، محدودیتها و قیمت. شناسه با اسلش نوشته میشود، مثل openai/gpt-6-luna.
- اعتبار و صورتحسابهزینهی API چگونه از اعتبار کم میشود: رزرو پیش از اجرا، تسویه بعد از آن، خطای 402 و جای دیدن قیمتها.
- فهرست مدلها در قالب Geminiفهرست مدلهای چت در قالب Google (models.list) برای کتابخانهها و ابزارهایی که با Gemini API کار میکنند، با صفحهبندی pageSize و pageToken.