Public Runtime API

面向产品和外部平台的 AIP API 接入说明

P1Tech AIP 对外开放的接口能力以运行时消费为主：调用授权模型、执行 Skill/Capability、携带审计上下文、自动沉淀用量统计，并在需要时上报业务事件。Provider 密钥、模型管理、RBAC、预设包和平台治理配置仍由 AIP 控制台统一管理。

查看调用示例接口目录

Capabilities

对外能力范围

模型调用

通过 OpenAI 兼容接口调用 AIP ModelHub 授权模型，由 Gateway 统一完成模型路由、安全审计、用量记录和成本归集。

Chat CompletionsResponsesEmbeddingsModel catalog

Skill / Capability

通过 AIP-native Runtime API 获取已授权 Skill、Agent、Tool、Prompt、MCP 能力，并以统一 invocation 协议执行。

Skill invokeCapability invokeInput schemaGoverned execution

审计与归因

请求可携带产品、外部应用、终端用户、项目、会话和任务上下文，AIP 写入 GatewayRequest、AuditLog 与 RiskEvent。

Input auditRisk eventTrace chainContext headers

统计上报

模型和能力调用自动形成 UsageRecord；业务系统也可按治理契约上报关键事件，供 AIP 用量、成本和风险看板汇总。

Usage summaryRecent requestsCost rollupEvent ingest

申请 Runtime Token

由 AIP 管理员创建 API Key，并为外部应用或内部服务配置 callerType、应用标识、模型/能力策略、预算和速率限制。

读取可用配置

调用 Runtime Config 确认当前 token 可见的模型、Skill、Capability、审计等级、预算和配额状态。

发起模型或能力调用

根据调用场景选择 OpenAI 兼容模型接口，或使用 AIP-native Skill/Capability invoke 接口。

回看审计与用量

通过 usage 接口或 AIP 控制台查看 token、模型、外部应用、终端用户、会话和任务维度的消耗明细。

Endpoint Directory

接口目录

OpenAI 兼容模型 API

适合已有 OpenAI SDK、LangChain、Dify、插件系统或自研 Agent 框架的接入路径。

POST/api/v1/chat/completions

聊天补全，支持流式输出和 AIP 归因上下文。

POST/api/v1/responses

Responses wire format，适合 Codex/Agent runtime。

POST/api/v1/embeddings

文本向量能力，由 ModelHub 授权模型提供。

AIP Public Runtime API

适合需要读取授权目录、调用 Skill 或统一能力资产的内部产品与外部平台。

GET/api/aip/public/v1/me

查看 token 身份、callerType、externalAppId 和治理元数据。

GET/api/aip/public/v1/runtime-config

读取授权模型、Skill、Capability、审计等级、预算和配额。

GET/api/aip/public/v1/models

读取已授权模型目录，Provider 密钥永不返回。

GET/api/aip/public/v1/skills

读取已授权 Skill 目录和输入/输出 schema。

GET/api/aip/public/v1/capabilities

读取 Agent、Tool、Prompt、MCP、Skill 统一能力目录。

POST/api/aip/public/v1/skills/:id/invoke

执行指定 Skill，并纳入 Gateway 与审计治理。

POST/api/aip/public/v1/capabilities/:id/invoke

执行统一能力资产，支持 Agent/Tool/Prompt/MCP/Skill。

GET/api/aip/public/v1/usage

查看 token 用量摘要和最近 Gateway 请求。

审计与业务事件上报

适合内部产品或已授权集成方把关键业务动作回传 AIP，形成审计、风险和运营统计闭环。

POST/api/aip/events

上报产品事件，写入 AIP AuditLog/RiskEvent。

POST/api/aip/audit-ingest

兼容的审计事件上报别名。

GET/api/modelhub/metrics

平台侧模型用量、成本、延迟和 trace 汇总查询。

审计上下文 Header

Header 都是可选的稀疏字段。传得越完整，AIP 越能按外部应用、产品、终端用户、项目、会话、任务和能力资产维度统计成本、追踪审计链路。

AuthorizationBearer <aip-issued-runtime-token>

X-AIP-Caller-Typeexternal_app | internal_product

X-AIP-External-App-Id<external app id>

X-AIP-Product-Idp1 | aiscm | aim | aieco | external

X-AIP-End-User-Id<caller-side user id>

X-AIP-Project-Id<project or workspace id>

X-AIP-Session-Id<conversation or workflow session id>

X-AIP-Task-Id<task, job, or run id>

X-AIP-Capability-Id<skill, agent, tool, prompt, or mcp id>

X-AIP-Environment-Iddev | test | staging | prod | sandbox

安全与边界

Runtime Token 只能消费已授权模型、Skill 和 Capability，不能创建或修改 Provider、模型、RBAC、预设包或平台治理配置。

Provider 明文密钥和加密密文不会通过公共目录返回；模型目录仅暴露非敏感元数据和 hasSecret 状态。

Gateway 在 Provider 调用前执行文本输入安全审计，命中阻断规则时返回 content_filter 结果并记录风险事件。

统计记录由 AIP 自动沉淀，业务事件上报用于补齐模型调用之外的关键业务动作。

Examples

调用示例

模型调用：Chat Completions

curl https://{your-aip-domain}/api/v1/chat/completions \
  -H "Authorization: Bearer $AIP_RUNTIME_TOKEN" \
  -H "Content-Type: application/json" \
  -H "X-AIP-Caller-Type: external_app" \
  -H "X-AIP-External-App-Id: partner-crm" \
  -H "X-AIP-End-User-Id: user_123" \
  -d '{
    "model": "aip-default-chat",
    "messages": [
      { "role": "user", "content": "总结这段客户反馈，并给出跟进建议。" }
    ],
    "metadata": {
      "aipContext": {
        "projectId": "crm_workspace_01",
        "sessionId": "session_20260525_001",
        "taskId": "feedback_summary_001"
      }
    }
  }'

Skill 调用：AIP-native Runtime API

curl https://{your-aip-domain}/api/aip/public/v1/skills/skill_customer_summary/invoke \
  -H "Authorization: Bearer $AIP_RUNTIME_TOKEN" \
  -H "Content-Type: application/json" \
  -H "X-AIP-Caller-Type: external_app" \
  -H "X-AIP-External-App-Id: partner-crm" \
  -d '{
    "input": {
      "customerId": "C-10086",
      "notes": "客户关注交付周期、预算和数据安全。"
    },
    "context": {
      "endUserId": "user_123",
      "projectId": "crm_workspace_01",
      "sessionId": "session_20260525_001",
      "taskId": "customer_summary_001"
    }
  }'

业务事件上报：审计与统计

curl https://{your-aip-domain}/api/aip/events \
  -H "Authorization: Bearer $AIP_RUNTIME_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "productId": "external",
    "action": "customer.summary.generated",
    "resourceType": "customer",
    "resourceId": "C-10086",
    "result": "success",
    "metadata": {
      "externalAppId": "partner-crm",
      "endUserId": "user_123",
      "sessionId": "session_20260525_001",
      "taskId": "customer_summary_001"
    }
  }'