1. 平台使用
Mote API
简体中文
  • 简体中文
  • english
  • 平台使用
    • 工作流程
    • 创建API Key
  • 手动安装
    • Codex 命令行
    • Codex 桌面端
    • Claude Code 命令行
    • Claude Code 桌面端
    • Gemini
  • API参考
    • 聊天（Chat）
      • 原生OpenAI格式
        • ChatCompletions格式
        • Responses格式
      • 原生Gemini格式
        • Gemini文本聊天
        • Gemini媒体识别
      • 原生Claude格式
    • 图像（Images）
      • 原生OpenAI格式
        • 生成图像
        • 编辑图像
      • 通义千问格式
        • 生成图像
        • 编辑图像
      • Nano Banana
        • Gemini原生格式
        • OpenAI聊天格式
    • 视频（Videos）
      • Sora格式
        • 创建视频
        • 获取视频任务状态
        • 获取视频内容
      • 可灵格式
        • Kling 文生视频
        • 获取 Kling 文生视频任务状态
        • Kling 图生视频
        • 获取 Kling 图生视频任务状态
      • 即梦格式
        • 即梦视频生成
      • 创建视频生成任务
      • 获取视频生成任务状态
    • 嵌入（Embeddings）
      • 原生OpenAI格式
      • 原生Gemini格式
    • 补全（Completions）
      • 原生OpenAI格式
    • 音频（Audio）
      • 原生OpenAI格式
        • 音频转录
        • 音频翻译
        • 文本转语音
      • 原生Gemini格式
    • 实时语音（Realtime）
      • 原生OpenAI格式
    • 重排序（Rerank）
      • 文档重排序
    • 模型（Models）
      • 列出模型
        • 原生OpenAI格式
        • 原生Gemini格式
    • 审查（Moderations）
      • 原生OpenAI格式
    • 未实现（Unimplemented）
      • 微调（Fine-tuning）
        • 列出微调任务 (未实现)
        • 创建微调任务 (未实现)
        • 获取微调任务详情 (未实现)
        • 取消微调任务 (未实现)
        • 获取微调任务事件 (未实现)
      • 文件（Files）
        • 列出文件 (未实现)
        • 上传文件 (未实现)
        • 获取文件信息 (未实现)
        • 删除文件 (未实现)
        • 获取文件内容 (未实现)
  • Schemas
    • Schemas
      • User
      • Log
      • Model
      • Token
      • Usage
      • PageInfo
      • Channel
      • Redemption
      • ApiResponse
      • ModelsResponse
      • ErrorResponse
      • Message
      • MessageContent
      • Tool
      • ToolCall
      • GeminiModelsResponse
      • ChatCompletionResponse
      • ChatCompletionRequest
      • ChatCompletionStreamResponse
      • CompletionRequest
      • CompletionResponse
      • ResponseFormat
      • ResponsesRequest
      • ResponsesResponse
      • ResponsesStreamResponse
      • ClaudeRequest
      • ClaudeMessage
      • ClaudeResponse
      • EmbeddingRequest
      • EmbeddingResponse
      • ImageGenerationRequest
      • ImageEditRequest
      • ImageResponse
      • AudioTranscriptionRequest
      • AudioTranslationRequest
      • AudioTranscriptionResponse
      • SpeechRequest
      • RerankRequest
      • RerankResponse
      • VideoRequest
      • ModerationRequest
      • VideoResponse
      • ModerationResponse
      • VideoTaskResponse
      • GeminiRequest
      • VideoTaskMetadata
      • VideoTaskError
      • GeminiResponse
      • OpenAIVideo
      • OpenAIVideoError
  1. 平台使用

工作流程

Mote API 如何工作#

Mote API 是面向开发者和小团队的多厂商 AI API Hub。它把模型接入、线路选择、预付费计费和请求可观测性整合到同一个服务层里。
你不需要让每个应用分别对接不同模型厂商。应用、SDK、CLI 工具或兼容 API 客户端只需要连接到 Mote API。Mote API 会完成 API Key 鉴权、选择已配置的线路、将请求转发到对应上游服务、记录用量元数据，并从你的预付费余额中扣除对应费用。
我们的目标很简单：
一个 Base URL。三档线路。更低的 AI API 成本。

Mote API 提供什么#

