> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hostlinku.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 模型

> GET /v1/models 端点、目录数据格式以及如何选择合适的模型

Hostlinku 提供了一个集中式的模型目录。 每个模型都有一个唯一的**slug**，该**slug**用于 [Chat Completions](https://docs.hostlinku.com/zh/chat-completions.md) 中的 `model` 参数，并附有上下文大小、功能和每Token价格等信息。

## `GET /v1/models`

返回所有状态为 `available`、尚未被废弃且可用于所选 **Service Mode API key**（性能型或低成本型）的模型，以及该模式下 kredit 每 100 万Token的价格。

```http theme={null}
GET https://api.hostlinku.com/v1/models
Authorization: Bearer sk-your-api-key
```

示例：

```bash theme={null}
curl https://api.hostlinku.com/v1/models \
  -H "Authorization: Bearer sk-your-api-key"
```

响应（示例已截取；您账户的具体数值可从该端点获取）：

```json theme={null}
{
  "object": "list",
  "service_mode": "performance",
  "data": [
    {
      "id": "claude-haiku-4-5",
      "object": "model",
      "created": 1791380432,
      "owned_by": "hostlinku",
      "context_window": 200000,
      "capabilities": ["text", "tool-calling", "function-calling", "structured-outputs", "json-mode", "streaming", "code-generation", "long-context", "multilingual"],
      "service_mode": "performance",
      "pricing": {
        "input": 0.8,
        "output": 4,
        "cache_read": 0.08,
        "cache_write": 1,
        "unit": "1M_tokens",
        "currency": "🪙"
      }
    }
  ]
}
```

| Field | 含义 |
| - | - |
| `service_mode`（级别列表及项目） | 所使用的Service Mode API key模型：`performance`或`low_cost`。不同模式下的模型列表各不相同。 |
| `id` | 模型标识符，即在字段`model`中使用的值，该字段出现在字段`/v1/chat/completions`、`/v1/messages`和`/v1/responses`中。 |
| `created` | 模型添加到目录的时间（Unix 纪元，秒）。 |
| `owned_by` | 始终为 `"hostlinku"` - 这表示该模型由目录 Hostlinku 管理。 |
| `context_window` | Token（输入+输出）中的最大上下文长度。 |
| `capabilities` | 能力列表，例如：`vision`、`tool-calling`、`json-mode`、`reasoning`、`long-context`。 |
| `pricing` | Service Mode中的价格对象；若该模型在该模式下尚未设定价格，则为`null`。 `pricing.unit`始终为`"1M_tokens"`，而`pricing.currency`包含信用符号（1 kredit = \$1）。 |
| `pricing.input` / `pricing.output` | 提示Token/回答Token的价格按**100万个Token**为单位计算（而非按1个Token或1000个Token为单位）。 |
| `pricing.cache_read` / `pricing.cache_write` | 每1MToken对应的5分钟缓存读取/缓存写入费用（参见[提示缓存](https://docs.hostlinku.com/zh/prompt-caching.md)）；若模型不支持，则参见`null`。 |

响应中的定价即客户价格

`pricing` 这一数值即为你在 Service Mode API key 中支付的价格；其中已包含平台手续费。每次请求的实际费用始终会显示在响应中的 `hostlinku.cost` 区块以及控制台日志中。

## 公共目录（无需认证）

对于无需 API 密钥的营销或探索类网站，可使用公共目录：

```http theme={null}
GET https://api.hostlinku.com/api/public/models
```

公共目录仅显示模型为 Hostlinku 的产品，以及其别名、名称、上下文、功能和公开价格。 支持的查询：`q`（名称/描述搜索）、`capability`、`family`、`sort`（`popular`、 `newest`、`price-asc`、`price-desc`、`context-desc`、`name-asc`）、`page` 和 `pageSize`（最多 100 条）。 `data`的响应包含`items`、`total`、`page`、`pageSize`和`totalPages`。

## 模型列表

目前共有45种模型。点击模型名称可查看其适用场景、功能、价格及支持的端点。

| 模型 | 提供商 | 上下文 | 最大输出 | 输入 /1M | 输出 /1M |
| - | - | - | - | - | - |
| [Qwen 3.6 Plus](https://docs.hostlinku.com/zh/models/qwen3-6-plus.md) | Alibaba | 1,000,000 | - | \$0.294 | \$1.765 |
| [Qwen 3.7 Max](https://docs.hostlinku.com/zh/models/qwen3-7-max.md) | Alibaba | 1,000,000 | - | \$1.765 | \$5.294 |
| [Model Baize](https://docs.hostlinku.com/zh/models/model-baize.md) | Anonymous | 1,000,000 | - | \$1.177 | \$4.118 |
| [Claude Fable 5](https://docs.hostlinku.com/zh/models/claude-fable-5.md) | Anthropic | 1,000,000 | 128,000 | \$10 | \$50 |
| [Claude Fable 5.1](https://docs.hostlinku.com/zh/models/claude-fable-5-1.md) | Anthropic | 1,000,000 | 128,000 | - | - |
| [Claude Haiku 4.5](https://docs.hostlinku.com/zh/models/claude-haiku-4-5.md) | Anthropic | 200,000 | 64,000 | \$1 | \$5 |
| [Claude Opus 4.6](https://docs.hostlinku.com/zh/models/claude-opus-4-6.md) | Anthropic | 1,000,000 | 32,000 | \$5 | \$25 |
| [Claude Opus 4.7](https://docs.hostlinku.com/zh/models/claude-opus-4-7.md) | Anthropic | 1,000,000 | 32,000 | \$5 | \$25 |
| [Claude Opus 4.8](https://docs.hostlinku.com/zh/models/claude-opus-4-8.md) | Anthropic | 1,000,000 | 128,000 | \$5 | \$25 |
| [Claude Opus 5](https://docs.hostlinku.com/zh/models/claude-opus-5.md) | Anthropic | 1,000,000 | 64,000 | \$5 | \$25 |
| [Claude Opus 5.5](https://docs.hostlinku.com/zh/models/claude-opus-5-5.md) | Anthropic | 1,000,000 | 128,000 | \$4 | \$20 |
| [Claude Sonnet 4.6](https://docs.hostlinku.com/zh/models/claude-sonnet-4-6.md) | Anthropic | 1,000,000 | 64,000 | \$3 | \$15 |
| [Claude Sonnet 5](https://docs.hostlinku.com/zh/models/claude-sonnet-5.md) | Anthropic | 1,000,000 | 64,000 | \$2 | \$10 |
| [Claude Sonnet 5.5](https://docs.hostlinku.com/zh/models/claude-sonnet-5-5.md) | Anthropic | 1,000,000 | 128,000 | - | - |
| [DeepSeek V4 Flash](https://docs.hostlinku.com/zh/models/deepseek-v4-flash.md) | DeepSeek | 1,000,000 | - | \$0.15 | \$0.6 |
| [DeepSeek V4 Pro](https://docs.hostlinku.com/zh/models/deepseek-v4-pro.md) | DeepSeek | 1,000,000 | 64,000 | \$0.662 | \$1.985 |
| [DeepSeek-V4.1-Flash](https://docs.hostlinku.com/zh/models/deepseek-v4-1-flash.md) | DeepSeek | 1,000,000 | 384,000 | \$0.15 | \$0.6 |
| [DeepSeek-V4.1-Flash Hyper](https://docs.hostlinku.com/zh/models/deepseek-v4-1-flash-hyper.md) | DeepSeek | 1,000,000 | 384,000 | - | - |
| [DeepSeek-V4.1-Flash Hyper Chat](https://docs.hostlinku.com/zh/models/deepseek-v4-1-flash-hyper-chat.md) | DeepSeek | 1,000,000 | 384,000 | - | - |
| [DeepSeek-V4.1-Flash Turbo](https://docs.hostlinku.com/zh/models/deepseek-v4-1-flash-turbo.md) | DeepSeek | 1,000,000 | 384,000 | - | - |
| [MiniMax M3](https://docs.hostlinku.com/zh/models/minimax-m3.md) | MiniMax | 1,000,000 | 64,000 | \$0.309 | \$1.235 |
| [Kimi K2.6](https://docs.hostlinku.com/zh/models/kimi-k2-6.md) | Moonshot | 256,000 | 32,000 | \$0.956 | \$3.971 |
| [Kimi K2.7 Code](https://docs.hostlinku.com/zh/models/kimi-k2-7-code.md) | Moonshot | 256,000 | - | \$0.956 | \$3.971 |
| [Kimi K3](https://docs.hostlinku.com/zh/models/kimi-k3.md) | Moonshot | 1,000,000 | 64,000 | \$2.941 | \$14.706 |
| [Kimi K3 Hyper](https://docs.hostlinku.com/zh/models/kimi-k3-hyper.md) | Moonshot | 1,000,000 | 64,000 | - | - |
| [Kimi K3 Hyper Chat](https://docs.hostlinku.com/zh/models/kimi-k3-hyper-chat.md) | Moonshot | 1,000,000 | 64,000 | - | - |
| [Kimi K3 Turbo](https://docs.hostlinku.com/zh/models/kimi-k3-turbo.md) | Moonshot | 1,000,000 | 64,000 | - | - |
| [GPT 5.3 Codex](https://docs.hostlinku.com/zh/models/gpt-5-3-codex.md) | OpenAI | 400,000 | 128,000 | \$1.75 | \$14 |
| [GPT-5.5](https://docs.hostlinku.com/zh/models/gpt-5-5.md) | OpenAI | 1,000,000 | 128,000 | \$5 | \$30 |
| [GPT-5.6 Luna](https://docs.hostlinku.com/zh/models/gpt-5-6-luna.md) | OpenAI | 1,050,000 | 64,000 | \$0.2 | \$1.2 |
| [GPT-5.6 Sol](https://docs.hostlinku.com/zh/models/gpt-5-6-sol.md) | OpenAI | 1,050,000 | 64,000 | \$4 | \$20 |
| [GPT-5.6 Terra](https://docs.hostlinku.com/zh/models/gpt-5-6-terra.md) | OpenAI | 1,050,000 | 64,000 | \$2 | \$12 |
| [GPT-6 Astra](https://docs.hostlinku.com/zh/models/gpt-6-astra.md) | OpenAI | 1,050,000 | 128,000 | \$10 | \$50 |
| [GPT-6 Luna](https://docs.hostlinku.com/zh/models/gpt-6-luna.md) | OpenAI | 1,050,000 | 128,000 | \$0.1 | \$0.5 |
| [GPT-6 Sol](https://docs.hostlinku.com/zh/models/gpt-6-sol.md) | OpenAI | 1,050,000 | 128,000 | \$2 | \$10 |
| [GPT-6.1 Sol](https://docs.hostlinku.com/zh/models/gpt-6-1-sol.md) | OpenAI | 1,050,000 | 128,000 | \$2 | \$10 |
| [MiMo V2.5 Pro](https://docs.hostlinku.com/zh/models/mimo-v2-5-pro.md) | Xiaomi | 1,000,000 | 32,000 | \$0.441 | \$0.882 |
| [GLM 5](https://docs.hostlinku.com/zh/models/glm-5.md) | Zhipu | 200,000 | - | \$0.588 | \$2.647 |
| [GLM 5.1](https://docs.hostlinku.com/zh/models/glm-5-1.md) | Zhipu | 200,000 | 128,000 | \$0.882 | \$3.529 |
| [GLM 5.2](https://docs.hostlinku.com/zh/models/glm-5-2.md) | Zhipu | 1,000,000 | 64,000 | \$1.177 | \$4.118 |
| [GLM 5.3](https://docs.hostlinku.com/zh/models/glm-5-3.md) | Zhipu | 1,000,000 | 64,000 | \$1.177 | \$4.118 |
| [GLM 5.3 Hyper Chat](https://docs.hostlinku.com/zh/models/glm-5-3-hyper-chat.md) | Zhipu | 1,000,000 | 64,000 | - | - |
| [GLM-5.3 Flash](https://docs.hostlinku.com/zh/models/glm-5-3-flash.md) | Zhipu | 1,000,000 | 64,000 | - | - |
| [GLM-5.3 Flash Hyper](https://docs.hostlinku.com/zh/models/glm-5-3-flash-hyper.md) | Zhipu | 1,000,000 | 64,000 | - | - |
| [GLM-5.3 Flash Hyper Chat](https://docs.hostlinku.com/zh/models/glm-5-3-flash-hyper-chat.md) | Zhipu | 1,000,000 | 64,000 | - | - |

## 如何选择模型

1. **确定需求**：普通聊天、推理（*reasoning*）、视觉/多模态、工具调用，还是结构化JSON输出。请查看字段`capabilities`。
2. **请注意上下文长度**：请确保 `context_window` 足以容纳您的提示词和输出内容。
3. **价格对比**：`pricing.input` 用于提示Token，`pricing.output` 用于回答Token；推理模型的输出通常价格更高。
4. **从低端模型开始**：在开发阶段，低端模型（例如 `gpt-6-luna`、`deepseek-v4-1-flash`、`qwen3-6-plus`）价格要便宜得多；只有在质量不达标时，才应升级模型。
5. **查看控制台**：[console.hostlinku.com](https://console.hostlinku.com) 上的 **模型** 菜单显示了包含相同价格和功能的目录，以及各模型的详细信息页面。

别名（slug）

请使用与 `GET /v1/models` 返回结果完全一致的 slug。在显示端，slug 不区分大小写，但请务必按目录中的原样复制，以避免输入错误。 目录中不存在的 slug 将返回 `404 MODEL_NOT_FOUND`；已弃用或当前不可用的模型将返回 `503 MODEL_UNAVAILABLE`，并附带替代 slug 的建议（如有）。

## 路由与故障转移

Hostlinku 会自行管理为每个模型服务的内部路径。如果当前使用的路径出现故障（5xx/超时），系统会在放弃之前自动尝试通过其他路径重试请求。您仍可使用相同的模型 slug，无需进行任何更改；这些内部细节不会在响应中显示。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.