开发者教程

在代码中调用已发布的 Skill

发布 skill、创建 API Key，然后通过 REST endpoint 或官方 TypeScript SDK 调用。

发布 skill创建 API Key使用 API slug 或 skill id 调用

参数规则

Skill 变量使用 {{name}} 语法。调用时在 parameters 对象里传入同名字段。

认证方式

API Key 需要作为 Bearer token 传入。请放在服务端，不要暴露在浏览器代码中。

@hzhw/aivo

需要类型化 client helper 时，安装 @hzhw/aivo。

使用 REST API 调用

每个已发布 skill 都会提供稳定 endpoint，接收参数和可选的模型 ID。

curl -X POST 'https://your-aivo-app.com/api/skills/blog-title-generator/execute' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <YOUR_API_KEY>' \
  -d '{
    "parameters": {
      "topic": "TypeScript SDKs",
      "audience": "startup founders"
    },
    "model": "<MODEL_ID>"
  }'

使用 TypeScript SDK 调用

SDK 会在本地校验必填参数，并让不同应用中的请求处理保持一致。

import { AivoClient } from '@hzhw/aivo';

const client = new AivoClient({
  apiKey: process.env.AIVO_API_KEY!,
  baseUrl: 'https://your-aivo-app.com',
});

const response = await client.executeSkill('blog-title-generator', {
  topic: 'TypeScript SDKs',
  audience: 'startup founders',
});

console.log(response.result);

响应格式

API 和 SDK 都会返回生成结果、模型、耗时、用量和积分消耗信息。

{
  "success": true,
  "data": {
    "result": "<AI generated content>",
    "model": "<MODEL_ID>",
    "durationMs": 1234,
    "usage": {
      "promptTokens": 50,
      "completionTokens": 200,
      "totalTokens": 250
    },
    "creditsConsumed": 1
  }
}