ProxyGate — 出售 API 容量

卖家工作流：创建商品列表、管理列表、通过隧道暴露服务、追踪收益。

流程

1. 初始化项目（可选）

若从零开始构建新服务：

proxygate create                                    # 交互式
proxygate create my-agent --template http-api --port 3000
proxygate create my-agent --template llm-agent --port 8080

模板说明：http-api（基于 Hono 的 REST API），llm-agent（Hono + LLM 提供方 + 流式响应）。

2. 本地测试

上线前验证端点可用性：

proxygate test                                      # 自动从 tunnel 配置中识别
proxygate test --endpoint "POST /v1/analyze" --payload '{"code":"x=1"}'
proxygate test -c proxygate.tunnel.yaml

3. 创建商品列表

proxygate listings create    # 交互式 — 引导完成服务配置、定价、描述、文档等步骤

交互模式将依次询问：服务名称、API 密钥、计价模型、描述、文档、Shield 设置。

非交互模式：

proxygate listings create --non-interactive 
  --service-name "My API" 
  --base-url "https://api.example.com" 
  --auth-pattern bearer 
  --api-key "your-api-key" 
  --price 5000 
  --total-rpm 100 
  --categories ai 
  --description "Fast Llama 3.3 access"

4. 管理商品列表

# 查看商品列表
proxygate listings list                     # 列出您的所有商品列表
proxygate listings list --table             # 表格格式，含状态、RPM、价格等字段

# 更新商品列表
proxygate listings update  --price 3000 --description "Updated pricing"

# 暂停/恢复（临时停止接收请求）
proxygate listings pause 
proxygate listings unpause 

# 永久删除
proxygate listings delete 

# 轮换 API 密钥或 OAuth2 凭据（无服务中断）
proxygate listings rotate-key  --key 
proxygate listings rotate-key  --oauth2 

# 上传 API 文档
proxygate listings upload-docs  ./openapi.yaml    # 支持 OpenAPI 或 Markdown 格式

# 查看商品列表的文档
proxygate listings docs 

# 管理上游请求头
proxygate listings headers                         # 列出当前所有请求头
proxygate listings headers  set X-Custom "value"   # 添加或更新请求头
proxygate listings headers  unset X-Custom         # 移除指定请求头

5. 配置隧道

创建 proxygate.tunnel.yaml 文件：

services:
  - name: my-api
    port: 8080
    price_per_request: 1000           # lamports（即 0.001 USDC）
    description: My AI service
    docs: ./openapi.yaml              # 连接时自动上传
    endpoints:
      - method: POST
        path: /v1/analyze
        description: Analyze code
    paths:
      - /v1/*

按 Token 计价示例：

services:
  - name: llm-service
    port: 3000
    pricing_unit: per_token
    price_per_input_token: 100
    price_per_output_token: 300

6. 启动隧道

# 开发模式（记录请求日志 + 监听配置文件变更 + 自动重载）
proxygate dev
proxygate dev -c my-services.yaml

# 生产模式（稳定连接、自动重连、Ctrl+C 时优雅降级）
proxygate tunnel
proxygate tunnel -c proxygate.tunnel.yaml

开发模式实时显示请求/响应日志，包含状态码、延迟与数据大小；生产模式适用于长期稳定运行，具备自动重连能力。

7. 查询收益

proxygate settlements                              # 收益汇总
proxygate settlements -r seller                    # 卖家专属视图
proxygate settlements -s weather-api --from 2026-03-01  # 按商品名和起始时间过滤
proxygate balance                                  # 当前余额
proxygate listings list --table                    # 商品列表状态概览

SDK — 编程式服务发布

import { ProxyGate, ProxyGateClient } from '@proxygate/sdk';

// 一行代码：立即暴露服务
const tunnel = await ProxyGate.serve({
  keypair: '~/.proxygate/keypair.json',
  services: [
    { name: 'code-review', port: 3000, docs: './openapi.yaml' },
  ],
  onConnected(listings) { console.log('Live!', listings); },
});

// 或使用客户端以获得更精细控制
const client = await ProxyGateClient.create({
  keypairPath: '~/.proxygate/keypair.json',
});

// 编程式管理商品列表
const { listings } = await client.listings.list();
await client.listings.update('listing-id', { price_per_request: 3000 });
await client.listings.pause('listing-id');
await client.listings.unpause('listing-id');
await client.listings.rotateKey('listing-id', { api_key: 'your-new-api-key' });
await client.listings.uploadDocs('listing-id', {
  doc_type: 'openapi',
  content: fs.readFileSync('./openapi.yaml', 'utf-8'),
});

// 启动隧道
const tunnel = await client.serve([
  { name: 'my-api', port: 3000 },
]);

// 优雅关闭（等待进行中的请求完成）
await tunnel.drain();
tunnel.disconnect();

成功标准

• 服务在本地正常运行并响应请求
• 已成功创建商品列表（可通过 proxygate listings list 查看）
• 隧道已连接（开发或生产模式均可）
• 开发模式日志中可见入站请求

相关技能