모델 카탈로그 | 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 RequestBeam. 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)을 지원하지만 RequestBeam에는 현재 공개되지 않았습니다. 활성 연동의 기본 모델이 아닙니다. 모델을 호출하기 전에 자신의 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

공개 모델 식별자입니다. model을 받는 API에서는 이 값을 요청 본문의 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 출력 예산에는 사고 과정과 최종 텍스트가 포함됩니다. 128처럼 작은 max_tokens 값은 최종 텍스트가 생성되기 전에 소진될 수 있습니다. Claude 메시지에 설명된 대로 둘 다 수용할 수 있는 양의 정수 예산을 사용하세요.

모델 계열 가이드

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는 Twitter 데이터 API를 나타내며 채팅 모델이 아닙니다. Chat Completions에 twitterapi를 전달하지 말고 /v1/twitter/* 엔드포인트를 사용하세요.

모델 ID 규칙

Chat Completions, Responses, Claude Messages, 이미지 및 Seedance 동영상 API는 model을 사용합니다.
Seedance의 정식 모델 ID는 seedance-2.0과 seedance-2.5입니다. Seedance 2.0 엔드포인트는 이전 별칭 seedance-2-0도 허용하지만 새 요청과 카탈로그 조회에는 점으로 구분한 정식 ID를 사용해야 합니다.
GET https://api.apihop.ai/v1/models에서 반환된 모델 ID만 사용하세요.
사용할 수 없는 모델은 /v1/models에 나타나지 않으며 새 호출에 사용해서는 안 됩니다.
모델 제한이 있는 API 키에는 문서화된 모델의 일부만 반환될 수 있습니다.

오류 응답

전체 코드 참조, 프로토콜 차이 및 진단 절차는 오류 코드 및 문제 해결을 참조하세요.

json

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