快速开始

欢迎使用 AGIPower！本指南将帮助你快速上手，从注册到发起第一个 API 请求，一步步引导你使用 AGIPower 的全部能力。

只需要四个简单步骤，即可开始使用 AGIPower：

登录 AGIPower：访问 AGIPower 登录页面，选择以下任一方式登录：
- Google 账号登录
- GitHub 账号登录
- 微信登录
选择使用方式：根据你的使用场景，选择 Pay As You Go（按量付费）或 Builder Plan（订阅制）。
获取 API 密钥：登录后，在对应的管理页面创建 API Key。
发起你的第一个请求：选择你熟悉的 API 协议，复制下面的代码示例，替换你的 API Key，即可运行。

选择使用方式

AGIPower 提供两种使用方式，适配不同的使用场景：

Pay As You Go（按量付费）

适用场景：生产环境、商业化产品、高并发应用 Pay As You Go 采用预充值 + 按实际消耗扣费的模式，专为生产环境打造：

无 Rate Limit 限制，支持高并发调用
按 Token 精确计费，成本透明可控

前往 Pay As You Go 管理页面 充值并创建 API Key。

完整的使用说明请参考 Pay As You Go 使用指南。

Builder Plan（订阅制）

适用场景：个人开发、学习探索、Vibe Coding、快速原型 Builder Plan 提供固定月费、可预测的 AI 模型调用方案：

固定月费，$20/月起
全明星模型矩阵，一个订阅调度全球 100+ 顶尖模型
全场景覆盖，Coding + 生图 + 生视频 + 对话一站式搞定

前往 Pricing 页面 了解套餐详情并订阅。订阅制套餐对比

完整的使用说明请参考订阅制套餐指南。

两种方式对比

对比维度	Pay As You Go（按量付费）	Builder Plan（订阅制）
适用场景	生产环境、商业化产品	个人开发、学习探索
计费方式	按实际消耗精准计费	固定月费
Rate Limit	无限制	10-15 RPM
并发限制	无限制	有 Weekly Limit
使用限制	无特殊限制	禁止生产环境使用

如果你的项目已经上线或即将商业化，必须使用 Pay As You Go 方案。订阅制仅限个人开发和学习场景，禁止用于生产环境。

AGIPower 平台的模型具备唯一 Slug，您可以通过模型列表页获取对应模型的 Slug： model-slug

或者某个模型的模型详情页获取对应模型的 Slug： model-slug

支持的 API 协议

AGIPower 支持四种主流 API 协议，你可以使用最熟悉的 SDK 调用 AGIPower 上的所有模型：

协议	Base URL	兼容 SDK	说明
OpenAI Chat Completions	`https://api.agipower.ai/v1`	OpenAI SDK	最广泛使用的 Chat API
OpenAI Responses	`https://api.agipower.ai/v1`	OpenAI SDK	OpenAI 新一代 Responses API
Anthropic Messages	`https://agipower.ai`	Anthropic SDK	Claude 系列原生协议
Google Gemini	`https://api.agipower.ai`	Google GenAI SDK	Gemini 系列原生协议

AGIPower 的核心优势之一是协议无关性——你可以通过任意支持的协议调用任意模型。例如，用 OpenAI SDK 调用 Claude 模型，或用 Anthropic SDK 调用 Gemini 模型。

协议一：OpenAI Chat Completions

AGIPower 的 API 端点与 OpenAI Chat Completions API 完全兼容，只需修改 base_url 和 api_key 两个参数即可无缝切换。

Python

from openai import OpenAI

# 1. 初始化 OpenAI 客户端
client = OpenAI(
    # 2. 将基础 URL 指向 AGIPower 端点
    base_url="https://api.agipower.ai/v1", 
    # 3. 替换为你从 AGIPower 获取的 API Key
    api_key="<你的 AGIPower_API_KEY>", 
)

# 4. 发起 Chat Completion 请求
completion = client.chat.completions.create(
    # 5. 指定模型，格式为 "供应商/模型名称"
    model="openai/gpt-5", 
    messages=[
        {
            "role": "user",
            "content": "生命的意义是什么？"
        }
    ]
)

print(completion.choices[0].message.content)

TypeScript

import OpenAI from "openai";

// 1. 初始化 OpenAI 客户端
const openai = new OpenAI({
  // 2. 将基础 URL 指向 AGIPower 端点
  baseURL: "https://api.agipower.ai/v1", 
  // 3. 替换为你从 AGIPower 获取的 API Key
  apiKey: "<你的 AGIPower_API_KEY>", 
});

async function main() {
  // 4. 发起 Chat Completion 请求
  const completion = await openai.chat.completions.create({
    // 5. 指定模型，格式为 "供应商/模型名称"
    model: "openai/gpt-5", 
    messages: [
      {
        role: "user",
        content: "生命的意义是什么？",
      },
    ],
  });

  console.log(completion.choices[0].message.content);
}

