Skip to content

API 文档浏览

功能概述

API 文档浏览器是无量AI开放平台控制台内置的接口文档查阅工具,提供完整的 API 参考信息。通过三栏布局,您可以高效地浏览和查阅所有 API 接口的详细文档,包括:

  • 接口总览和分类浏览
  • 完整的接口参数说明
  • 请求体和响应体的数据结构
  • 各接口的错误码定义
  • 全局错误码参考

前提条件

  • 已登录控制台

操作步骤

进入 API 文档浏览器

  1. 在左侧导航栏中,点击 资源 分组下的 API 文档 菜单。

    进入API文档

  2. 进入 API 文档浏览器页面,页面采用三栏布局。

    API文档页面布局

了解页面布局

API 文档浏览器采用三栏布局,各栏功能如下:

左栏 - 接口树

以树形结构展示所有 API 接口,按能力类型分组:

  • 文本生成
  • 图像生成
  • 向量嵌入
  • 语音合成
  • 语音识别
  • Web 搜索

点击分组节点可展开/收起该分组下的接口列表。

接口树结构

右上方栏 - 功能标签页

提供以下标签页:

标签页说明
总览展示所有 API 能力的概要摘要
错误码展示全局错误码列表,按 HTTP 状态码分类
接口详情展示选中接口的完整文档(选中接口后自动切换到此标签)

功能标签页

右下方栏 - 文档内容

根据当前选中的标签页和接口,展示对应的文档内容。

文档内容区

浏览 API 总览

  1. 页面默认展示 总览 标签页,汇总展示所有 API 能力的概要信息。

    API总览页面

  2. 总览页面以卡片形式展示各能力类型,包括接口数量、核心功能说明等。

    能力概要卡片

查看全局错误码

  1. 点击 错误码 标签页。

    切换到错误码标签

  2. 错误码按 HTTP 状态码分类展示:

    HTTP 状态码含义
    400请求参数错误
    401认证失败(API Key 无效或缺失)
    403权限不足(Key 无对应能力或模型权限)
    429请求频率超限
    500服务端内部错误

    全局错误码列表

  3. 每个错误码条目包含以下信息:

    • 错误码:具体的错误代码
    • 错误信息:错误描述
    • 说明:错误原因和可能的解决方案

    错误码详情

查看接口详细文档

  1. 在左侧接口树中,展开目标分组,点击具体的接口名称。

    在接口树中选择接口

  2. 右侧自动切换到 接口详情 标签,展示该接口的完整文档。

    接口详情页面

  3. 接口详情包含以下内容板块:

    接口基本信息

    • 接口名称和描述
    • 请求方法(POST / GET)
    • 请求路径(如 /v1/chat/completions

    接口基本信息

    请求参数

    以表格形式列出所有请求参数,包含:

    字段说明
    参数名参数的路径和名称
    类型参数的数据类型(string, integer, boolean, array, object)
    必填是否为必填参数
    默认值参数的默认值(如有)
    说明参数的详细描述和取值范围

    请求参数表

    请求体结构

    展示请求体的 JSON 数据结构,包括嵌套对象的字段说明。

    请求体结构

    响应体结构

    展示成功响应的 JSON 数据结构和字段说明。

    响应体结构

    接口错误码

    展示该接口特有的错误码列表,包含错误代码、错误信息和解决建议。

    接口错误码

注意事项

  • API 文档浏览器中的内容与平台实际的 API 行为保持同步,如发现不一致请及时反馈。
  • 接口文档中的示例数据仅作参考,实际响应内容取决于模型和参数配置。
  • 部分接口可能处于 Beta 或预览状态,其参数和行为可能在未来版本中发生变化。
  • 建议结合 Playground 工具进行实际测试,以更好地理解接口行为。

相关文档