كتالوج النماذج | وثائق API

# Model Catalog

List the models available to the current API Key and their public protocols.

GET https://api.apihop.ai/v1/models

`GET https://api.apihop.ai/v1/models` returns the models available to the current API Key. Availability can change with model configuration, service health, and API Key permissions, so the live API response is the final source of truth.

Claude Sonnet 4.6 (`claude-sonnet-4-6`) is supported by the upstream supplier but is not currently published on API Hop. It is not an active integration default. Before calling any model, confirm access with your own `GET https://api.apihop.ai/v1/models` response.

```text
GET https://api.apihop.ai/v1/models
```

## Authentication

All requests require a Bearer Token.

```http
Authorization: Bearer YOUR_API_KEY
```

## Request Example

```bash
curl --request GET \
  --url https://api.apihop.ai/v1/models \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

## Response

### `uid` (string)

Public model identifier. For APIs that accept `model`, use this value in the request body's `model` field.

### `name` (string)

Display name.

### `version` (string | null)

Version field. Current entries usually return `null`.

### `type` (string)

Model type, currently mainly `text`, `image`, or `video`.

### `pricing` (object | null)

Current platform pricing for the model. Use the live API or console for current values.

### Success Example

```json
{
  "success": true,
  "data": [
    {
      "uid": "gpt-5.6-sol",
      "name": "ChatGPT-5.6 Sol",
      "version": null,
      "type": "text",
      "pricing": {
        "unit": "credits",
        "tokenTierBasis": "input_tokens",
        "tiers": []
      }
    },
    {
      "uid": "seedance-2.5",
      "name": "Seedance 2.5",
      "version": null,
      "type": "video",
      "pricing": {
        "unit": "credits",
        "tiers": []
      }
    }
  ],
  "requestId": "req_..."
}
```

## Current Text Models

The following table summarizes the currently documented text models. For each request, use the models returned by your own `GET https://api.apihop.ai/v1/models` call.

| Model family | Model ID | Chat Completions | Responses | Claude Messages |
| --- | --- | --- | --- | --- |
| OpenAI | `gpt-5.4` | Yes | Yes | - |
| OpenAI | `gpt-5.5` | Yes | Yes | - |
| OpenAI | `gpt-5.6-sol` | Yes | Yes | - |
| OpenAI | `gpt-5.6-terra` | Yes | Yes | - |
| OpenAI | `gpt-6-astra` | Yes | Yes | - |
| Anthropic | `claude-fable-5` | Yes | - | Yes |
| Anthropic | `claude-fable-5-1` | Yes | - | Yes |
| Anthropic | `claude-opus-4-6` | Yes | - | Yes |
| Anthropic | `claude-opus-4-7` | Yes | - | Yes |
| Anthropic | `claude-opus-4-8` | Yes | - | Yes |
| Anthropic | `claude-opus-5` | Yes | - | Yes |
| Anthropic | `claude-opus-5-5` | Yes | - | Yes |
| Anthropic | `claude-sonnet-5` | Yes | - | Yes |
| Anthropic | `claude-sonnet-5-5` | Yes | - | Yes |
| DeepSeek | `deepseek-v4-flash` | Yes | - | - |
| DeepSeek | `deepseek-v4-pro` | Yes | - | - |
| DeepSeek | `deepseek-v4.1-flash` | After deployment and enablement | - | - |
| Gemini | `gemini-3.6-flash` | Yes | - | - |
| Gemini | `gemini-3.7-flash` | Yes | - | - |
| Gemini | `gemini-3.8-flash` | Yes | - | - |
| Gemini | `gemini-3.5-flash-lite` | Yes | - | - |
| Gemini | `gemini-4-argon` | Yes (after enablement) | - | - |
| Kimi | `kimi-k3` | Yes | - | - |
| MiniMax | `minimax-m3` | Yes | - | - |

