SDK

OpenAI SDK 互換

公式の OpenAI SDK を TENSORAXIS で使用し、互換性の境界を理解する。

仕組み

TENSORAXIS は、一般的な API に対して統一された OpenAI 互換のエントリーポイントを提供します。Chat Completions、Responses、Embeddings、Images、Audio などのエンドポイントでは、通常 SDK を初期化する際に 2 つのパラメータを変更するだけで済みます。

  • api_key → あなたの TENSORAXIS API キー
  • base_urlhttps://api.tensoraxis.com/v1

一部のプロバイダー拡張機能や非同期タスク API には、独自のリクエストボディの規約があります。特に、動画生成ではアップストリームプロバイダーの生の 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/generations, POST /v1/images/editsモデルの機能に応じた画像生成・編集
AudioPOST /v1/audio/transcriptions, POST /v1/audio/translations, POST /v1/audio/speech音声の文字起こし、翻訳、音声生成
RerankPOST /v1/rerankリランキング。通常は直接 HTTP 呼び出しで利用
VideoPOST /v1/video/generations, GET /v1/video/generations/{task_id}非同期動画タスク API。動画生成 を参照
OpenAI/Sora VideoPOST /v1/videos, GET /v1/videos/{task_id}OpenAI/Sora 形式の動画互換 API

動画 API に関する注意事項

動画生成は非同期で行われます。Seedance / Doubao の動画モデルの場合、TENSORAXIS は統一されたタスクリクエストを受け付けます。

{
  "model": "doubao-seedance-1-0-pro-250528",
  "prompt": "A cinematic cat watching rain by the window",
  "images": ["https://example.com/cat.png"],
  "metadata": {
    "resolution": "1080p",
    "ratio": "16:9",
    "duration": 5
  }
}

アップストリームの Volcengine Ark content[] 構造はアダプターによって生成されます。エンドユーザーが手動で送信する必要はありません。