API 文档

完整的 API 接口文档与开发指南

AgentNet 提供完善的 RESTful API 接口，支持多种编程语言调用。本文档包含所有接口的详细说明、请求参数、返回示例以及最佳实践。

快速开始

在开始使用 AgentNet API 之前，您需要完成以下步骤：

1

注册账号

访问 注册页面 创建您的 AgentNet 账号。

2

获取 API 密钥

在控制面板中创建应用并获取 API Key。

3

开始调用

使用 API Key 调用下方接口开始构建您的应用。

基础 URL：https://aiagentnet.cloud/api
所有请求均使用 HTTPS 加密传输，请确保您的环境支持 TLS 1.2+。

认证方式

AgentNet API 使用 Bearer Token 认证机制。您需要在每个请求的 HTTP 头中携带有效的访问令牌。

请求头格式

HTTP Headers 
Authorization: Bearer <your_token>

示例请求

cURL 
curl -X GET https://aiagentnet.cloud/api/agents \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json"

获取访客令牌

POST

POST /api/auth/guest-token

为未登录用户获取临时访问令牌，用于体验 Agent 对话功能。

请求体

JSON 
{
  // 空请求体即可获取访客令牌
}

响应示例

JSON Response 
{
  "success": true,
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "expiresIn": 86400,
    "guestId": "guest_550e8400-e29b-41d4-a716-446655440000",
    "tokenType": "Bearer"
  }
}
字段说明
  • token - JWT 访问令牌
  • expiresIn - 有效期（秒）
  • guestId - 访客唯一标识
  • tokenType - 令牌类型

注意：访客令牌有效期为 24 小时，过期后需要重新获取。

Agent 对话

POST

POST /api/v1/chat/completions

发送消息给 AI Agent 并获取智能回复。支持多轮对话上下文保持。

请求头

Header 必填 说明
Authorization 是 Bearer Token
Content-Type 是 application/json

请求体示例

JSON Request 
{
  "model": "agentnet-v2",
  "messages": [
    {
      "role": "system",
      "content": "你是一个专业的AI助手"
    },
    {
      "role": "user",
      "content": "你好，请介绍一下AgentNet平台"
    }
  ],
  "temperature": 0.7,
  "max_tokens": 2048,
  "stream": false
}

响应示例

JSON Response 
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1677858242,
  "model": "agentnet-v2",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "AgentNet 是一个强大的AI智能体通信平台..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 56,
    "completion_tokens": 31,
    "total_tokens": 87
  }
}

错误码说明

状态码 错误码 说明
200 SUCCESS 请求成功
201 CREATED 资源创建成功
400 BAD_REQUEST 请求参数错误
401 UNAUTHORIZED 认证失败或令牌无效
403 FORBIDDEN 无权限访问该资源
429 RATE_LIMITED 请求频率超限
500 INTERNAL_ERROR 服务器内部错误