概述
- api.4tk.ai 提供聊天与多协议 API 网关：OpenAI Chat、OpenAI Embeddings、OpenAI Audio Speech、OpenAI Responses、Anthropic Messages 与 Gemini generateContent / streamGenerateContent。
- image.4tk.ai 提供 OpenAI Images 专站（
generations/edits）；鉴权与扣费仍走 4tk.ai 主站，子令牌与控制台一致。 - 实际可用的模型与协议，取决于你的账户权限、当前模型是否已上架、以及子令牌所属的 tokenGroup。
- 生产环境请始终通过 HTTPS 调用，不要把子令牌暴露在前端公开代码或仓库中。
调用链路怎么理解
- 你先登录控制台并创建子令牌。
- 聊天类请求使用子令牌调用 api.4tk.ai；生图类请求使用同一子令牌调用 image.4tk.ai。
- 网关按模型和线路配置路由到具体上游（image 专站会在调上游前向主站预检 authorize，成功后 settle 扣费）。
- 成功或失败请求都会记录日志、耗时、状态码和必要计费信息。
路径总览
- OpenAI Chat：
POST https://api.4tk.ai/v1/chat/completions - OpenAI Images 生成：
POST https://image.4tk.ai/v1/images/generations - OpenAI Images 编辑：
POST https://image.4tk.ai/v1/images/edits - OpenAI Embeddings：
POST https://api.4tk.ai/v1/embeddings - OpenAI Audio Speech：
POST https://api.4tk.ai/v1/audio/speech - OpenAI Responses：
POST https://api.4tk.ai/v1/responses - Anthropic Messages：
POST https://api.4tk.ai/v1/messages - Gemini：
POST https://api.4tk.ai/v1beta/models/{model}:generateContent - Gemini 流式：
POST https://api.4tk.ai/v1beta/models/{model}:streamGenerateContent?alt=sse
https://api.4tk.ai/v1/images/*仍保留兼容，新接入请优先 image.4tk.ai。
计费与流式行为
- 账单以控制台中的模型定价为准。
- 流式请求通常会先预扣，再按最终 usage 结算；不同协议使用的 usage 来源字段不同。
- Embeddings 当前只支持非流式；Speech 成功时返回音频二进制而不是 JSON。
gpt-image-2这类图片模型请走 image.4tk.ai 的 OpenAI Images 路由，而不是 Chat Completions。- 如果你接的是 Responses 或 Gemini 流式，建议优先验证下游客户端是否完整消费了 SSE 完成事件，否则会影响最终 usage 回收。
接下来读什么
- 如果你在接聊天或通用 OpenAI 兼容客户端：看 OpenAI Chat 或 Responses
- 如果你在做向量检索或多模态嵌入：看 OpenAI Embeddings
- 如果你在做文生图、参考图编辑或局部重绘：看 OpenAI Images
- 如果你在做 TTS 或音频播报：看 OpenAI Audio Speech
- 如果你接的是 Claude 原生协议：看 Anthropic Messages
- 如果你在用 OpenClaw：看 OpenClaw（优先安装 4TK provider 插件；
gpt-5.4推理可用 xhigh；memory 默认开、TTS 默认关；生图默认 image.4tk.ai） - 如果你在用 Hermes Agent：看 Hermes Agent（自定义端点走 Chat Completions；模型名与控制台一致）
- 如果你在接编码工具：直接跳 Codex、Cursor 或 Continue