OpenAI SDK 兼容

使用 OpenAI 官方 SDK 接入 TENSORAXIS,并了解兼容边界。

原理

TENSORAXIS 为常见 OpenAI 兼容接口提供统一入口。对于 Chat Completions、Responses、Embeddings、Images、Audio 等接口,通常只需要在初始化 SDK 时替换两个参数:

  • api_key → 你的 TENSORAXIS API Key
  • base_urlhttps://api.tensoraxis.com/v1

部分供应商扩展能力和异步任务会有自己的请求体约定。尤其是视频生成,不要直接照搬上游厂商的原始 content[] 请求体,请参考 视频生成

Python

pip install openai
from openai import OpenAI

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

Node.js / TypeScript

npm install openai
import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.TENSORAXIS_API_KEY,
  baseURL: 'https://api.tensoraxis.com/v1',
})

环境变量方式(推荐)

# .env
OPENAI_API_KEY=your-tensoraxis-api-key
OPENAI_BASE_URL=https://api.tensoraxis.com/v1

设置后,OpenAI SDK 会自动读取环境变量:

from openai import OpenAI
client = OpenAI()

支持的接口

接口路径说明
Chat CompletionsPOST /v1/chat/completions对话补全,支持流式输出
ResponsesPOST /v1/responsesOpenAI Responses API
EmbeddingsPOST /v1/embeddings文本向量化
ModelsGET /v1/models可用模型列表
ImagesPOST /v1/images/generationsPOST /v1/images/edits图片生成与编辑(取决于模型能力)
AudioPOST /v1/audio/transcriptionsPOST /v1/audio/translationsPOST /v1/audio/speech音频转写、翻译与语音生成
RerankPOST /v1/rerank重排序接口,通常使用直接 HTTP 调用
VideoPOST /v1/video/generationsGET /v1/video/generations/{task_id}异步视频任务接口,见视频生成
OpenAI/Sora VideoPOST /v1/videosGET /v1/videos/{task_id}OpenAI/Sora 风格视频兼容接口

视频接口特别说明

视频生成是异步任务。以 Seedance / Doubao 视频模型为例,TENSORAXIS 接收的是统一任务请求:

{
  "model": "doubao-seedance-1-0-pro-250528",
  "prompt": "一只猫在窗边看雨,电影感",
  "images": ["https://example.com/cat.png"],
  "metadata": {
    "resolution": "1080p",
    "ratio": "16:9",
    "duration": 5
  }
}

上游火山方舟的 content[] 会由系统适配生成,终端用户不需要手动传入。