AGENT / CONNECT
文档公开可读;实际调用需要 API 密钥,并按钱包余额计费。先选择 MCP 或 REST API,再用只读请求验证接通。
三种入口共用同一份模型目录和账务能力。先选你正在使用的工具,不需要一次性看完所有配置。
密钥管理和完整控制台需要登录;文档和接入说明可以直接读取。
MCP 先调用 get_user_info 和list_models;REST API 先读取模型目录。
# MCP:让 Agent 先执行只读工具
get_user_info
list_models
# REST API:GET /openapi/v2/models
# 将 AI_HIVE_API_BASE 设为你所在环境的 API 根地址
curl "$AI_HIVE_API_BASE/openapi/v2/models?modelType=TEXT&limit=20" \
-H "Authorization: Bearer $AI_HIVE_API_KEY"读取和预检不产生正式生成费用;只有带计费动作的正式调用才按当前模型价格扣费。价格以接口返回为准。
| 工具 | 用途 | 费用 | 前置条件 |
|---|---|---|---|
| get_user_info | 查看账户和余额 | 免费读取 | 已连接账户 |
| list_models | 筛选可用模型,取得 publicModelId | 免费读取 | 无 |
| get_model | 读取 routingModes、参数、媒体要求和 pricingSnapshot | 免费读取 | publicModelId |
| chat_text | 同步调用文本模型 | 正式调用计费 | 模型 + 参数 |
| submit_chat_text | 提交持久文本任务,立即返回 taskId | 正式调用计费 | 模型 + 参数;宿主可能超时或断线恢复 |
| get_chat_text_task | 按 taskId 查询文本任务状态和结果 | 免费读取 | taskId |
| list_recent_chat_text_tasks | 找回当前账号近期文本任务摘要 | 免费读取 | 无 |
| generate_image | 预检或生成图片 | dryRun 免费,正式调用计费 | 模型 + 参数;素材要求以详情为准 |
| generate_video | 预检或生成视频 | dryRun 免费,正式调用计费 | 模型 + 参数;素材要求以详情为准 |
| get_generation_task | 查询生成进度和结果 | 免费读取 | taskId |
pricingSnapshot发起调用。clientRequestId和相同业务参数;修正参数、余额或素材后使用新的标识。dryRun: true检查参数、素材和费用。预检不保证内容审核通过,也不创建任务。