*更新日期: 2026-11-07*

# 快速开始

运营在管理台创建 Key 后，明文只出现一次。之后只能看到前缀（如 `sk_live_nEZk`）。先把 Key 放进环境变量，再改 SDK 的 `baseURL`。

当前基址：`https://tokenmei.com`。

## 1. 列模型

确认这把 Key 实际能看到哪些对外 id。不要使用目录外的名称；只用 `GET /v1/models` 返回的 id。

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

```javascript
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.MOMO_API_KEY,
  baseURL: "https://tokenmei.com/v1",
});

const models = await client.models.list();
console.log(models.data.map((item) => item.id));
```

```python
from openai import OpenAI
import os

client = OpenAI(api_key=os.environ["MOMO_API_KEY"], base_url="https://tokenmei.com/v1")
print([m.id for m in client.models.list().data])
```

```go
client := openai.NewClient(
	option.WithAPIKey(os.Getenv("MOMO_API_KEY")),
	option.WithBaseURL("https://tokenmei.com/v1"),
)
models, _ := client.Models.List(context.TODO(), openai.ModelListParams{})
for _, item := range models.Data {
	fmt.Println(item.ID)
}
```

```php
$client = OpenAI::factory()
    ->withApiKey(getenv("MOMO_API_KEY"))
    ->withBaseUri("https://tokenmei.com/v1")
    ->make();
foreach ($client->models()->list()->data as $item) {
    echo $item->id, PHP_EOL;
}
```

```java
OpenAIClient client = OpenAIOkHttpClient.builder()
    .apiKey(System.getenv("MOMO_API_KEY"))
    .baseUrl("https://tokenmei.com/v1")
    .build();
for (Model item : client.models().list().data()) {
    System.out.println(item.id());
}
```

```csharp
var client = new OpenAIClient(
    new ApiKeyCredential(Environment.GetEnvironmentVariable("MOMO_API_KEY")),
    new OpenAIClientOptions { Endpoint = new Uri("https://tokenmei.com/v1") }
);
foreach (var item in client.GetOpenAIModelClient().GetModels()) {
    Console.WriteLine(item.Id);
}
```

无 Key 或 Key 无效：

```json
{
  "error": {
    "message": "无效的 API Key",
    "type": "authentication_error",
    "param": null,
    "code": "invalid_api_key"
  }
}
```

## 2. 查余额

官方 SDK 没有对应方法，直接 HTTP 调。不计费。`balance` 固定两位小数并向下取整。字段见 [计费与产物](/docs/usage)。

```bash
curl $BASE/v1/balance \
  -H "Authorization: Bearer $MOMO_API_KEY"
```

```json
{
  "object": "balance",
  "balance": "12.50",
  "currency": "CNY",
  "scope": "tenant"
}
```

子账户 Key 的 `scope` 是 `sub_account`，金额是该子账户额度。

## 3. 跑一轮对话

从目录里挑一个对话模型。先非流式，再 `stream: true`。

```bash
curl https://tokenmei.com/v1/chat/completions \
  -H "Authorization: Bearer $MOMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_CHAT_MODEL",
    "messages": [{"role": "user", "content": "你好"}]
  }'
```

```javascript
const chat = await client.chat.completions.create({
  model: "YOUR_CHAT_MODEL",
  messages: [{ role: "user", content: "你好" }],
});
console.log(chat.choices[0].message.content);
```

```python
chat = client.chat.completions.create(
    model="YOUR_CHAT_MODEL",
    messages=[{"role": "user", "content": "你好"}],
)
print(chat.choices[0].message.content)
```

```go
chat, _ := client.Chat.Completions.New(context.TODO(), openai.ChatCompletionNewParams{
	Model: "YOUR_CHAT_MODEL",
	Messages: []openai.ChatCompletionMessageParamUnion{
		openai.UserMessage("你好"),
	},
})
fmt.Println(chat.Choices[0].Message.Content)
```

```php
$chat = $client->chat()->create([
    "model" => "YOUR_CHAT_MODEL",
    "messages" => [["role" => "user", "content" => "你好"]],
]);
echo $chat->choices[0]->message->content;
```

```java
ChatCompletion chat = client.chat().completions().create(
    ChatCompletionCreateParams.builder()
        .model("YOUR_CHAT_MODEL")
        .addUserMessage("你好")
        .build()
);
System.out.println(chat.choices().get(0).message().content());
```

```csharp
var chat = client.GetChatClient("YOUR_CHAT_MODEL").CompleteChat("你好");
Console.WriteLine(chat.Content[0].Text);
```

## 4. 生图 / 视频

生图用 `response_format: "url"`，保存返回的稳定地址。视频：`POST /v1/videos` 拿到 `id` 后轮询 `GET /v1/tasks/{id}`，直到 `completed` 再取 `url`（默认是平台稳定地址；个别关闭转存的模型可能直出上游地址）。异步生图同样用这条查询。完整字段见[生图](/docs/images)、[生视频](/docs/videos)、[任务查询](/docs/tasks)。

> **模型 id 以平台为准**
>
> 同一底层能力对外可能叫完全不同的 id。以 `GET /v1/models` 返回的 id 为准；未出现在该目录中的名称不可调用。

下一步看 [SDK 对照](/docs/sdk)，确认各路径与字段是否支持。
