应用程序编程接口

五分钟内完成完整的 Model Gate API 参考。

应用程序编程接口

Model Gate公开两个兼容的推理接口:

  • 人择POST /v1/messages 适用于 Anthropic SDK、Claude Code 和兼容客户端。
  • 开放人工智能POST /v1/chat/completions 适用于 OpenAI SDK 和兼容客户端。

mg_live_... 键在两种模式下均有效。路由和计费由 Model Gate 处理。

基本网址

https://api.model-gate.com

OpenAI兼容的客户端通常使用 https://api.model-gate.com/v1

快速启动

卷曲:人为

curl https://api.model-gate.com/v1/messages \
  -H "x-api-key: mg_live_..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-opus-4.8","max_tokens":1024,"messages":[{"role":"user","content":"Hello"}]}'

卷曲:OpenAI

curl https://api.model-gate.com/v1/chat/completions \
  -H "Authorization: Bearer mg_live_..." \
  -H "content-type: application/json" \
  -d '{"model":"claude-opus-4.8","messages":[{"role":"user","content":"Hello"}]}'

Python:OpenAI SDK

from openai import OpenAI
client = OpenAI(api_key="mg_live_...", base_url="https://api.model-gate.com/v1")
response = client.chat.completions.create(model="claude-opus-4.8", messages=[{"role":"user","content":"Hello"}])
print(response.choices[0].message.content)

Python:人择 SDK

from anthropic import Anthropic
client = Anthropic(api_key="mg_live_...", base_url="https://api.model-gate.com")
response = client.messages.create(model="claude-opus-4.8", max_tokens=1024, messages=[{"role":"user","content":"Hello"}])
print(response.content[0].text)

支持的功能

当所选模型支持时,流式传输、提示缓存、视觉、工具使用/函数调用、扩展思维和大上下文模型都会被传递。

限制

可以为每个帐户和每个密钥配置 RPM 和并发性。密钥还具有可重置的支出使用计数器和生命周期 total_spent 柜台。超过速率限制返回 429Retry-After

后续步骤