แค็ตตาล็อกโมเดล | เอกสาร 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 Token

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 ของคุณส่งกลับ

ตระกูลโมเดล	ID โมเดล	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 (ID แยก พร้อมใช้เฉพาะหลังติดตั้งและเปิดใช้ ตรวจ 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

คู่มือเหล่านี้ครอบคลุมการเลือกโมเดล ตัวอย่างคำขอ หมายเหตุงบเอาต์พุต และขอบเขตโปรโตคอลสาธารณะปัจจุบัน การตอบกลับปัจจุบันจากเอนด์พอยต์นี้ยังเป็นข้อมูลหลักของความพร้อม

โมเดลภาพและวิดีโอปัจจุบัน

ตระกูลโมเดล	ID โมเดล	ชนิด	เอนด์พอยต์สาธารณะ
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 แทน API ข้อมูล Twitter ไม่ใช่โมเดลแชต ใช้เอนด์พอยต์ /v1/twitter/* แทนส่ง twitterapi ไป Chat Completions

กฎ ID โมเดล

API Chat Completions, Responses, Claude Messages, ภาพ และวิดีโอ Seedance ใช้ model
ID โมเดล Seedance มาตรฐานคือ seedance-2.0 และ seedance-2.5 เอนด์พอยต์ Seedance 2.0 รับชื่อแทนเก่า seedance-2-0 ด้วย แต่คำขอใหม่และการค้นแค็ตตาล็อกควรใช้ ID มาตรฐานที่มีจุด
ใช้เฉพาะ ID โมเดลที่ GET https://api.apihop.ai/v1/models ส่งกลับ
โมเดลไม่พร้อมไม่ปรากฏใน /v1/models และไม่ควรใช้เรียกใหม่
คีย์ API ที่จำกัดโมเดลอาจได้รับเพียงบางโมเดลในเอกสาร

การตอบกลับข้อผิดพลาด

ดูรหัสข้อผิดพลาดและการแก้ปัญหา สำหรับรหัสอ้างอิงทั้งหมด ความต่างโปรโตคอล และขั้นตอนวินิจฉัย

json

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