MoonApiX Docs

Appearance

聊天与 Responses ​

聊天与 Responses 是文本系列中最常用的两个入口。已有 OpenAI-compatible 客户端时，通常先使用 POST /v1/chat/completions；需要 Responses 格式、多模态输入或工具调用风格时，使用 POST /v1/responses。Claude 兼容客户端可使用 POST /v1/messages。

Chat Completions ​

http
POST /v1/chat/completions
bash
curl https://moonapix.com/v1/chat/completions \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "moonapix-chat",
    "messages": [
      {
        "role": "system",
        "content": "你是一个简洁的开发者助手。"
      },
      {
        "role": "user",
        "content": "写一句 API 接入成功后的欢迎语。"
      }
    ]
  }'

Responses ​

http
POST /v1/responses
POST /v1/responses/compact
bash
curl https://moonapix.com/v1/responses \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "moonapix-chat",
    "input": "请把这句话改写得更适合开发者文档：接入以后就可以用了。"
  }'

长对话需要压缩上下文时，使用 POST /v1/responses/compact，并选择支持上下文压缩的模型。

Messages ​

http
POST /v1/messages
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 的用途。"
      }
    ]
  }'

常用字段 ​

字段适用接口说明
model全部模型名。
messagesChat Completions、Messages多轮对话消息。
inputResponses文本或结构化输入。
max_tokensMessages 等限制生成长度。
stream支持流式的接口设置为 true 时使用 SSE 返回。

选择建议 ​

需求建议
兼容常见聊天客户端使用 /v1/chat/completions。
使用 Responses 格式使用 /v1/responses。
使用 Claude 兼容请求体使用 /v1/messages。
需要流式输出确认客户端支持 SSE，并设置 stream: true。

相关页面 ​