AGIOne Docs

简体中文

English

简体中文

English

Appearance

AGIOne 普通用户指南 ​

本指南面向首次使用 AGIOne 的用户编写。指南将带您完成以下基本工作流程：登录、领取免费配额、在 Web 体验中心试用模型，以及使用 curl 调用模型。用户名、密码和 API 密钥仅作为占位符展示。

适用角色 ​

  • 体验和调用模型的平台用户
  • 查看对应客户调用记录的模型提供方

1. 准备工作 ​

使用 AGIOne 前，请准备以下信息。

项目示例或说明
平台 URLhttps://agione.cc/
用户名{USERNAME}
密码{PASSWORD}
模型 API 密钥{API_KEY}，从快速入门页面复制

本指南以 Qwen3.5-27b 为示例。模型可用性以及供应商实例调用标识符可能因环境而变化。

项目值
模型名称Qwen3.5-27b
模型标识符{MODEL_IDENTIFIER}
协议openai/chat_completions
API 端点https://agione.cc/hyperone/xapi/api/v1/chat/completions

供应商实例调用标识符可能因环境、供应方或区域而变化。调用前请从当前环境的供应商卡片或快速入门面板复制标识符。

2. 登录 AGIOne ​

2.1 打开登录页面 ​

在浏览器中输入以下地址：

https://agione.cc/user/login

将看到 AGIOne 登录页面。

登录页面

2.2 填写登录表单 ​

按以下顺序填写表单。

步骤操作值
1在"用户名或邮箱"中输入用户名{USERNAME}
2在"密码"中输入密码{PASSWORD}
3勾选用户协议复选框勾选
4点击"登录"等待平台打开

如果弹出隐私政策或服务条款对话框，请点击"同意"。

2.3 确认登录成功 ​

登录成功后，页面右上角应显示用户头像或首字母。左侧菜单应显示"发现"、"体验中心"、"用量与收益"和"我的调用"等条目。

3. 打开模型列表 ​

3.1 进入模型服务 ​

登录后，打开：

https://agione.cc/modelone/store/model

也可以通过页面菜单导航：

模型服务 > 发现 > 模型

3.2 找到 Qwen3.5-27b ​

在模型列表中搜索Qwen3.5-27b。当前列表按"最新"排序，不要依赖模型在列表中的固定位置；找到后，点击该模型行的"查看"。

模型列表中的 Qwen3.5-27b

4. 领取免费配额 ​

免费配额入口位于模型详情页的供应商卡片上，紧邻"体验中心"按钮。

4.1 打开模型详情页 ​

打开Qwen3.5-27b详情页后，确认可以看到以下信息。

检查项预期值
模型名称Qwen3.5-27b
模型 IDqwen/qwen3.5-27b
供应商卡片调用标识符{MODEL_IDENTIFIER}
配额按钮领取免费配额
试用入口体验中心

模型详情页上的免费配额入口

4.2 点击领取 ​

在供应商卡片上点击：

领取免费配额

配额领取成功后，页面显示成功提示，按钮变为：

已领取

免费配额领取成功

4.3 确认配额已领取 ​

以下任一迹象表示配额已成功领取：

成功标志说明
页面显示"领取成功"平台已完成领取
按钮变为"已领取"当前账户已领取该模型的免费配额
重新打开模型详情页仍显示"已领取"领取状态已保存

5. 在 Web 体验中心试用模型 ​

Web 体验中心是试用模型最简单的方式，无需编写代码。

5.1 从详情页打开体验中心 ​

在Qwen3.5-27b模型详情页上，点击供应商卡片上的以下按钮：

体验中心

也可以从左侧菜单打开：

体验中心 > 文本对话

如果从左侧菜单打开，需手动选择目标模型。如果从模型详情页打开，当前模型通常已预选。

文本体验中心页面

5.2 发送测试消息 ​

进入文本体验中心页面后，按以下步骤操作。

步骤操作推荐值
1确认"模型子类型"LLM
2确认或选择模型Qwen3.5-27b 的供应商模型
3确认"协议"openai/chat_completions
4按需调整参数初学者可保持默认值
5在底部输入框输入问题请用一句话介绍 AGIOne。
6点击发送按钮等待模型响应

如果对话区域出现生成的响应，说明体验中心调用成功。

5.3 按模型模态选择体验中心 ​

模型详情中的能力和输入/输出模态决定应使用哪个体验入口。不要用文本模型的参数验证图像、视频或语音模型。

模态菜单路径验证重点
文本 / 对话体验中心 > 文本对话Prompt、Temperature、Top-P、Max Tokens、回答和延迟
图像 / 多模态体验中心 > 图像生成已授权图片、提示词、尺寸、数量、输出图片和请求 ID
视频体验中心 > 视频生成已授权短视频、抽帧、最大时长、结果和异步耗时
语音 / 音频体验中心 > 语音生成音频格式、采样率、语言、音色、文本或音频结果

体验图像模型时，选择可体验的图像或多模态模型，上传脱敏且已授权的素材，设置提示词和尺寸后发送请求。

选择图像体验模型

体验视频模型时，先使用短时长的脱敏素材验证抽帧、输出格式和异步结果，再逐步扩大输入。

配置视频体验参数

