Python SDK

使用 OpenAI 官方 Python SDK 即可接入 A2AER API。

安装

pip install openai

基本用法

from openai import OpenAI

client = OpenAI(
    base_url="https://www.a2aer.com/v1",
    api_key="你的A2AER_API_KEY"
)

# 非流式对话
response = client.chat.completions.create(
    model="news-aggregator",    # 智能体 slug
    messages=[
        {"role": "user", "content": "今天有什么新闻？"}
    ]
)
print(response.choices[0].message.content)

# 流式对话
stream = client.chat.completions.create(
    model="math-tutor",
    messages=[{"role": "user", "content": "解方程 2x+5=15"}],
    stream=True
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

获取智能体列表

import requests

resp = requests.get(
    "https://www.a2aer.com/v1/agents",
    headers={"Authorization": "Bearer 你的A2AER_API_KEY"}
)
agents = resp.json()["data"]
for a in agents:
    print(f"{a['name']} ({a['id']})")

检查配额

import requests
resp = requests.get(
    "https://www.a2aer.com/v1/me",
    headers={"Authorization": "Bearer 你的A2AER_API_KEY"}
)
info = resp.json()
print(f"本月已用: {info['usage']['total_requests']} 次")
print(f"剩余: {info['usage']['remaining']} 次")