main();

cURL

curl https://api.agipower.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AGIPower_API_KEY" \
  -d '{
    "model": "openai/gpt-5",
    "messages": [
      {
        "role": "user",
        "content": "生命的意义是什么？"
      }
    ]
  }'

协议二：OpenAI Responses

AGIPower 同样兼容 OpenAI 新一代 Responses API。Base URL 与 Chat Completions 相同，调用方式更加简洁。

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.agipower.ai/v1", 
    api_key="<你的 AGIPower_API_KEY>", 
)

# 使用 Responses API 发起请求
response = client.responses.create(
    model="openai/gpt-5", 
    input="生命的意义是什么？"
)

print(response.output_text)

TypeScript

import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: "https://api.agipower.ai/v1", 
  apiKey: "<你的 AGIPower_API_KEY>", 
});

async function main() {
  const response = await openai.responses.create({
    model: "openai/gpt-5", 
    input: "生命的意义是什么？", 
  });

  console.log(response.output_text);
}

main();

cURL

curl https://api.agipower.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AGIPower_API_KEY" \
  -d '{
    "model": "openai/gpt-5",
    "input": "生命的意义是什么？"
  }'

协议三：Anthropic Messages

AGIPower 完全支持 Anthropic Messages 协议，可以无缝集成到 Claude Code、Cursor 等工具中。注意 Anthropic 协议的 base_url 为 https://api.agipower.ai，与 OpenAI 协议不同。

支持 Anthropic 协议的模型正在分批适配中，当前已支持的模型可以通过官方模型列表筛选 Anthropic API Compatible 查看： anthropic-support

或者也可以通过模型详情页查看： anthropic-support

Python

from anthropic import Anthropic

# 1. 初始化 Anthropic 客户端
client = Anthropic(
    # 2. 将基础 URL 指向 AGIPower 端点
    base_url="https://api.agipower.ai", 
    # 3. 替换为你从 AGIPower 获取的 API Key
    api_key="<你的 AGIPower_API_KEY>", 
)

# 4. 发起 Messages 请求
message = client.messages.create(
    model="google/gemini-3.1-pro-preview", 
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "生命的意义是什么？"
        }
    ]
)

print(message.content[0].text)

TypeScript

import Anthropic from "@anthropic-ai/sdk";

// 1. 初始化 Anthropic 客户端
const client = new Anthropic({
  // 2. 将基础 URL 指向 AGIPower 端点
  baseURL: "https://api.agipower.ai", 
  // 3. 替换为你从 AGIPower 获取的 API Key
  apiKey: "<你的 AGIPower_API_KEY>", 
});

async function main() {
  // 4. 发起 Messages 请求
  const message = await client.messages.create({
    model: "google/gemini-3.1-pro-preview", 
    max_tokens: 1024,
    messages: [
      {
        role: "user",
        content: "生命的意义是什么？",
      },
    ],
  });

  console.log(message.content[0].text);
}

main();

cURL

curl https://api.agipower.ai/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $AGIPower_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "google/gemini-3.1-pro-preview",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "生命的意义是什么？"
      }
    ]
  }'

协议四：Google Gemini

AGIPower 支持 Google Gemini（Vertex AI）协议，可以使用 Google GenAI SDK 直接调用。Base URL 为 https://api.agipower.ai，需要设置 vertexai=True 和自定义 http_options。

Python

from google import genai
from google.genai import types

# 1. 初始化 Google GenAI 客户端
client = genai.Client(
    # 2. 替换为你从 AGIPower 获取的 API Key
    api_key="<你的 AGIPower_API_KEY>", 
    vertexai=True, 
    # 3. 将 base_url 指向 AGIPower 端点
    http_options=types.HttpOptions(
        api_version='v1',
        base_url='https://api.agipower.ai'
    )
)

# 4. 发起 generateContent 请求
response = client.models.generate_content(
    model="google/gemini-3.1-pro-preview", 
    contents="生命的意义是什么？"
)

print(response.text)

TypeScript

import { GoogleGenAI } from "@google/genai";

// 1. 初始化 Google GenAI 客户端
const ai = new GoogleGenAI({
  // 2. 替换为你从 AGIPower 获取的 API Key
  apiKey: "<你的 AGIPower_API_KEY>", 
  vertexai: true, 
  // 3. 将 base_url 指向 AGIPower 端点
  httpOptions: {
    apiVersion: "v1",
    baseUrl: "https://api.agipower.ai", 
  },
});

async function main() {
  // 4. 发起 generateContent 请求
  const response = await ai.models.generateContent({
    model: "google/gemini-3.1-pro-preview", 
    contents: "生命的意义是什么？",
  });

  console.log(response.text);
}

main();

Platform API

AGIPower 提供一组 Platform Management API，让你能够通过编程方式查询账户用量、余额、订阅状态等信息，方便集成到你的监控和管理系统中。

