文档

API 快速开始

AITransX 接收 OpenAI 兼容的 Chat Completion 请求。使用你的 aitx key 作为 Bearer token。

认证

所有私有请求都必须携带 API Key。你可以在控制台创建和管理 Key。

HTTP

Authorization: Bearer aitx-your-key
Content-Type: application/json

Base URL

把 AITransX 设置为 OpenAI SDK 的 base URL，其余 Chat Completion 请求结构保持不变。

OpenAI SDK

base_url = "https://aitransx.com/v1"

Chat Completions

请求发送到 /v1/chat/completions。设置 "stream": true 即可启用流式响应。

cURL

curl https://aitransx.com/v1/chat/completions \
  -H "Authorization: Bearer aitx-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "messages": [{"role": "user", "content": "Hello"}],
    "stream": false
  }'

模型 ID

使用 auto 可走默认路由，也可以从模型目录或 GET /v1/models 复制精确模型 ID。

Models

GET https://aitransx.com/v1/models

model = "auto"
model = "openai/gpt-4o"
model = "deepseek/deepseek-chat"

流式响应

把 stream 设置为 true，即可收到兼容 OpenAI 的 Server-Sent Events 聊天输出。

JSON

{
  "model": "auto",
  "messages": [{"role": "user", "content": "Hello"}],
  "stream": true
}

Python SDK

继续使用 OpenAI SDK，只需要修改 base URL。

Python

from openai import OpenAI

client = OpenAI(
    api_key="aitx-your-key",
    base_url="https://aitransx.com/v1",
)

resp = client.chat.completions.create(
    model="auto",
    messages=[{"role": "user", "content": "Hello"}],
)

日志和隐私

控制台日志只保存模型、服务商、Token、延迟、状态等运维元数据，不把 prompt 和 response 正文写入磁盘。

公开端点

端点	用途	认证
`GET /v1/models`	列出可路由模型 ID	无需 Key
`GET /api/pricing`	列出公开模型价格	无需 Key
`POST /v1/chat/completions`	创建聊天补全	Bearer Key
`GET /healthz`	服务健康检查	无需 Key