DEVELOPER DOCUMENTATION
连接模型，构建你的 AI 应用。
从第一次 API 调用到云端 Agent：完整的模型接口、SDK、流式响应、工具调用、文件资源和用量管理指南。
一个入口，三种主流协议
Base URLs
OpenAI-compatible https://api.token4ai.cloud/v1
Anthropic https://api.token4ai.cloud
Gemini REST https://api.token4ai.cloud/v1beta/models/{model}:generateContent先通过当前密钥查询模型目录，再选择适合目标协议与任务的模型。模型能力、权限和价格以当前分组为准。
开始接入
模型 API
模型目录与能力选择查询当前密钥可见模型，理解模型 ID、供应商协议、上下文与能力限制。Chat Completions：对话生成使用 OpenAI 兼容对话接口，配置消息、多轮上下文、输出和流式响应。Responses：生成与多轮状态接入 Responses API，理解 input、stream、store、previous_response_id 与响应读取删除。Anthropic Messages 与 Token 预估配置 Anthropic 原生请求、system、内容块、流式输出和 count_tokens。Gemini 原生内容生成使用 generateContent 和 streamGenerateContent，正确构造 contents、parts 与 generationConfig。流式响应与连接管理实现 SSE 解析、取消、超时与断流恢复，避免重复生成和错误的完成状态。工具调用与结构化输出构建工具调用回合、校验函数参数，并用 JSON Schema 约束可验证的模型输出。Embedding 与 Rerank 检索使用向量嵌入和文档重排构建 RAG，理解维度、输入、排名和模型能力要求。视觉输入与图像生成区分图像理解与生成，使用 image_url 内容块和 images/generations 接口。音频转写、翻译与语音合成接入 audio/transcriptions、audio/translations 和 audio/speech，正确处理 multipart 与二进制音频。Files API 与文件生命周期上传、列举、读取、下载与删除文件，并区分 Files API、静态资源和模型输入。错误码、429 与重试策略区分鉴权、参数、模型、限流与上游错误，结合 request ID 制定有限重试策略。
Agent 与协作
控制台与支持
面向统一 Token 用量管理的 AI 应用与 Agent Cloud 工作流，Token4AI Cloud 提供从模型调用到任务执行的完整接入路径。