88API88API
User GuideAI ApplicationsAPI ReferenceHelp & Support
API Module Guide

Public Information Module

Feature Description

The API prefix is https://88api.ai

Provides public information accessible without login or by regular users, including model lists, pricing details, announcement content, etc.

🔐 Authentication Not Required

Get Announcement Content

  • Interface Name: Get Announcement Content
  • HTTP Method: GET
  • Path: /api/notice
  • Authentication Requirement: Public
  • Function Summary: Retrieves system announcement content, supporting Markdown format

💡 Request Example:

const response = await fetch('/api/notice', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json'
  }
});
const data = await response.json();

✅ Successful Response Example:

{
  "success": true,
  "message": "",
  "data": "# 系统公告\n\n欢迎使用88API系统!"
}

❗ Failure Response Example:

{
  "success": false,
  "message": "获取公告失败"
}

🧾 Field Description:

data (String): Announcement content, supporting Markdown format

About Page Information

  • Interface Name: About Page Information
  • HTTP Method: GET
  • Path: /api/about
  • Authentication Requirement: Public
  • Function Summary: Retrieves custom content for the About page

💡 Request Example:

const response = await fetch('/api/about', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json'
  }
});
const data = await response.json();

✅ Successful Response Example:

{
  "success": true,
  "message": "",
  "data": "# 关于我们\n\n88API 是面向开发者与企业的 AI 模型接口聚合平台..."
}

❗ Failure Response Example:

{
  "success": false,
  "message": "获取关于信息失败"
}

🧾 Field Description:

data (String): About page content, supporting Markdown format or URL link

Homepage Custom Content

  • Interface Name: Homepage Custom Content
  • HTTP Method: GET
  • Path: /api/home_page_content
  • Authentication Requirement: Public
  • Function Summary: Retrieves custom content for the homepage, which can be Markdown text or an iframe URL

💡 Request Example:

const response = await fetch('/api/home_page_content', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json'
  }
});
const data = await response.json();

✅ Successful Response Example:

{
  "success": true,
  "message": "",
  "data": "# 欢迎使用88API\n\n一个 API Key 调用多家模型..."
}

❗ Failure Response Example:

{
  "success": false,
  "message": "获取首页内容失败"
}

🧾 Field Description:

data (String): Homepage content, which can be Markdown text or a URL link starting with "https://"

Model Ratio Configuration

  • Interface Name: Model Ratio Configuration
  • HTTP Method: GET
  • Path: /api/ratio_config
  • Authentication Requirement: Public
  • Function Summary: Retrieves public model ratio configuration information

💡 Request Example:

const response = await fetch('/api/ratio_config', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json'
  }
});
const data = await response.json();

✅ Successful Response Example:

{
  "success": true,
  "data": {
    "model_ratio": {
      "gpt-5.5": 1.0,
      "claude-sonnet-5-5": 1.5,
      "gemini-3.5-flash": 0.15
    },
    "completion_ratio": {
      "gpt-5.5": 8.0,
      "claude-sonnet-5-5": 5.0
    },
    "model_price": {
      "deepseek-v4-flash": 0.002
    }
  }
}

❗ Failure Response Example:

{
  "success": false,
  "message": "获取倍率配置失败"
}

🧾 Field Description:

data (Object): Ratio configuration information

  • model_ratio (Object): Model ratio mapping, where the key is the model name and the value is the ratio numerical value
  • completion_ratio (Object): Completion ratio mapping
  • model_price (Object): Model price mapping, where the key is the model name and the value is the price (USD)

Pricing and Plan Information

  • Interface Name: Pricing and Plan Information
  • HTTP Method: GET
  • Path: /api/pricing
  • Authentication Requirement: Anonymous/User
  • Function Summary: Retrieves model pricing information, group ratios, and available groups

💡 Request Example:

const response = await fetch('/api/pricing', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_token', // Optional, logged-in users get more detailed information
    'New-Api-User': 'your_user_id' // Optional
  }
});
const data = await response.json();

✅ Successful Response Example:

{
  "success": true,
  "data": [
    {
      "model_name": "gpt-5.5",
      "enable_group": ["default", "vip"],
      "model_ratio": 1.0,
      "completion_ratio": 1.0,
      "model_price": 0.002,
      "quota_type": 1,
      "description": "GPT-5.5 模型",
      "vendor_id": 1,
      "supported_endpoint_types": [1, 2]
    }
  ],
  "vendors": [
    {
      "id": 1,
      "name": "OpenAI",
      "description": "OpenAI官方模型",
      "icon": "openai.png"
    }
  ],
  "group_ratio": {
    "default": 1.0,
    "vip": 0.8
  },
  "usable_group": {
    "default": "默认分组",
    "vip": "VIP分组"
  },
  "supported_endpoint": {
    "1": {"method": "POST", "path": "/v1/chat/completions"},
    "2": {"method": "POST", "path": "/v1/responses"}
  },
  "auto_groups": ["default"]
}

❗ Failure Response Example:

{
  "success": false,
  "message": "获取定价信息失败"
}

🧾 Field Description:

  • data (Array): List of model pricing information

    • model_name (String): Model name
    • enable_group (Array): Available groups list
    • model_ratio (Number): Model ratio
    • completion_ratio (Number): Completion ratio
    • model_price (Number): Model price (USD)
    • quota_type (Number): Billing type, 0=Ratio billing, 1=Price billing
    • description (String): Model description
    • vendor_id (Number): Vendor ID
    • supported_endpoint_types (Array): Supported endpoint types
  • vendors (Array): List of vendor information

    • id (Number): Vendor ID
    • name (String): Vendor name
    • description (String): Vendor description
    • icon (String): Vendor icon
  • group_ratio (Object): Group ratio mapping

  • usable_group (Object): Usable group mapping

  • supported_endpoint (Object): Supported endpoint information

  • auto_groups (Array): Automatic group list

🔐 User Authentication Required

Get Available Model List

  • Interface Name: Get Available Model List
  • HTTP Method: GET
  • Path: /api/models
  • Authentication Requirement: User
  • Function Summary: Retrieves the list of AI models accessible to the current user, which can be used for display on a page

💡 Request Example:

const response = await fetch('/api/models', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ Successful Response Example:

{
  "success": true,
  "data": {
    "1": ["gpt-5.5", "deepseek-v4-flash"],
    "14": ["claude-sonnet-5-5"],
    "24": ["gemini-3.5-flash"]
  }
}

❗ Failure Response Example:

{
  "success": false,
  "message": "未授权访问"
}

🧾 Field Description:

data (Object): Available models grouped by type

  • Key (String): Internal type number; clients can ignore it
  • Value (Array): List of available model names