工具 API 概览

export TOKENTOSEA_TOOL_KEY="tts_tool_…"
API=https://tokentosea.com/api/v1/tool-api

# 读取 GitHub 工具的操作与价格
curl "$API/actions/public_github" -H "Authorization: Bearer $TOKENTOSEA_TOOL_KEY"

# 调用 github.search
curl "$API/invoke" \
  -H "Authorization: Bearer $TOKENTOSEA_TOOL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actionId": "github.search",
    "input": {"query": "typescript", "limit": 3},
    "requestKey": "'"$(uuidgen)"'",
    "priceVersion": "public-20261010-v1",
    "maxCostUsd": "0.001000"
  }'

import os
import uuid

import requests

API = "https://tokentosea.com/api/v1/tool-api"
HEADERS = {"Authorization": "Bearer " + os.environ["TOKENTOSEA_TOOL_KEY"]}

actions = requests.get(f"{API}/actions/public_github", headers=HEADERS, timeout=30)
actions.raise_for_status()
action = next(a for a in actions.json() if a["id"] == "github.search")

run = requests.post(
    f"{API}/invoke",
    headers=HEADERS,
    json={
        "actionId": action["id"],
        "input": {"query": "typescript", "limit": 3},
        "requestKey": str(uuid.uuid4()),      # 网络重试时沿用同一个值
        "priceVersion": action["priceVersion"],
        "maxCostUsd": action["priceUsd"],
    },
    timeout=60,
)
run.raise_for_status()
result = run.json()
if result["status"] == "succeeded":
    print(result["chargedUsd"], result["output"]["data"]["total_count"])
else:
    print("failed:", result["errorCode"])  # 失败不扣费

import { randomUUID } from 'node:crypto';

const API = 'https://tokentosea.com/api/v1/tool-api';
const headers = { Authorization: `Bearer ${process.env.TOKENTOSEA_TOOL_KEY}`, 'Content-Type': 'application/json' };

const actions = await (await fetch(`${API}/actions/public_github`, { headers })).json();
const action = actions.find((a) => a.id === 'github.search');

const response = await fetch(`${API}/invoke`, {
  method: 'POST',
  headers,
  body: JSON.stringify({
    actionId: action.id,
    input: { query: 'typescript', limit: 3 },
    requestKey: randomUUID(), // 网络重试时沿用同一个值
    priceVersion: action.priceVersion,
    maxCostUsd: action.priceUsd,
  }),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const run = await response.json();
console.log(run.status, run.chargedUsd, run.errorCode ?? '');