体验语音模型时，确认输入格式、语言和输出类型；不要上传包含客户隐私的原始录音。

选择语音体验模型

6. 使用 curl 调用模型 ​

当需要从命令行、脚本或后端服务调用模型时，可使用 curl。

6.1 打开快速入门页面 ​

返回模型详情页，点击：

快速入门

在快速入门页面上可以找到以下信息。

信息用途
模型 ID 调用标识符供应商实例对应的 model 字段值
Base URLAPI 服务基础地址
Path拼接到 Base URL 后的协议路径
完整 URL完整的 curl 请求地址
模型 API 密钥在 AUTHENTICATION 区域选择的认证密钥
curl 示例可直接使用的参考命令

截图中的 API 密钥已脱敏。实际使用时，请从页面复制您自己的 API 密钥。

快速入门 curl 示例

6.2 复制 API 密钥 ​

在"AUTHENTICATION"部分找到Model API Keys，选择已授权的密钥后点击"复制"。

请注意：

注意说明
不要与他人共享 API 密钥API 密钥可用于调用您账户下的模型
不要将其提交到公共文档或代码仓库尽可能将其存储为环境变量
本指南使用 {API_KEY}调用 API 时请替换为您的真实密钥

6.3 curl 示例 ​

将 {API_KEY} 和 {MODEL_IDENTIFIER} 替换为从当前环境复制的值，然后在终端中运行命令。

bash
curl -X POST "https://agione.cc/hyperone/xapi/api/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {API_KEY}" \
  -d '{
    "stream": true,
    "model": "{MODEL_IDENTIFIER}",
    "messages": [
      {
        "role": "user",
        "content": "Hello"
      }
    ]
  }'

6.4 确认 API 调用成功 ​

调用成功时，终端会返回生成的模型输出。成功的常见标志包括：

检查项成功标志
响应内容响应包含生成的文本
模型字段响应包含当前环境显示的模型标识符
无认证错误未出现 Unauthorized 或 Invalid API key 错误
无配额错误未出现配额不足消息

6.5 快速实践 ​

访问 AGIOne 最佳实践。

7. 查看调用记录 ​

如需确认模型是否实际被调用，可查看调用日志。

7.1 打开调用日志 ​

从左侧打开以下菜单：

我的调用 > 调用日志

7.2 筛选调用记录 ​

步骤操作
1选择调用时间范围
2输入模型名称或模型 ID
3选择调用状态（如成功或失败）
4点击"搜索"
5在列表中查看调用时间、模型、状态、Token 使用量和延迟
6如需查看更多信息，点击目标行的"详情"

8. 常见问题 ​

8.1 登录失败怎么办？ ​

可能原因解决方法
用户名或密码错误确认 {USERNAME} 和 {PASSWORD}
用户协议复选框未勾选勾选复选框后重新登录
服务协议弹窗未确认点击"同意"

8.2 找不到 Qwen3.5-27b 怎么办？ ​

解决方法说明
在模型列表中搜索"Qwen3.5-27b"使用搜索框快速定位
确保查看"全部模型"避免仅筛选私人模型
更改排序或翻页浏览模型可能不在第一屏可见范围内

8.3 领取按钮无法点击怎么办？ ​

页面状态说明
按钮显示"已领取"当前账户已领取
没有"领取免费配额"按钮模型可能不支持免费配额，或账户没有权限
点击后无反应刷新页面后重试，或确认是否仍保持登录

8.4 curl 调用失败怎么办？ ​

错误现象检查项
认证失败检查 API 密钥是否完整，Header 是否为 Authorization: Bearer {API_KEY}
模型未找到检查 model 是否与从当前环境复制的供应商卡片调用标识符一致
请求 URL 错误检查 URL 是否为 https://agione.cc/hyperone/xapi/api/v1/chat/completions
JSON 格式错误检查引号、逗号和花括号
配额不足确认是否已领取免费配额，或检查账户配额

9. 快速参考 ​

功能入口
登录https://agione.cc/user/login
模型列表https://agione.cc/modelone/store/model
Qwen3.5-27b 详情页模型服务 > 发现 > 模型 > Qwen3.5-27b > 查看
领取免费配额Qwen3.5-27b 详情页供应商卡片 > 领取免费配额
Web 体验中心Qwen3.5-27b 详情页供应商卡片 > 体验中心
API 接入说明Qwen3.5-27b 详情页 > 快速入门
调用日志我的调用 > 调用日志

完成检查 ​

用途： 以下检查是当前功能任务的退出条件，用于判断操作结果是否可观察、可复核，以及是否可以继续当前场景的下一步。它不是操作步骤的重复；任一项不满足时，请按下方“常见失败分支”继续排查。

检查项通过标准
1登录成功，并能找到目标模型。
2免费配额或其他已授权配额可用。
3体验中心请求和 API 请求都返回有效结果。
4调用日志能定位对应模型和成功状态。

常见失败分支 ​

现象优先检查
找不到目标模型模型发布状态、公有/私有范围、账号授权和模型市场筛选条件
体验调用成功但 API 请求失败Personal Key、接口地址、请求头、协议、模型标识和限流
请求成功但调用日志没有记录账号与项目范围、时间范围、模型筛选条件和数据处理延迟

操作手册 ​