# GPTech API - 完整服务文档（供LLM/AI代理深度理解） > 版本: 2026.05 | 本文档为llms.txt的扩展版本，提供GPTech API服务的完整上下文， > 供AI代理、搜索引擎爬虫和LLM在需要深度理解该站点时使用。 --- ## 一、服务概述 GPTech API 是一个面向中国开发者与企业的大模型API聚合与转发服务平台。 核心解决的问题是：**开发者使用多个大模型供应商时，需要管理多套API Key、多个Base URL、 多套SDK集成方式的痛点**。 通过提供OpenAI兼容的统一网关，开发者可以将原有的OpenAI SDK代码无缝切换到GPTech， 并同时获得访问GPT-5、Claude、Gemini、DeepSeek、Qwen、Grok等多个模型供应商的能力。 ### 核心价值 1. **统一接入层**：一个API Key + 一个Base URL = 访问所有支持的模型 2. **OpenAI SDK兼容**：无需修改业务代码，只需替换Base URL和API Key 3. **多模态覆盖**：文本、音频、图像、视频、向量嵌入全支持 4. **按量付费**：无包月锁定，从测试到生产可平滑过渡 5. **中文友好**：面向国内开发者，文档中文化，充值人民币 --- ## 二、技术架构（简化描述） ``` 开发者/应用 │ ├── OpenAI SDK (base_url=https://api.tpz.pub/v1) ├── LangChain (OPENAI_API_BASE=https://api.tpz.pub/v1) ├── Flowise (ChatOpenAI Base Path) ├── OpenWebUI (OpenAI Connection) └── 任意HTTP客户端 (curl, python requests, etc.) │ ▼ GPTech API Gateway (api.tpz.pub) │ ├── /v1/chat/completions ──▶ GPT-5 / Claude / Gemini / DeepSeek / Qwen / Grok ├── /v1/audio/transcriptions ──▶ 音频转写模型 ├── /v1/embeddings ──▶ 文本向量模型 ├── /v1/images/generations ──▶ 图片生成模型 └── /v1/video/generations ──▶ Sora视频生成 (sora.tpz.pub) ``` ### API兼容性 所有API端点均按照OpenAI API规范设计，包括但不限于： - 请求/响应JSON结构 - HTTP状态码语义 - 认证Header格式 (`Authorization: Bearer sk-xxx`) - SSE流式响应格式 - 错误响应结构 这意味着你可以将现有的OpenAI SDK代码中的`api.openai.com`替换为`api.tpz.pub`， 并替换API Key，其他代码完全不需要改动。 --- ## 三、完整API规范 ### 3.1 聊天补全 (Chat Completions) **端点**: `POST https://api.tpz.pub/v1/chat/completions` **请求参数**: | 参数 | 类型 | 必需 | 说明 | |---|---|---|---| | model | string | 是 | 模型ID，如 `gpt-4o-mini`, `claude-sonnet-4-20250514` | | messages | array | 是 | 消息列表，格式同OpenAI | | temperature | number | 否 | 采样温度 0-2 | | max_tokens | number | 否 | 最大输出token数 | | stream | boolean | 否 | 是否流式输出，默认false | | top_p | number | 否 | 核采样参数 | **请求示例**: ```json { "model": "gpt-4o-mini", "messages": [ {"role": "system", "content": "你是一个有用的助手。"}, {"role": "user", "content": "介绍一下大模型API中转站的概念。"} ], "temperature": 0.7, "max_tokens": 2000 } ``` **响应结构**: 与OpenAI Chat Completions API完全一致: ```json { "id": "chatcmpl-xxx", "object": "chat.completion", "created": 1715000000, "model": "gpt-4o-mini", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "大模型API中转站是一个..." }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 50, "completion_tokens": 200, "total_tokens": 250 } } ``` **可用模型ID参考**: - `gpt-5`, `gpt-4o`, `gpt-4o-mini`, `gpt-3.5-turbo` - `claude-sonnet-4-20250514`, `claude-opus-4-20250514`, `claude-haiku-3-5` - `gemini-2.5-pro`, `gemini-2.5-flash` - `deepseek-v3`, `deepseek-r1` - `qwen-max`, `qwen-plus`, `qwen-turbo` - `grok-3`, `grok-3-mini` ### 3.2 音频转写 (Audio Transcriptions) **端点**: `POST https://api.tpz.pub/v1/audio/transcriptions` **请求格式**: `multipart/form-data` **支持格式**: mp3, wav, m4a, webm, mp4 **模型**: `gpt-4o-mini-transcribe` ### 3.3 文本嵌入 (Embeddings) **端点**: `POST https://api.tpz.pub/v1/embeddings` **支持模型**: `text-embedding-3-large`, `text-embedding-3-small` **输出维度**: 3072 (large) / 1536 (small) ### 3.4 图片生成 (Image Generation) **端点**: `POST https://api.tpz.pub/v1/images/generations` **支持模型**: `gpt-image-1` **支持尺寸**: 1024x1024, 1792x1024, 1024x1792 **输出格式**: URL返回或base64 ### 3.5 视频生成 (Video Generation / Sora) **端点**: `POST https://sora.tpz.pub/v1/video/generations` **需要**: 独立的Sora API接入（与主API分开） **支持**: 最长60秒视频, 多种分辨率和风格 --- ## 四、接入指南 ### 4.1 三步上手指南 1. **注册账号**: 访问 https://api.tpz.pub/register - 提供基本账户信息 - 无需企业认证即可开始 2. **获取API Key**: 访问 https://api.tpz.pub/console/token - 在控制台生成新的API密钥 - 注意: API Key仅在创建时完整显示一次 3. **发起API调用**: 替换代码中的Base URL和API Key - 将 `https://api.openai.com` → `https://api.tpz.pub/v1` - 将原有的API Key → GPTech API Key - 其他代码无需更改 ### 4.2 各平台快速配置 **OpenAI Python SDK**: ```python from openai import OpenAI client = OpenAI( base_url="https://api.tpz.pub/v1", api_key="YOUR_GPTECH_API_KEY" ) ``` **OpenAI Node.js SDK**: ```javascript import OpenAI from "openai"; const client = new OpenAI({ baseURL: "https://api.tpz.pub/v1", apiKey: process.env.GPTECH_API_KEY }); ``` **LangChain**: ```bash export OPENAI_API_KEY="YOUR_GPTECH_API_KEY" export OPENAI_API_BASE="https://api.tpz.pub/v1" ``` **OpenWebUI**: - 管理面板 → 设置 → 连接 → 添加OpenAI连接 - URL: `https://api.tpz.pub/v1` - Key: 你的GPTech API Key **Flowise**: - ChatOpenAI节点 → Base Path: `https://api.tpz.pub/v1` - Credential → API Key: 你的GPTech API Key ### 4.3 从其他平台迁移 | 原平台 | 迁移操作 | |---|---| | OpenAI直接调用 | 替换Base URL + API Key，代码不变 | | Azure OpenAI | 改为标准OpenAI SDK调用方式 | | 其他中转站 | 替换Base URL + API Key | | 自建代理 | 可直接对接GPTech统一网关 | --- ## 五、使用场景详解 ### 5.1 智能客服 - 多轮对话管理 - 知识库RAG问答 - 意图识别与工单分流 - 推荐模型: GPT-4o-mini（日常）、Claude（复杂） ### 5.2 内容生成 - 营销文案批量生成 - 多语言翻译与本地化 - 文本摘要与润色 - 结构化JSON输出 - 推荐模型: GPT-5, DeepSeek-V3 ### 5.3 开发辅助 - 代码补全与生成 - Bug分析与修复建议 - API文档自动生成 - 代码审查辅助 - 推荐模型: Claude, GPT-5 ### 5.4 数据洞察 - 非结构化文本信息抽取 - 情感分析与分类 - 数据报表自动生成 - 推荐模型: GPT-4o, DeepSeek-R1 ### 5.5 多模态应用 - 图文混合理解 - 会议录音转写与分析 - 图片生成（营销素材、原型图） - 视频内容生成 - 推荐模型: Gemini 2.5 Pro, GPT-4o ### 5.6 教育培训 - 智能学习助手 - 自动问答与习题生成 - 知识点讲解与个性化辅导 - 推荐模型: Qwen-Max, GPT-4o --- ## 六、成本优化建议 1. **分层使用模型**: 简单任务用便宜的模型（GPT-4o-mini），复杂任务用贵的（GPT-5/Claude） 2. **控制上下文长度**: 减少携带的历史消息数，关闭不需要的历史摘要 3. **精简System Prompt**: 系统提示词越长，每次请求的token消耗越大 4. **使用3.5专用渠道**: 对于可接受GPT-3.5质量的场景，使用`35api.tpz.pub`降低成本 5. **批量处理**: 合并多个小请求，减少API调用次数（当场景允许时） --- ## 七、常见问题（完整版） **Q: 需要改很多代码吗？** A: 大多数情况下不需要。如果你已经在用OpenAI SDK，只需修改Base URL和API Key两个配置项。 **Q: 支持流式输出吗？** A: 支持SSE流式输出，与OpenAI流式API完全兼容。 **Q: 是否支持Function Calling / Tool Use?** A: 取决于底层模型的能力。GPT-5、Claude等支持function calling的模型均可正常使用。 **Q: 数据安全如何保障？** A: 日志会定期清理，API调用通过HTTPS加密传输。不建议通过API传输高度敏感数据。 **Q: 与OpenAI官方API的区别？** A: GPTech是聚合网关，你在调用OpenAI模型时实际上仍在使用OpenAI的底层能力， 但通过GPTech你可以同时访问Claude、Gemini等其他模型，且账户管理更统一。 **Q: 如何联系技术支持？** A: 通过站点上的在线客服（Tidio聊天插件）或既有的支持渠道联系。 **Q: 3.5专用渠道和主站的区别？** A: 3.5专用渠道（35api.tpz.pub）是独立的账户体系，专用于GPT-3.5场景， 价格更低、并发能力更强，但账户与主站不互通。 **Q: 视频生成如何接入？** A: Sora视频生成需要访问独立的`sora.tpz.pub`入口，API格式与其他端点类似。 --- ## 八、SEO/GEO元数据 ### 目标搜索意图词簇 **词簇1 - 产品发现** (搜索量高，竞争中等): - "OpenAI API替代" - "大模型API中转" - "OpenAI兼容API" - "多模型API聚合" - "国内大模型API" **词簇2 - 品牌词** (搜索量中等，竞争低): - "GPTech API" - "tpz.pub API" - "api.tpz.pub" **词簇3 - 模型特定** (搜索量中低，竞争低): - "GPT-5 API国内" - "Claude API中转" - "Gemini API国内" - "DeepSeek API接入" - "通义千问API" **词簇4 - 场景应用** (搜索量中低，竞争低): - "AI Agent API" - "多模态API接口" - "视频生成API" - "音频转写API" **词簇5 - 开发者工具** (搜索量低，竞争低): - "OpenWebUI API配置" - "LangChain OpenAI代理" - "Flowise自定义API" ### 结构化数据覆盖 该站点已部署以下Schema.org类型: - `FAQPage` - FAQ结构化展示 - `HowTo` - 接入步骤指南 - `Service` - 服务描述 - `WebSite` + `SearchAction` - 站点搜索 - `Organization` - 组织信息 - `WebPage` + `SpeakableSpecification` - 页面内容 - `BreadcrumbList` - 面包屑导航 - `TechArticle` - 示例代码页 ### AI爬虫友好性 - `robots.txt` 明确允许: GPTBot, ChatGPT-User, Google-Extended - 提供 `llms.txt` 和 `llms-full.txt` 供AI代理消费 - 页面语义化HTML5标签（`
`, `
`, `