Claude output budgets include thinking and final text. A small `max_tokens` value such as `128` may be exhausted before any final text is produced. Use a positive integer budget with room for both, as described in [Claude Messages](https://apihop.ai/en/docs/api-reference/Claude/messages).

## Model Family Guides

- [DeepSeek Models](https://apihop.ai/en/docs/api-reference/DeepSeek/models): `deepseek-v4-flash`, `deepseek-v4-pro`, `deepseek-v4.1-flash` (a distinct ID, available only after deployment and enablement; check `GET https://api.apihop.ai/v1/models`)
- [Gemini Models](https://apihop.ai/en/docs/api-reference/Gemini/models): `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-3.5-flash-lite`, `gemini-4-argon` (after deployment and enablement)
- [Kimi Model](https://apihop.ai/en/docs/api-reference/Kimi/models): `kimi-k3`
- [MiniMax Model](https://apihop.ai/en/docs/api-reference/MiniMax/models): `minimax-m3`

These guides cover model selection, request examples, output-budget notes, and the current public protocol boundary. The live response from this endpoint remains authoritative for availability.

## Current Image and Video Models

| Model family | Model ID | Type | Public endpoint |
| --- | --- | --- | --- |
| OpenAI | `gpt-image-2` | Image | `POST https://api.apihop.ai/openai/v1/images/generations` |
| OpenAI | `gpt-image-2.5-flare` | Image | `POST https://api.apihop.ai/openai/v1/images/generations` |
| OpenAI | `gpt-image-2.5-sunburst` | Image | `POST https://api.apihop.ai/openai/v1/images/generations` |
| BytePlus | `seedance-2.0` | Video | `POST https://api.apihop.ai/v1/video/seedance` |
| BytePlus | `seedance-2.5` | Video | `POST https://api.apihop.ai/v1/video/seedance` |

## Other API Entry

`twitterapi` represents the Twitter data APIs and is not a Chat model. Use the `/v1/twitter/*` endpoints instead of passing `twitterapi` to Chat Completions.

## Model ID Rules

- Chat Completions, Responses, Claude Messages, image, and Seedance video APIs

use `model`.

- The canonical Seedance model IDs are `seedance-2.0` and `seedance-2.5`. The Seedance 2.0 endpoint also accepts the legacy alias `seedance-2-0`, but new requests and catalog lookups should use the canonical dotted ID.
- Use only model IDs returned by `GET https://api.apihop.ai/v1/models`.
- Unavailable models do not appear in `/v1/models` and should not be used for new calls.
- An API Key with model restrictions may receive a subset of the documented models.

## Related Docs

- [Common Chat Completions](https://apihop.ai/en/docs/api-reference/common-chat-completions)
- [DeepSeek Models](https://apihop.ai/en/docs/api-reference/DeepSeek/models)
- [Gemini Models](https://apihop.ai/en/docs/api-reference/Gemini/models)
- [Kimi Model](https://apihop.ai/en/docs/api-reference/Kimi/models)
- [MiniMax Model](https://apihop.ai/en/docs/api-reference/MiniMax/models)
- [OpenAI Responses](https://apihop.ai/en/docs/api-reference/OpenAI/responses)
- [Claude Messages](https://apihop.ai/en/docs/api-reference/Claude/messages)
- [GPT-Image-2 Image Generation](https://apihop.ai/en/docs/api-reference/OpenAI/gpt-image-2)
- [Seedance 2.0 Video Generation](https://apihop.ai/en/docs/api-reference/BytePlus/seedance-2-0)
- [Seedance 2.5 Video Generation](https://apihop.ai/en/docs/api-reference/BytePlus/seedance-2-5)

## Error Response

See [Error Codes and Troubleshooting](https://apihop.ai/en/docs/api-reference/errors) for the full code reference, protocol differences, and diagnostic steps.

```json
{
  "success": false,
  "error": {
    "code": 20000,
    "message": "Invalid or missing API key"
  },
  "requestId": "req_..."
}
```

يعيد GET https://api.apihop.ai/v1/models النماذج المتاحة لمفتاح API الحالي. قد تتغير الإتاحة بحسب إعداد النموذج وصحة الخدمة وصلاحيات مفتاح API، لذا تكون استجابة API المباشرة المرجع النهائي.

يدعم المزود Claude Sonnet 4.6 (claude-sonnet-4-6)، لكنه غير منشور حاليا على API Hop. وليس خيار تكامل افتراضيا نشطا. قبل استدعاء أي نموذج، أكد الوصول من خلال استجابة GET https://api.apihop.ai/v1/models الخاصة بك.

text

GET https://api.apihop.ai/v1/models

المصادقة

تتطلب جميع الطلبات رمز Bearer.

http

Authorization: Bearer YOUR_API_KEY

مثال طلب

bash

curl --request GET \
  --url https://api.apihop.ai/v1/models \
  --header 'Authorization: Bearer YOUR_API_KEY'

الاستجابة

uidstring

معرف النموذج العام. لواجهات API التي تقبل model، استخدم هذه القيمة في حقل model بجسم الطلب.

namestring

اسم العرض.

versionstring | null

حقل الإصدار. تعيد المدخلات الحالية عادة null.

typestring

نوع النموذج، وهو حاليا في الغالب text أو image أو video.

pricingobject | null

تسعير المنصة الحالي للنموذج. استخدم API المباشرة أو وحدة التحكم للقيم الحالية.

مثال نجاح

json

{
  "success": true,
  "data": [
    {
      "uid": "gpt-5.6-sol",
      "name": "ChatGPT-5.6 Sol",
      "version": null,
      "type": "text",
      "pricing": {
        "unit": "credits",
        "tokenTierBasis": "input_tokens",
        "tiers": []
      }
    },
    {
      "uid": "seedance-2.5",
      "name": "Seedance 2.5",
      "version": null,
      "type": "video",
      "pricing": {
        "unit": "credits",
        "tiers": []
      }
    }
  ],
  "requestId": "req_..."
}

النماذج النصية الحالية

يلخص الجدول التالي النماذج النصية الموثقة حاليا. لكل طلب، استخدم النماذج التي يعيدها استدعاء GET https://api.apihop.ai/v1/models الخاص بك.

عائلة النموذج	معرف النموذج	Chat Completions	Responses	Claude Messages
OpenAI	`gpt-5.4`	نعم	نعم	-
OpenAI	`gpt-5.5`	نعم	نعم	-
OpenAI	`gpt-5.6-sol`	نعم	نعم	-
OpenAI	`gpt-5.6-terra`	نعم	نعم	-
OpenAI	`gpt-6-astra`	نعم	نعم	-
Anthropic	`claude-fable-5`	نعم	-	نعم
Anthropic	`claude-fable-5-1`	نعم	-	نعم
Anthropic	`claude-opus-4-6`	نعم	-	نعم
Anthropic	`claude-opus-4-7`	نعم	-	نعم
Anthropic	`claude-opus-4-8`	نعم	-	نعم
Anthropic	`claude-opus-5`	نعم	-	نعم
Anthropic	`claude-opus-5-5`	نعم	-	نعم
Anthropic	`claude-sonnet-5`	نعم	-	نعم
Anthropic	`claude-sonnet-5-5`	نعم	-	نعم
DeepSeek	`deepseek-v4-flash`	نعم	-	-
DeepSeek	`deepseek-v4-pro`	نعم	-	-
DeepSeek	`deepseek-v4.1-flash`	بعد النشر والتفعيل	-	-
Gemini	`gemini-3.6-flash`	نعم	-	-
Gemini	`gemini-3.7-flash`	نعم	-	-
Gemini	`gemini-3.8-flash`	نعم	-	-
Gemini	`gemini-3.5-flash-lite`	نعم	-	-
Gemini	`gemini-4-argon`	نعم (بعد التفعيل)	-	-
Kimi	`kimi-k3`	نعم	-	-
MiniMax	`minimax-m3`	نعم	-	-

تشمل ميزانيات إخراج Claude التفكير والنص النهائي. قد تنفد قيمة max_tokens صغيرة مثل 128 قبل إنتاج أي نص نهائي. استخدم ميزانية بعدد صحيح موجب تتسع لكليهما، كما توضح واجهة Claude Messages.

أدلة عائلات النماذج

نماذج DeepSeek: deepseek-v4-flash وdeepseek-v4-pro وdeepseek-v4.1-flash (معرف مستقل، متاح فقط بعد النشر والتفعيل؛ تحقق عبر GET https://api.apihop.ai/v1/models)
نماذج Gemini: gemini-3.6-flash وgemini-3.7-flash وgemini-3.8-flash وgemini-3.5-flash-lite وgemini-4-argon (بعد النشر والتفعيل)
نموذج Kimi: kimi-k3
نموذج MiniMax: minimax-m3

تغطي هذه الأدلة اختيار النموذج وأمثلة الطلبات وملاحظات ميزانية الإخراج وحدود البروتوكول العام الحالية. وتبقى الاستجابة المباشرة من نقطة النهاية هذه المرجع المعتمد للإتاحة.

نماذج الصور والفيديو الحالية

عائلة النموذج	معرف النموذج	النوع	نقطة النهاية العامة
OpenAI	`gpt-image-2`	صورة	`POST https://api.apihop.ai/openai/v1/images/generations`
OpenAI	`gpt-image-2.5-flare`	صورة	`POST https://api.apihop.ai/openai/v1/images/generations`
OpenAI	`gpt-image-2.5-sunburst`	صورة	`POST https://api.apihop.ai/openai/v1/images/generations`
BytePlus	`seedance-2.0`	فيديو	`POST https://api.apihop.ai/v1/video/seedance`
BytePlus	`seedance-2.5`	فيديو	`POST https://api.apihop.ai/v1/video/seedance`

مدخل API آخر

يمثل twitterapi واجهات بيانات Twitter وليس نموذج محادثة. استخدم نقاط النهاية /v1/twitter/* بدلا من تمرير twitterapi إلى Chat Completions.

قواعد معرفات النماذج

تستخدم واجهات Chat Completions وResponses وClaude Messages والصور وفيديو Seedance الحقل model.
معرفا Seedance المعتمدان هما seedance-2.0 وseedance-2.5. تقبل نقطة نهاية Seedance 2.0 أيضا الاسم القديم seedance-2-0، لكن ينبغي للطلبات الجديدة وعمليات البحث في الكتالوج استخدام المعرف المعتمد ذي النقطة.
استخدم فقط معرفات النماذج التي يعيدها GET https://api.apihop.ai/v1/models.
لا تظهر النماذج غير المتاحة في /v1/models، وينبغي عدم استخدامها للاستدعاءات الجديدة.
قد يتلقى مفتاح API المقيد بنماذج معينة مجموعة فرعية من النماذج الموثقة.

استجابة الخطأ

راجع رموز الأخطاء وتشخيصها للمرجع الكامل للرموز واختلافات البروتوكولات وخطوات التشخيص.

json

{
  "success": false,
  "error": {
    "code": 20000,
    "message": "Invalid or missing API key"
  },
  "requestId": "req_..."
}