API 端點
所有 Link Astra API 請求都發往 https://api.linkastra.ai。该 API 完全兼容 OpenAI，因此只需修改 base URL，即可使用任意 OpenAI SDK。
Base URL
| 區域 | Base URL |
|---|
| 全球（單端點） | https://api.linkastra.ai/v1 |
api.linkastra.ai 通過 GeoDNS 將美洲用户路由到希尔斯伯勒，將其他國際用户路由到新加坡。所有區域共享相同的數據和 API Key。
可用端點
對話與文本生成
| 端點 | 方法 | 說明 |
|---|
/v1/chat/completions | POST | 生成對話補全 |
/v1/completions | POST | 文本補全（旧版） |
向量嵌入
| 端點 | 方法 | 說明 |
|---|
/v1/embeddings | POST | 生成文本向量嵌入 |
模型
| 端點 | 方法 | 說明 |
|---|
/v1/models | GET | 列出可用模型 |
/v1/models/{model} | GET | 获取模型详情 |
批量
| 端點 | 方法 | 說明 |
|---|
/v1/batches | POST | 創建批量任務 |
/v1/batches/{batch_id} | GET | 获取批量任務状態 |
/v1/batches/{batch_id}/cancel | POST | 取消批量任務 |
文件
| 端點 | 方法 | 說明 |
|---|
/v1/files | GET | 列出文件 |
/v1/files | POST | 上傳文件 |
/v1/files/{file_id} | GET | 获取文件資訊 |
/v1/files/{file_id}/content | GET | 下載文件內容 |
/v1/files/{file_id} | DELETE | 删除文件 |
響應
| 端點 | 方法 | 說明 |
|---|
/v1/responses | POST | 創建響應（Agent 模式） |
列出模型
curl https://api.linkastra.ai/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"
響應：
{
"object": "list",
"data": [
{"id": "deepseek/deepseek-v4-pro", "object": "model", "created": 1719000000, "owned_by": "linkwo"},
{"id": "deepseek/deepseek-v4-flash", "object": "model", "created": 1719000000, "owned_by": "linkwo"},
{"id": "z-ai/glm-5.1", "object": "model", "created": 1719000000, "owned_by": "linkwo"},
{"id": "z-ai/glm-5.2", "object": "model", "created": 1719000000, "owned_by": "linkwo"},
{"id": "linkwo/fusion", "object": "model", "created": 1719000000, "owned_by": "linkwo"},
{"id": "astra", "object": "model", "created": 1719000000, "owned_by": "linkwo"}
]
}
SDK 配置
Python
from openai import OpenAI
client = OpenAI(
base_url="https://api.linkastra.ai/v1",
api_key="YOUR_API_KEY"
)
Node.js
import OpenAI from 'openai';
const client = new OpenAI({
baseURL: 'https://api.linkastra.ai/v1',
apiKey: 'YOUR_API_KEY',
});
相關文件