Evose

API 概览

REST 风格 · JSON · 认证 · 版本 · SDK

Evose API 是外部系统调用 Evose的入口。让你把 Agent / Workflow / 知识库嵌进自家系统。

设计原则

  • REST:资源 / 动词清晰
  • JSON:请求体 + 响应体均 JSON
  • HTTPS 强制:所有请求 TLS
  • 幂等:同一请求体多次提交结果一致（写操作支持 Idempotency-Key)
  • 版本化:URL 中含主版本（/v1/...)
  • 可观测:每个响应含 request_id,便于排查

Base URL

环境URL
SaaShttps://api.evose.ai/v1
私有化https://<your-domain>/api/v1

资源端点

资源端点根
Workspace/v1/workspaces
Agent/v1/agents
Workflow/v1/workflows
知识库/v1/knowledge-bases
模型/v1/models
Webhooks/v1/webhooks

一个最小例子

curl -X POST https://api.evose.ai/v1/agents/agent-12345/chat \
  -H "Authorization: Bearer evk_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "你好",
    "user_id": "u-001",
    "stream": false
  }'

响应:

{
  "request_id": "req-abc123",
  "agent_id": "agent-12345",
  "conversation_id": "conv-xyz",
  "message": {
    "role": "assistant",
    "content": "你好,有什么可以帮你的?"
  },
  "usage": {
    "tokens_in": 8,
    "tokens_out": 12,
    "credits": 0.001
  }
}

SDK(规划)

语言状态
Node / TypeScript 即将发布
Python 即将发布
Go 路线图
Java 路线图

当前阶段建议直接 HTTPS 调用。

接下来

下一页

认证

页面导航