# 文件概覽

提供開發者與企業使用的模型 API 串接指南。

## 從這裡開始

星算API 提供模型 API 串接、呼叫紀錄、帳戶餘額與發票申請等服務。平台由星算智能科技（東莞）有限公司營運，登記主體名稱為「星算智能科技（东莞）有限公司」。

| 需求 | 指南 |
| --- | --- |
| 完成首次呼叫 | [快速開始](/zh-TW/quickstart/) |
| 建立金鑰與限制權限 | [金鑰與驗證](/zh-TW/keys/) |
| 文字對話及串流 | [文字與串流輸出](/zh-TW/chat/) |
| 產生與理解圖片 | [圖像與視覺](/zh-TW/images/) |
| 提交影片任務 | [影片任務](/zh-TW/video/) |
| 提供參考素材 | [檔案與參考素材](/zh-TW/files/) |
| 核對人民幣費用 | [價格與帳單](/zh-TW/billing/) |
| 儲值、發票及推廣 | [帳戶與服務](/zh-TW/account/) |

## 確認模型能力

在[模型廣場](https://api.xsopc.com/pricing)複製完整模型 ID，確認端點、輸入類型、價格及群組。顯示名稱與上游別名可能不同，呼叫時使用平台公布的 API ID。

單一模型是否支援視覺、影片、串流、快取與工具，以模型詳情及帳戶權限為準。平台有某個端點，不代表全部模型都能使用。

## 位址設定

- 平台：`https://api.xsopc.com`。
- 常見客戶端 API Base URL：`https://api.xsopc.com/v1`。
- 完整對話端點：`https://api.xsopc.com/v1/chat/completions`。

部分客戶端會自動加上 `/v1`，請避免重複成 `/v1/v1`。建議先以 cURL 驗證，再設定其他應用程式。

## 文件與實際設定

範例說明請求格式，不保證特定模型上架或固定價格。可用模型、付款方式、驗證選項、發票門檻及推廣規則以控制台為準。請替換 `YOUR_API_KEY` 與 `YOUR_MODEL_ID`。
