协议与 SDK 支持

先在模型目录查看模型的 protocols、能力、流式支持和费率，再用当前凭据调用 GET /v1/models 确认可用模型。两份目录用途不同：GET /api/v1/public/models 提供公开能力详情；/v1/models 返回 OpenAI 兼容的 object 与 data，模型条目包含 id、object、created、owned_by，不返回 protocols。模型名称不能代替协议声明。

数据 API 使用 AICredits 签发的 API Key，或 Embedded 短期令牌。第三方模型服务的密钥不能用于平台鉴权。官方 SDK 统一使用 Bearer；兼容 SDK 可按下表传递同一平台凭据。

protocols 值	公开接口	兼容 SDK / 鉴权
openai_chat_completions	POST /v1/chat/completions	OpenAI SDK；Bearer
openai_responses	POST /v1/responses	OpenAI SDK；Bearer
openai_embeddings	POST /v1/embeddings	OpenAI SDK；Bearer
openai_images	POST /v1/images/generations	OpenAI SDK；Bearer
anthropic_messages	POST /v1/messages	Anthropic SDK；x-api-key 或 Bearer
gemini	POST /v1beta/models/{model}:generateContent	Gemini SDK；x-goog-api-key 或 Bearer
videos	POST /v1/videos/generations	HTTP / 官方网关 SDK；Bearer

Gemini 的 ?key= 仅在 /v1beta 下受支持；优先使用 Header，避免凭据进入 URL 日志。SDK 徽章表示协议兼容，不表示第三方认可，也不承诺各模型参数、工具调用或输出行为完全一致。

多模型协议兼容

• OpenAI 与 Claude：除各自的常见请求形态外，平台提供 OpenAI 模型的 Messages 兼容，以及 Claude 的 Chat Completions / Responses 兼容。仅使用公开目录中声明的协议。
• Gemini：支持原生生成、流式、Token 计数及模型查询，也提供 Messages / Chat 兼容路径。原生示例见 Gemini 接入。
• Grok：支持 Chat、Responses、Messages 兼容，以及已配置模型的图片与视频生成。
• DeepSeek、Kimi、MiniMax：已实现 Chat / Messages / Responses 兼容路径，按公开目录选择已开放型号。
• 智谱 GLM：已实现 Chat / Messages，当前未实现 Responses 路径。

中国大模型接入指南 提供四个系列的选模示例、推理参数、多轮工具调用和流式处理说明。官方 SDK 的 listPublicModels 返回公开协议与费率；结合 listModels 确认当前凭据可用的精确模型 ID。

平台支持的接口还需要当前套餐权益、已启用模型和对应费率。调用时的授权检查是最终依据，目录结果不是可用性保证。

Token 计数与模型查询

能力	公开接口	使用说明
Messages Token 计数	POST /v1/messages/count_tokens	支持已启用的 OpenAI、Grok 和 Claude 路径；Grok 使用本地估算，不能用计数结果代替最终计费明细
Gemini 模型目录	GET /v1beta/models、GET /v1beta/models/{model}	返回当前有权使用且可调用的 Gemini 模型
Gemini Token 计数	POST /v1beta/models/{model}:countTokens	使用 Gemini 原生请求形态；计数能力仍受权限与模型配置约束

Token 计数不会执行模型生成；实际生成后的用量和费用以平台记录为准。示例见快速接入。

SDK 与功能边界

官方 SDK 0.3.0 提供 TypeScript、Swift 和 Kotlin 网关封装，以及 Embedded 余额、交易记录、购买与工单接口。TypeScript 支持 Chat、Responses、Messages 和 Gemini 的 SSE；Swift/Kotlin 当前提供非流式 JSON 调用。

• Responses HTTP 请求不支持 previous_response_id；多轮会话需显式携带上下文。WebSocket / Realtime 不属于当前 SDK 范围。
• 图片接口接收 JSON 生成请求，不支持 multipart 编辑和流式图片事件。
• 视频编辑、状态查询、内容下载、异步轮询与延迟结算尚未提供；不能把待处理响应当成已完成作品或最终费用。
• Ollama Cloud 仍在开发中。订阅 OAuth 不属于公开可用能力。

流式结束事件随协议不同，详见流式与取消。