OpenAI SDK 兼容
使用 OpenAI 官方 SDK 接入 TENSORAXIS,并了解兼容边界。
原理
TENSORAXIS 为常见 OpenAI 兼容接口提供统一入口。对于 Chat Completions、Responses、Embeddings、Images、Audio 等接口,通常只需要在初始化 SDK 时替换两个参数:
api_key→ 你的 TENSORAXIS API Keybase_url→https://api.tensoraxis.com/v1
部分供应商扩展能力和异步任务会有自己的请求体约定。尤其是视频生成,不要直接照搬上游厂商的原始 content[] 请求体,请参考 视频生成。
Python
pip install openaifrom openai import OpenAI
client = OpenAI(
api_key="your-tensoraxis-api-key",
base_url="https://api.tensoraxis.com/v1",
)Node.js / TypeScript
npm install openaiimport 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 Completions | POST /v1/chat/completions | 对话补全,支持流式输出 |
| Responses | POST /v1/responses | OpenAI Responses API |
| Embeddings | POST /v1/embeddings | 文本向量化 |
| Models | GET /v1/models | 可用模型列表 |
| Images | POST /v1/images/generations、POST /v1/images/edits | 图片生成与编辑(取决于模型能力) |
| Audio | POST /v1/audio/transcriptions、POST /v1/audio/translations、POST /v1/audio/speech | 音频转写、翻译与语音生成 |
| Rerank | POST /v1/rerank | 重排序接口,通常使用直接 HTTP 调用 |
| Video | POST /v1/video/generations、GET /v1/video/generations/{task_id} | 异步视频任务接口,见视频生成 |
| OpenAI/Sora Video | POST /v1/videos、GET /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[] 会由系统适配生成,终端用户不需要手动传入。