跳到主要内容
🔑 API Key 使用指南

OpenAI 兼容,一行代码接入

标准 OpenAI SDK 兼容。改 BASE_URL,不改代码逻辑。

第一步:获取 API Key

1
📝

注册账号

在 modelgrid.net 注册账号,只需邮箱即可。

2
🔑

创建 API Key

进入仪表盘 → API Keys → 创建新 Key,复制保存。

3
💰

充值

充值后即可使用。支持多种支付方式,按量计费。

第二步:写代码调用

标准 OpenAI SDK,只需改 BASE_URL 和 API Key,其他代码不变。

🐍 Python
from openai import OpenAI

client = OpenAI(
    base_url="http://localhost:9083/v1",
    api_key="mg_xxxxxxxx"
)

response = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "你好!"}]
)
print(response.choices[0].message.content)
📡 curl
curl http://localhost:9083/v1/chat/completions \
  -H "Authorization: Bearer mg_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "你好!"}]
  }'
🟢 Node.js
import OpenAI from "openai";

const client = new OpenAI({
    baseURL: "http://localhost:9083/v1",
    apiKey: "mg_xxxxxxxx"
});

const response = await client.chat.completions.create({
    model: "claude-sonnet-5",
    messages: [{ role: "user", content: "你好!" }]
});
console.log(response.choices[0].message.content);

认证方式

支持两种方式传递 API Key:

Bearer Token(推荐)

Authorization: Bearer mg_xxxxxxxx

X-API-Key Header

X-API-Key: mg_xxxxxxxx

API 端点

端点说明
POST /v1/chat/completionsChat Completions(OpenAI 兼容)
POST /v1/completionsText Completions
POST /v1/embeddings文本向量化
GET /v1/models获取可用模型列表

Base URL: http://localhost:9083

调用流程

💻你的代码OpenAI SDK
→
API/v1/chat
→
🔄relay转发
→
🧠modelgridAI清洗 & 路由
→
🖥Provider

准备好开始了吗?

注册即送免费额度,一行代码接入 modelgrid。