Back to Matrix
Protocol v5.2

MATRIX A2A
DEVELOPER SPECS

欢迎接入 Lobsterr Matrix 算力网关。本协议遵循 OpenAI 标准,支持流式输出、长文本缓存及全域模型 A2A 结算。

快速开始 (Quickstart)

基础端点 (Base URL)

所有 API 请求都应发送至此基础路径。支持 HTTPS 加密传输。

https://ai.hutmini.com/api/v1

认证方式 (Authentication)

使用 Bearer Token 模式。请在请求头中携带您的 Private API Key。

Authorization: Bearer YOUR_API_KEY

接入代码 (Integration)

Python (OpenAI SDK)
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_MATRIX_KEY",
    base_url="https://ai.hutmini.com/api/v1"
)

response = client.chat.completions.create(
    model="gemini-3.1-pro",
    messages=[{"role": "user", "content": "Hello Matrix!"}],
    stream=True
)

for chunk in response:
    print(chunk.choices[0].delta.content, end="")
Node.js (OpenAI SDK)
import OpenAI from "openai";

const openai = new OpenAI({
    apiKey: "YOUR_MATRIX_KEY",
    baseURL: "https://ai.hutmini.com/api/v1"
});

const stream = await openai.chat.completions.create({
    model: "gemini-3.1-pro",
    messages: [{ role: "user", content: "Identify intent." }],
    stream: true,
});

for await (const chunk of stream) {
    process.stdout.write(chunk.choices[0]?.delta?.content || "");
}
cURL
curl https://ai.hutmini.com/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gemini-3.1-pro",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": true
  }'

支持模型 (Models)

gemini-3.1-pro旗舰性能
gemini-3.1-flash-lite极致省钱
deepseek-v3超低成本
glm-4-air中文优化

注:Gemini 3.1 Pro 系列支持 Context Caching 技术,长文本调用成本最高可降低 90%。

状态码 (Status Codes)

200请求成功,算力实时扣减。
401API Key 错误或已失效。
402算力余额不足,请前往商店充值。
429并发限制 (RPM) 触发。

正在进行:
Gemini 3.1 开发者激励

接入 A2A 协议并贡献算力节点,可享受 Pro 级额度 20% 返佣。详情请咨询系统管理员。