Mote API 将五个产品层整合到一个服务里：
1.
接入层 - 一个账号、一个控制台，以及用于 AI 流量的 API Key。
2.
路由层 - 面向 GPT、Claude、Gemini 以及其他模型厂商的 Lite、Core、Max 三档线路。
3.
计费层 - Stripe 预充值，以及请求级别的费用扣减。
4.
可观测层 - 用量日志、请求状态、token 统计、费用、延迟、模型、线路档位和 API Key 元数据。
5.
控制层 - 速率限制、余额不足拦截、API Key 管理、线路健康控制和运营安全措施。
Mote API 不是规避工具，也不是任何模型厂商的非官方背书。Mote API 是独立的网关服务，与 OpenAI、Anthropic、Google 或相关产品不存在从属或官方合作关系，除非另有明确说明。

请求流程#

每一次 API 调用都会经过类似的高层流程：

1. Configure#

创建账号，通过 Stripe 充值余额，并在控制台生成 API Key。
之后，你可以根据任务的重要程度选择不同线路：
Lite：适合成本敏感的测试、批量任务和高频调用。
Core：适合常规生产流量，在成本和可靠性之间取得默认平衡。
Max：适合关键任务、复杂工作流，以及稳定性优先的场景。

2. Connect#

将你的应用或工具指向 Mote API，并使用 Mote API Key。根据客户端不同，这可能意味着修改 Base URL、选择某个模型厂商线路，或使用对应的 SDK/CLI 配置。
Mote API 适配常见开发者工作流，包括：
API 客户端和自定义后端服务；
Codex CLI、Codex Desktop 等编码工具；
Gemini CLI 以及其他模型相关的命令行工作流；
在支持的情况下使用兼容厂商协议的 API 路由。

3. Monitor#

请求开始流转后，控制台会展示请求级别的元数据：
模型和线路档位；
使用的 API Key；
时间戳和请求状态；
可用情况下的 token 用量；
预估或最终费用；
延迟和失败信号；
剩余余额和余额变动记录。
Mote API 不存储你的 prompt 和模型 response。为了支持计费核对、问题排查和服务安全，Mote API 仅保留 30 天调用日志。日志包含模型、线路档位、请求状态、延迟、可用情况下的 token 用量、费用、API Key 标识和时间戳等运营元数据。

三档线路#

Mote API 使用线路档位，让团队在不频繁改动应用集成的前提下，根据成本、质量和业务重要性选择合适的调用路径。
档位定位适合场景价格说明
Lite成本优先线路测试、批量任务、高频调用、成本敏感用量部分 Lite 线路可低至约 官方价格的 12-14%，具体取决于模型族和线路可用性。
Core默认推荐线路日常生产流量、成本和可靠性平衡Core 线路用于在价格、可用性和实际稳定性之间取得默认平衡。
Max质量优先线路关键业务流程、复杂任务、稳定性敏感场景Max 线路优先保障线路质量和稳定性，在支持场景下仍低于官方价格。
价格会随厂商、模型、线路档位、上游可用性和流量条件变化。上表中的百分比用于说明部分线路的价格区间，当前价格详情以 Mote API 控制台展示为准。

为什么成本可以更低#

Mote API 可以提供更低成本的线路选项，是因为它按照任务类型拆分线路档位，而不是强制所有请求都走同一条高成本优质路径。
实际效果是：
Lite 线路 优先优化单位调用成本。
Core 线路 在更低综合成本下兼顾日常可靠性。
Max 线路 在失败成本更高的场景中优先保障质量和稳定性。
这种结构让团队可以把实验、自动化任务和批量流量放到更低成本线路上，同时让重要生产流程使用更强的线路。

稳定性和失败处理#

Mote API 不只是简单转发流量，还会围绕 AI API 流量提供运营控制能力。
Mote API 围绕以下运营控制设计：
API Key 鉴权和 key 级别控制；
在转发付费请求前进行余额检查；
速率限制和并发限制，用于保护容量；
线路健康监控和上游通道禁用；
失败率可见性，便于排障和人工处理；
在支持的线路上提供重试或 fallback 策略。
这遵循成熟 API Gateway 系统的通用原则：网关作为入口层，在请求到达后端服务之前负责流量管理、授权、监控和路由。

速度和接入体验#

