委托接口

TOKEN="tts_at_…"
API=https://tokentosea.com/api/v1/connect

# 剩余额度
curl "$API/grant" -H "Authorization: Bearer $TOKEN"

# 调用免费的 UUID 工具
curl "$API/tools/invoke" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"actionId": "utility.uuid", "input": {}, "requestKey": "'"$(uuidgen)"'", "priceVersion": "public-20261010-v1", "maxCostUsd": "0"}'

import uuid

import requests

API = "https://tokentosea.com/api/v1/connect"


def call_tool(access_token: str, tool_id: str, action_id: str, tool_input: dict) -> dict:
    headers = {"Authorization": "Bearer " + access_token}
    actions = requests.get(f"{API}/tools/{tool_id}/actions", headers=headers, timeout=30)
    actions.raise_for_status()
    action = next(a for a in actions.json() if a["id"] == action_id)
    response = requests.post(
        f"{API}/tools/invoke",
        headers=headers,
        json={
            "actionId": action_id,
            "input": tool_input,
            "requestKey": str(uuid.uuid4()),  # 保存它，网络重试时沿用
            "priceVersion": action["priceVersion"],
            "maxCostUsd": action["priceUsd"],
        },
        timeout=60,
    )
    if response.status_code == 409 and response.json().get("message") == "oauth_budget_exceeded":
        raise RuntimeError("授权额度不足，请用户在 TokenToSea 控制台提高额度")
    response.raise_for_status()
    return response.json()


print(call_tool("tts_at_…", "public_hn", "hn.top", {"limit": 3}))

import { randomUUID } from 'node:crypto';

const API = 'https://tokentosea.com/api/v1/connect';

export async function callTool(accessToken, toolId, actionId, input) {
  const headers = { Authorization: `Bearer ${accessToken}`, 'Content-Type': 'application/json' };
  const actions = await (await fetch(`${API}/tools/${toolId}/actions`, { headers })).json();
  const action = actions.find((a) => a.id === actionId);
  const response = await fetch(`${API}/tools/invoke`, {
    method: 'POST',
    headers,
    body: JSON.stringify({
      actionId,
      input,
      requestKey: randomUUID(), // 保存它，网络重试时沿用
      priceVersion: action.priceVersion,
      maxCostUsd: action.priceUsd,
    }),
  });
  const body = await response.json();
  if (response.status === 409 && body.message === 'oauth_budget_exceeded') throw new Error('授权额度不足，请用户在 TokenToSea 控制台提高额度');
  if (!response.ok) throw new Error(`HTTP ${response.status}: ${JSON.stringify(body)}`);
  return body;
}

console.log(await callTool('tts_at_…', 'public_hn', 'hn.top', { limit: 3 }));