API 文档 - TopenRouter

1 概述

全局 API 访问地址

https://tp-api.chinadatapay.com:8000

TopenRouter（TokenPay）提供完整的 RESTful API 接口。我们的 API 兼容 OpenAI 格式，让您可以无缝迁移现有的 AI 应用。

通过TopenRouter，您可以统一调用 OpenAI、Claude、Gemini 等主流 AI 模型，享受智能路由、额度管理和高可用性保障。

2 认证

TopenRouter API 使用 API Key 进行认证。您可以在后台的“令牌”页面创建和管理您的 API Key。

Authorization: Bearer YOUR_API_KEY

请始终在服务端调用 API，切勿泄露您的 API Key。

3 模型列表

获取当前可用的模型列表。

GEThttps://tp-api.chinadatapay.com:8000/v1/models

示例请求

curl https://tp-api.chinadatapay.com:8000/v1/models \
-H "Authorization: Bearer sk-xxxxxx"

响应示例

{
  "object": "list",
  "data":[
    {
      "id": "gpt-4",
      "object": "model",
      "created": 1687882411,
      "owned_by": "openai"
    },
    {
      "id": "claude-3-opus",
      "object": "model",
      "created": 1710323355,
      "owned_by": "anthropic"
    }
  ]
}

4 聊天对话

OpenAI 兼容格式

标准的对话补全接口，支持流式输出。

POSThttps://tp-api.chinadatapay.com:8000/v1/chat/completions

CURL 示例

curl https://tp-api.chinadatapay.com:8000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -d '{
    "model": "gpt-4",
    "messages":[
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello"}
    ],
    "temperature": 0.7,
    "stream": true
  }'

主要参数

model: 模型 ID，如 gpt-4, claude-3-opus
messages: 对话消息列表，包含 role 和 content
stream: 是否流式响应，默认为 false
temperature: 采样温度，0 到 2 之间

Claude 原生格式

支持 Anthropic 官方的消息流格式。

POSThttps://tp-api.chinadatapay.com:8000/v1/messages

CURL 示例

curl https://tp-api.chinadatapay.com:8000/v1/messages \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -d '{
    "model": "claude-3-opus-20240229",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello"}
    ]
  }'

Gemini 原生格式

兼容 Google AI Studio 的 API 结构。

POSThttps://tp-api.chinadatapay.com:8000/v1beta/models/{model}:generateContent

CURL 示例

curl https://tp-api.chinadatapay.com:8000/v1beta/models/{model}:generateContent \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -d '{
    "contents": [{
      "parts": [{"text": "Hello"}]
    }]
  }'

5 文本补全

传统的文本补全接口，用于单次预测或简单的内容生成。

POSThttps://tp-api.chinadatapay.com:8000/v1/completions

支持 model, prompt, max_tokens 等标准参数。

6 文本嵌入

将文本转换为高维向量，用于检索（RAG）、聚类或语义查找。

OpenAI 格式

https://tp-api.chinadatapay.com:8000/v1/embeddings

{
  "model": "text-embedding-3-small",
  "input": "The quick brown fox"
}

Gemini 格式

https://tp-api.chinadatapay.com:8000/v1/engines/{model}/embeddings

{
  "content": {
    "parts":[{"text": "The quick brown fox"}]
  }
}

7 文档重排序

对检索出的文档候选列表进行相关性评分，从而实现更精准的 RAG 效果。

POSThttps://tp-api.chinadatapay.com:8000/v1/rerank

Request JSON

{ "model": "rerank-english-v2.0", "query": "What is TopenRouter?", "documents":[ "TopenRouter is a universal AI API gateway...", "TopenRouter supports multiple model integrations..." ] }

Response JSON

{ "id": "rerank-xxx", "results":[ { "index": 0, "relevance_score": 0.98 }, { "index": 1, "relevance_score": 0.85 } ] }