API Reference — Manyfold

三分钟完成接入

使用托管 API origin，创建带 scope 的 token，然后发送 OpenAI 兼容请求；model 字段填写 Manyfold agent id。

Base URL: https://api.manyfold.ai/api/v1
认证: Authorization: Bearer
推荐 scope: chat.completions

创建或选择一个 Agent，并复制它的 agt_ id。
在 Settings -> API tokens 创建 API token。
调用 /chat/completions，并带上 Authorization: Bearer $MF_API_TOKEN。

Endpoints

公开 v1 API 保持很小：创建 Agent turn，列出 API 创建的会话，并回放消息。

POST /api/v1/chat/completions

创建 chat completion

通过 OpenAI 兼容的 Chat Completions 形状向 Manyfold Agent 发起一个 turn。

GET /api/v1/conversations

列出会话

列出通过 OpenAI 兼容 v1 API 创建的非渠道会话。

GET /api/v1/conversations/{session_id}/messages

列出会话消息

回放某个 API 会话里的消息，包含文本和完整 Manyfold content blocks。

错误格式

错误使用 OpenAI 风格 envelope，方便兼容客户端统一处理认证和参数校验失败。

{
    "error": {
        "message": "API token does not have chat.completions scope",
        "type": "authentication_error",
        "code": "invalid_api_key"
    }
}

完整 Chat 指南 · Conversation 指南