MoonApiX Docs

Appearance

Messages ​

Messages 接口适合 Claude 兼容请求体。它使用 messages 数组和 max_tokens 字段，便于接入支持自定义 Base URL 的 Claude 兼容客户端。

接口路径 ​

方法路径返回方式
POST/v1/messages同步 JSON 或 SSE 流式返回。

请求示例 ​

bash
curl https://moonapix.com/v1/messages \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "moonapix-claude",
    "max_tokens": 512,
    "messages": [
      {
        "role": "user",
        "content": "总结这个 API 的用途。"
      }
    ]
  }'

常用字段 ​

字段说明
modelClaude 兼容模型名。
messages对话消息数组。
max_tokens输出 token 上限。
temperature输出随机性。
stream是否使用流式返回。

响应处理 ​

场景处理方式
普通返回读取消息内容，并保存模型名和请求参数。
流式返回按客户端支持的增量格式拼接输出。
客户端报错优先检查 Base URL、模型名、鉴权和 max_tokens。

接入建议 ​

  • 已经使用 Claude 兼容客户端时优先选择此接口。
  • 如果客户端只支持 OpenAI Chat 格式，请改用 Chat Completions。
  • 请求失败时先检查 Base URL、模型名和 API Key 权限。

相关页面 ​