Models and Channels zh CN

模型与渠道

English · 返回首页

每个渠道独立保存模型、API 地址、凭据、工具模式、流式设置、超时、重试、Headers、Body、上下文阈值和 Token 计数方式。已创建渠道可以在四种类型之间转换；通用字段会保留，类型专属字段会采用新类型的默认值。

渠道类型

类型	适用场景	主要能力
Gemini	Google Gemini API 与兼容服务	原生 Function Calling、多模态、思考等级或预算、历史图片限制
OpenAI Compatible	OpenAI Chat Completions、DeepSeek、中转或自建兼容网关	常见采样参数、Reasoning 参数、自定义 Headers/Body、兼容性强
OpenAI Responses	/v1/responses 风格接口	Responses 工具调用、input 内容、Responses Token 计数
Anthropic	Claude API	tool_use、扩展思考、Prompt Caching、count_tokens

工具模式

• function_call：使用渠道原生工具调用，优先选择。
• xml：把工具说明注入为 XML，适合原生调用不稳定或不支持工具的模型。
• json：把工具说明以 JSON 结构注入，适合更擅长结构化文本的模型。

如果模型不调用工具、参数经常损坏或中转站不完整支持原生格式，可依次尝试 xml 或 json。工具是否可用还会受到 设置 → 工具、Prompt 模式工具策略和自动执行规则影响。

常用配置

• 连接：API URL、API Key、模型列表。
• 生成：temperature、输出 Token 上限、top_p 等渠道支持的参数。
• 思考：reasoning effort、summary、思考预算或等级；可用项随渠道和模型变化。
• 可靠性：请求超时、重试次数和间隔、是否优先流式输出。
• 兼容：自定义 Headers 与 Body；仅为可信服务添加必要字段。
• 上下文：模型上下文阈值、自动裁剪或总结策略、多模态历史上限。

Token 计数

可使用渠道默认计数、Gemini countTokens、OpenAI 格式计数接口、OpenAI Responses、Anthropic count_tokens 或本地估算。远端计数更接近供应商实际账单，但会增加请求；本地估算响应更快，但可能存在偏差。

选择建议

• 官方 API 优先使用对应原生渠道。
• 中转站或自建网关通常使用 OpenAI Compatible，并根据服务文档调整 URL、Headers 和 Body。
• 需要 Responses 原生输入或工具语义时使用 OpenAI Responses。
• 长上下文任务应同时关注上下文阈值、自动总结、缓存策略和附件大小。

API Key 属于敏感凭据。只在 GrayCode 渠道设置中填写，不要提交到仓库、粘贴到 Issue，或通过对话发送给模型。