开发文档 ✳

01. 认识猫猫动力

猫猫动力 致力于为常见 AI 模型提供统一接入体验。你可以使用熟悉的 OpenAI 兼容请求格式，根据控制台提供的实际可用模型 ID 发起调用。

02. 快速开始

完成三个简单步骤，即可从本地脚本或应用中发送第一条请求。

03. API 地址与鉴权

在客户端的 base_url（或 baseURL）中使用以下地址；你的 API Key 将放在 Bearer 鉴权头中。

04. 发出第一条请求

选择你最熟悉的语言，复制代码，并将 YOUR_API_KEY 和 YOUR_MODEL_ID 换成控制台实际提供的值。

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://maomao.chat/v1"
)

response = client.chat.completions.create(
    model="YOUR_MODEL_ID",
    messages=[{"role": "user", "content": "你好，猫猫！"}]
)
print(response.choices[0].message.content)

Python 环境可先安装依赖：pip install openai。Node.js 环境可安装：npm install openai。

05. 常用 API 接口

常见的 OpenAI 兼容路径如下，具体哪些接口可调用，取决于你所选模型、渠道和站点配置。

06. 流式输出

希望回答能够逐字显示？在兼容 Chat Completions 的请求中设置 stream: true，服务端通常会用 SSE 增量传输结果。

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://maomao.chat/v1"
)

stream = client.chat.completions.create(
    model="YOUR_MODEL_ID",
    messages=[{"role": "user", "content": "介绍一下你自己"}],
    stream=True
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

07. 在常见工具中使用

对于允许设置自定义 OpenAI 兼容服务端的客户端，一般可参考以下配置方式。

08. 用量与计费

模型计费可能因提供方、型号、输入输出 Token、渠道倍率等不同而变化。具体价格和余额以当前站点实际展示为准。

09. 常见错误排查

不同部署和渠道返回格式可能不同。调试时优先保留请求时间、请求 ID（若有）、模型名以及脱敏后的错误消息，**不要**公开 API Key。