API 參考
對話與文本補全
使用 Chat Completions 和 Completions 接口生成文本。
Chat Completions 是推薦的文本生成接口，支持多輪消息、流式輸出、工具調用、多模態輸入以及結構化輸出。舊版 Text Completions 仍保留兼容。
端點
| 方法 | 路徑 | 說明 |
|---|---|---|
POST | /v1/chat/completions | OpenAI 兼容對話補全 |
POST | /v1/completions | 舊版文本補全，使用 prompt |
請求參數
| 字段 | 類型 | 必填 | 說明 |
|---|---|---|---|
model | string | 是 | 模型 ID |
messages | array | Chat 必填 | 對話消息。FIM 模型使用 prefix / suffix 時可不傳 |
prompt | string 或 array | Completions 必填 | 舊版文本補全輸入 |
stream | boolean | 否 | 是否返回 SSE 流 |
stream_options | object | 否 | 流式輸出選項 |
max_tokens | integer | 否 | 最大輸出 token 數 |
max_completion_tokens | integer | 否 | 新版最大輸出 token 數 |
temperature、top_p、top_k | number | 否 | 採樣參數 |
stop | string 或 array | 否 | 停止序列 |
tools、tool_choice | array/object | 否 | 工具調用配置 |
parallel_tool_calls | boolean | 否 | 是否允許並行工具調用 |
response_format | object | 否 | JSON object / JSON schema 等結構化輸出配置 |
reasoning_effort | string | 否 | 推理模型的推理力度 |
modalities、audio | object | 否 | 多模態或音頻相關模型參數 |
metadata | object | 否 | 透傳元數據 |
store、service_tier、safety_identifier | any | 否 | OpenAI 擴展字段，可能受渠道設置過濾 |
curl 示例
curl https://api.tensoraxis.ai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TENSORAXIS_API_KEY" \
-d '{
"model": "gpt-4o",
"messages": [
{"role": "system", "content": "你是一個簡潔的助手。"},
{"role": "user", "content": "用一句話介紹 TENSORAXIS"}
],
"temperature": 0.7
}'Python 示例
from openai import OpenAI
client = OpenAI(
api_key="your-tensoraxis-api-key",
base_url="https://api.tensoraxis.ai/v1",
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "你好！"}],
)
print(response.choices[0].message.content)TypeScript 示例
import OpenAI from 'openai'
const client = new OpenAI({
apiKey: process.env.TENSORAXIS_API_KEY,
baseURL: 'https://api.tensoraxis.ai/v1',
})
const response = await client.chat.completions.create({
model: 'gpt-4o',
messages: [{ role: 'user', content: '你好！' }],
})
console.log(response.choices[0].message.content)流式輸出
{
"model": "gpt-4o",
"messages": [{"role": "user", "content": "寫一個三行短詩"}],
"stream": true
}開啟 stream 後，響應為 SSE。客戶端需要按 data: 事件逐塊讀取，直到收到結束事件。
多模態輸入
messages[].content 可以是字符串，也可以是內容數組。後端可識別 text、image_url、input_audio 等內容類型；具體是否生效取決於所選模型和上游渠道。