Platform API 需要使用 Management API Key 鉴权（部分接口也支持普通 API Key）。前往 AGIPower 控制台 > Management 创建 Management API Key。

查询 Generation 详情

查询某次 API 调用的详细信息，包括 Token 用量、耗时、计费明细等。

GET https://api.agipower.ai/v1/management/generation?id=<generation_id>

每次 API 调用会返回一个 generation_id，使用该 ID 即可查询本次调用的完整信息：

curl https://api.agipower.ai/v1/management/generation?id=gen_01abc123def456 \
  -H "Authorization: Bearer $AGIPower_API_KEY"

返回示例（部分字段）：

{
  "api": "chat.completions",
  "generationId": "gen_01abc123def456",
  "model": "openai/gpt-4o",
  "generationTime": 3200,
  "latency": 500,
  "nativeTokens": {
    "completion_tokens": 128,
    "prompt_tokens": 32,
    "total_tokens": 160
  },
  "usage": 0.0052
}

计费信息（如 usage、ratingResponses）需要在请求完成后 3-5 分钟 才能查询到。Token 计量信息则会随请求同步返回。

详细参数说明请参考 Get Generation API 文档。

查询 PAYG 余额

获取当前账号的 Pay As You Go 余额信息。

GET https://api.agipower.ai/v1/management/payg/balance

curl https://api.agipower.ai/v1/management/payg/balance \
  -H "Authorization: Bearer $AGIPower_MANAGEMENT_API_KEY"

返回示例：

{
  "success": true,
  "data": {
    "currency": "usd",
    "total_credits": 482.74,
    "top_up_credits": 35.00,
    "bonus_credits": 447.74
  }
}

详细参数说明请参考 Get PAYG Balance API 文档。

查询订阅详情

获取当前账号的订阅信息，包括套餐等级、Flow 汇率、配额用量等。

GET https://api.agipower.ai/v1/management/subscription/detail

curl https://api.agipower.ai/v1/management/subscription/detail \
  -H "Authorization: Bearer $AGIPower_MANAGEMENT_API_KEY"

返回示例（部分字段）：

{
  "success": true,
  "data": {
    "plan": {
      "tier": "ultra",
      "amount_usd": 200,
      "interval": "month"
    },
    "account_status": "healthy",
    "quota_5_hour": {
      "max_flows": 800,
      "used_flows": 57.2,
      "remaining_flows": 742.8,
      "usage_percentage": 0.0715
    },
    "quota_7_day": {
      "max_flows": 6182,
      "used_flows": 416.11,
      "remaining_flows": 5765.89
    }
  }
}

详细参数说明请参考 Get Subscription Detail API 文档。

查询 Flow 汇率

获取当前账号的 Flow 汇率信息。

GET https://api.agipower.ai/v1/management/flow_rate

curl https://api.agipower.ai/v1/management/flow_rate \
  -H "Authorization: Bearer $AGIPower_MANAGEMENT_API_KEY"

返回示例：

{
  "success": true,
  "data": {
    "currency": "usd",
    "base_usd_per_flow": 0.03283,
    "effective_usd_per_flow": 0.03283
  }
}

详细参数说明请参考 Get Flow Rate API 文档。

高级用法

关于高级用法的详细信息，请参阅高级调用章节的内容。

如果您在使用过程中遇到任何问题，或有任何建议和反馈，欢迎通过以下方式联系我们：

官方网站：https://agipower.ai
技术支持邮箱：support@agipower.ai

更多联系方式和详细信息，请访问我们的联系我们页面。

About AGIPower

API Reference

Best Practices

Help Center

Quickstart

快速开始

选择使用方式

Pay As You Go（按量付费）

Builder Plan（订阅制）

两种方式对比

支持的 API 协议

协议一：OpenAI Chat Completions

协议二：OpenAI Responses

协议三：Anthropic Messages

协议四：Google Gemini

Platform API

查询 Generation 详情

查询 PAYG 余额

查询订阅详情

查询 Flow 汇率

高级用法

​快速开始

​选择使用方式

​Pay As You Go（按量付费）

​Builder Plan（订阅制）

​两种方式对比

​支持的 API 协议

​协议一：OpenAI Chat Completions

​协议二：OpenAI Responses

​协议三：Anthropic Messages

​协议四：Google Gemini

​Platform API

​查询 Generation 详情

​查询 PAYG 余额

​查询订阅详情

​查询 Flow 汇率

​高级用法

快速开始

选择使用方式

Pay As You Go（按量付费）

Builder Plan（订阅制）

两种方式对比

支持的 API 协议

协议一：OpenAI Chat Completions

协议二：OpenAI Responses

协议三：Anthropic Messages

协议四：Google Gemini

Platform API

查询 Generation 详情

查询 PAYG 余额

查询订阅详情

查询 Flow 汇率

高级用法