*更新日期: 2026-08-22*

# 模型

**GET** `/v1/models`

列出当前 Key 可见、且已对客开通的模型。不计 RPM、不计费。

可选过滤：`capability`（`chat` / `image` / `video`）、`owned_by`（大模型厂商 id）。官方 OpenAI SDK 的 `models.list()` 带不了这些参数，HTTP 可直接加 query。

```bash
curl "https://tokenmei.com/v1/models?capability=image" \
  -H "Authorization: Bearer $MOMO_API_KEY"
```

```javascript
const models = await client.models.list();
for (const item of models.data) {
  console.log(item.id, item.owned_by);
}
```

```python
for item in client.models.list().data:
    print(item.id, item.owned_by)
```

```go
models, _ := client.Models.List(context.TODO(), openai.ModelListParams{})
for _, item := range models.Data {
	fmt.Println(item.ID, item.OwnedBy)
}
```

```php
foreach ($client->models()->list()->data as $item) {
    echo $item->id, " ", $item->ownedBy, PHP_EOL;
}
```

```java
for (Model item : client.models().list().data()) {
    System.out.println(item.id() + " " + item.ownedBy());
}
```

```csharp
foreach (var item in client.GetOpenAIModelClient().GetModels()) {
    Console.WriteLine($"{item.Id} {item.OwnedBy}");
}
```

```json
{
  "object": "list",
  "data": [
    {
      "id": "doubao-seed-1.6",
      "object": "model",
      "created": 1710000000,
      "owned_by": "bytedance",
      "display_name": "doubao-seed-1.6",
      "vendor": "bytedance",
      "recommended": false,
      "capability": "chat",
      "pricing": {
        "currency": "CNY",
        "unit": "token_1m",
        "amount": "0.8",
        "input_amount": "0.8",
        "output_amount": "2"
      }
    },
    {
      "id": "doubao-seedream-4-0-250828",
      "object": "model",
      "created": 1710000000,
      "owned_by": "bytedance",
      "display_name": "doubao-seedream-4-0-250828",
      "vendor": "bytedance",
      "capability": "image",
      "pricing": {
        "currency": "CNY",
        "unit": "image",
        "amount": "0.20",
        "size_multipliers": { "2048x2048": "1.5" }
      }
    }
  ]
}
```

OpenAI 核心字段保持不变，扩展字段按需出现：没有售价时，`pricing` 不会出现，不会填 `null`。

| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | string | 对外模型 id，请求里填这个 |
| `object` | string | 固定 `model` |
| `created` | int | Unix 秒 |
| `owned_by` | string | 大模型厂商 id（与 `vendor` 一致）；未配置时为空字符串，不暴露上游渠道 |
| `display_name` | string | 与 `id` 相同 |
| `vendor` | string | 大模型厂商 id（Logo stem），有配置时出现 |
| `description` | string | 可选说明介绍 |
| `capability` | string | `chat` / `image` / `video`，决定走哪条生成路径 |
| `recommended` | boolean | 是否为推荐模型；C 端模型列表展示「推荐」标签 |
| `pricing` | object | 对客售价；未配价格则省略。不含成本明细 |

`pricing` 金额都是十进制字符串：

| 字段 | 说明 |
|------|------|
| `currency` | 如 `CNY` |
| `unit` | `token` / `token_1k` / `token_1m` / `image` / `request` / `second` |
| `amount` | 默认单价（chat 为输入价） |
| `input_amount` / `output_amount` | chat 的输入 / 输出单价，单位为每百万 token |
| `size_multipliers` | 尺寸倍率，如 `{ "2048x2048": "1.5" }` |
| `price_table` | 视频价目表（`mode` + `rates`）；仅客户价 |

同一 `id` 只对应一种能力。官方 SDK 的强类型对象通常读不到扩展字段，需要 HTTP 或解析原始 JSON。

**GET** `/v1/models/{model}`

`{model}` 是对外 `id`。形状与列表里的单条相同。不存在或对你不可见：`404` + `model_not_found`，`param` 为 `model`。

```bash
curl https://tokenmei.com/v1/models/doubao-seed-1.6 \
  -H "Authorization: Bearer $MOMO_API_KEY"
```

```javascript
const model = await client.models.retrieve("doubao-seed-1.6");
console.log(model.id);
```

```python
model = client.models.retrieve("doubao-seed-1.6")
print(model.id)
```

```go
model, _ := client.Models.Get(context.TODO(), "doubao-seed-1.6")
fmt.Println(model.ID)
```

```php
$model = $client->models()->retrieve("doubao-seed-1.6");
echo $model->id;
```

```java
Model model = client.models().retrieve("doubao-seed-1.6");
System.out.println(model.id());
```

```csharp
var model = client.GetOpenAIModelClient().GetModel("doubao-seed-1.6");
Console.WriteLine(model.Id);
```

过滤条件（同时满足才出现）：平台已开放、模型已启用、能力为 chat / image / video。未配价格的模型即使被误列，调用时仍是 `model_not_found`。
