通用約定
鑑權
TENSORAXIS API 的令牌格式、鑑權頭和安全建議。
所有 API 請求都需要使用 TENSORAXIS 令牌鑑權。令牌可以在控制台的「令牌」頁面創建，並可按模型、分組、IP 和速率等維度配置權限。
OpenAI 兼容接口
OpenAI 兼容接口使用 Authorization 請求頭：
curl https://api.tensoraxis.com/v1/chat/completions \
-H "Authorization: Bearer $TENSORAXIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o",
"messages": [{"role": "user", "content": "你好"}]
}'適用於 /v1/chat/completions、/v1/responses、/v1/embeddings、/v1/images/*、/v1/audio/*、/v1/rerank、/v1/video/generations 等端點。
Claude 原生接口
Claude 原生格式可以使用 x-api-key，並攜帶 Anthropic 版本頭：
curl https://api.tensoraxis.com/v1/messages \
-H "x-api-key: $TENSORAXIS_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello"}]
}'Gemini 原生接口
Gemini 原生格式支持 query 參數 key，也支持 x-goog-api-key 請求頭：
curl "https://api.tensoraxis.com/v1beta/models/gemini-2.0-flash:generateContent?key=$TENSORAXIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [{"parts": [{"text": "Hello"}]}]
}'安全建議
- 不要把 API Key 寫進前端代碼、移動端包、公開倉庫或截圖。
- 服務端建議通過環境變量讀取令牌，例如
TENSORAXIS_API_KEY。 - 為不同應用創建不同令牌，按模型、分組、IP、額度和速率分別限制。
- 發現洩露後立即在控制台禁用或重置令牌。
兼容舊入口時，https://www.tensoraxis.com/v1 仍可作為 API Origin 使用；新接入建議統一使用 https://api.tensoraxis.com/v1。