# Tikway API 接入示例：Python、Node.js SSE 与 Token 费用估算

[English](README.en.md) · [官网](https://tikway.ai/?utm_source=github&utm_medium=referral&utm_campaign=examples&utm_content=readme) · [模型与价格](https://tikway.ai/models) · [完整教程](https://tikway.ai/guides)

用一个最小请求开始，再处理流式输出和费用：本仓库提供 Python 标准库调用、Node.js 原生 fetch / SSE 解析，以及无需联网的 Token 费用估算脚本。无需安装第三方代码依赖。

Tikway 是独立第三方模型 API 接入服务，按使用量计费；模型、参数和协议支持范围以[模型目录](https://tikway.ai/models)为准。

## 从你要解决的问题开始

| 要做什么 | 可直接运行的文件 | 配套说明 |
| --- | --- | --- |
| 发出第一条文本请求 | [python/chat.py](python/chat.py) | [Python / OpenAI 兼容 Chat Completions](https://tikway.ai/guides/python-tikway-openai-compatible-chat-completions?utm_source=github&utm_medium=referral&utm_campaign=examples&utm_content=python) |
| 逐段读取回答，处理中文与断流 | [node/stream.mjs](node/stream.mjs) | [Node.js fetch 与 SSE](https://tikway.ai/guides/nodejs-tikway-fetch-sse-streaming?utm_source=github&utm_medium=referral&utm_campaign=examples&utm_content=node) |
| 按输入、输出用量估算批量预算 | [python/token_cost.py](python/token_cost.py) | [在线费用计算器](https://tikway.ai/tools/token-cost?utm_source=github&utm_medium=referral&utm_campaign=examples&utm_content=calculator) |
| 排查 401、404、模型 ID、流式中断 | [排错清单](docs/troubleshooting.md) | [模型 ID 与费用核对](https://tikway.ai/guides/model-id-and-billing-verification) |

## 首次调用

需要 Python 3.10+ 或 Node.js 20+。在 [Tikway 控制台](https://tikway.ai/dashboard/keys)创建自己的 Key，从目录复制支持 OpenAI Chat Completions 的完整模型 ID。Node 示例还要求该模型支持流式输出。

Windows PowerShell：

```powershell
$env:TIKWAY_API_KEY = 'your-tikway-key'
$env:TIKWAY_MODEL = 'copy-the-full-model-id-from-the-catalog'
python python/chat.py
# 或运行流式示例：
node node/stream.mjs
```

macOS / Linux：

```bash
export TIKWAY_API_KEY='your-tikway-key'
export TIKWAY_MODEL='copy-the-full-model-id-from-the-catalog'
python3 python/chat.py
# 或运行流式示例：
node node/stream.mjs
```

上面的模型标识是占位符，应替换后运行。未设置 `TIKWAY_MODEL` 时，脚本示例值为 `openai/gpt-5.4-mini`，可用性与价格仍需以当前目录为准。

完整请求地址是 `https://api.tikway.ai/v1/chat/completions`；如果改用 SDK，其 base URL 是 `https://api.tikway.ai/v1`。不要将官网业务接口 `/api` 或完整请求路径填进 SDK 的 base URL。查看 [SDK base_url 配置教程](https://tikway.ai/guides/openai-sdk-tikway-integration)。

运行调用示例会发送真实模型请求并按适用规则计费。脚本不自动重试；根据报错确认地址、权限、型号和余额后再重试。

## Node.js SSE 示例处理了什么

- UTF-8 字符跨网络分块，包括中文。
- LF、CRLF、CR 换行与被拆开的 CRLF。
- 多行 `data:`、注释和心跳。
- 流内错误和缺少 `[DONE]` 的提前断流。
- 单个事件大小限制与读取器清理。

示例读取 Chat Completions 的文本增量；不把它当作 Anthropic、Gemini、Responses API 或工具调用的通用解析器。

## 免费、离线估算 Token 费用

```bash
python python/token_cost.py --input-tokens 1000 --output-tokens 500 --input-price 1 --output-price 4 --price-unit-tokens 1000000 --requests 100
```

此处价格 `1`、`4` 只是演示数据，使用前请替换为当前模型的价格，并确保输入、输出价格使用同一货币和 Token 单位。示例输出单次 `0.003`、100 次 `0.3`，不产生 API 请求；不包含缓存、图片、视频等其他计费项。

## 离线验证

```bash
python -m unittest discover -s tests -v
node --test node/stream.test.mjs
```

测试用模拟响应核对请求格式、错误脱敏、计费公式、中文分块、断流与流内错误，不读取真实密钥、不调用生产模型。它们不能证明某个型号的实时可用性或底层模型来源。

## Agent 与自动化教程

[Dify 自定义模型配置](https://tikway.ai/guides/dify-tikway-agent-setup) · [n8n AI Agent 配置](https://tikway.ai/guides/n8n-tikway-ai-agent-setup) · [LangChain 工具调用](https://tikway.ai/guides/langchain-tikway-agent-setup)

以上是配置教程；本仓库首版未提供完成运行验证的 n8n / Dify 导出文件。逐项确认模型工具能力、节点版本和运行记录后再扩展工作流。

## 反馈与许可

欢迎提交最小复现和脱敏错误信息；不要在 Issue 中发送 API Key 或个人请求内容。示例代码采用 [MIT License](LICENSE)。