我们的目标是让用户从创建账号到第一次成功调用控制在五分钟以内：
1.
注册或登录；
2.
添加预付费余额；
3.
创建 API Key；
4.
配置客户端或工具；
5.
发送第一条请求；
6.
在控制台确认用量和费用。
为了保持快速接入，Mote API 会让以下内容易于复制：
端点 / 路由配置；
API Key；
SDK 示例；
CLI 示例；
curl 示例；
常见错误解释。

模型和厂商覆盖#

Mote API 的定位是多厂商 Hub，而不是单一模型包装层。
Mote API 支持：
GPT 模型线路；
Claude 模型线路；
Gemini 模型线路；
其他兼容厂商和 API 路由。
重点不只是模型数量。更强的价值是：团队可以通过同一个运营界面管理模型接入、线路质量、计费和用量可见性。

计费和余额流水#

Mote API 使用预付费计费，让用户在生产流量增长前先控制预算。
计费行为包括：
通过 Stripe 处理充值；
余额会在 Stripe 支付事件确认后入账，而不是只依赖浏览器重定向；
每一笔余额变动都记录到余额流水；
每一次可计费请求都创建用量元数据；
余额不足时，在产生上游成本前拦截请求；
用户可以查看近期消费、模型用量和请求级别扣费。

安全和合规原则#

Mote API 是合法的 API 基础设施服务。我们不支持或宣传规避厂商规则、制裁限制、账号限制或访问控制的用法。
核心原则：
用户必须遵守适用法律和第三方厂商政策；
API Key 必须妥善保管，如发生泄露需要及时轮换；
高风险流量可以被限制、暂停或人工审核；
调用日志仅保留 30 天，且不包含 prompt 或模型 response；
Mote API 公开清晰的服务条款、隐私政策、余额规则和支持联系方式。

为什么开发者使用 Mote API#

更低成本#

Lite、Core、Max 三档线路让团队可以为不同工作负载选择合适的价格和质量，而不是让所有请求承担同一档线路成本。

更强控制#

预付费余额、API Key、用量日志和线路档位选择，让开发者知道系统正在使用什么、花费多少、在哪里产生费用。

更多模型覆盖#

GPT、Claude、Gemini 以及更多厂商线路可以通过一个控制台和一个服务关系来管理。

更快接入#

开发者可以从一个账号、一个 key 和少量客户端配置变更开始，而不必为每个厂商重复建设计费和监控逻辑。

实用可靠性#

线路健康、速率限制、失败可见性和管理控制，让网关比简单转发代理更适合生产工作流。

首次使用检查清单#

为新项目配置 Mote API 时，可以按以下步骤检查：
创建账号。
通过 Stripe 添加预付费余额。
创建项目专用 API Key。
选择默认线路档位：Lite、Core 或 Max。
配置应用、SDK 或 CLI 工具。
发送一条小规模测试请求。
确认请求出现在用量日志中。
确认余额扣减可见。
在可用时设置低余额提醒。
定期轮换 key，并禁用不再使用的 key。

常见问题#

Mote API 是官方厂商服务吗？#

不是。Mote API 是独立的 API Hub 和网关服务。除非另有明确的官方合作说明，否则 Mote API 不隶属于 OpenAI、Anthropic、Google 或其他模型厂商，也不代表其官方背书。

Lite 一定是最佳选择吗？#

不是。Lite 适合成本优先场景。Core 是大多数生产流量的默认推荐。Max 更适合关键工作流，因为这些场景下稳定性和线路质量比最低单位成本更重要。

价格总是官方价格的固定百分比吗？#

不是。线路价格会随模型族、厂商、线路档位、可用性和成本结构变化。Mote API 会展示部分线路价格区间，并在控制台提供当前价格详情。

Mote API 会存储 prompt 和 response 吗？#

不会。Mote API 不存储 prompt 或模型 response。Mote API 仅保留 30 天调用日志，方便用户核对计费、排查失败请求和了解用量情况。日志包含模型、线路档位、请求状态、延迟、可用情况下的 token 用量、费用、API Key 标识和时间戳等运营元数据。

如果余额不足会怎样？#

请求会在产生上游成本前被拦截。控制台会展示余额不足错误，并帮助用户在继续使用前完成充值。
Modified at 2026-07-13 07:20:01
Next
创建API Key
Built with