# API 位址、協定與模型選擇

## 介面位址與驗證

使用 HTTPS，以 Authorization: Bearer 攜帶本站 API 金鑰。OpenAI 相容客戶端基底網址以 /v1 結尾，請勿重複拼接 /v1。Claude Code 填寫根位址，由工具自行追加 /v1/messages。

| API | URL |
| --- | --- |
| Models · GET | https://u9ai.ai/v1/models |
| Chat Completions · POST | https://u9ai.ai/v1/chat/completions |
| Responses · POST | https://u9ai.ai/v1/responses |
| Anthropic Messages · POST | https://u9ai.ai/v1/messages |

## 依協定選擇模型

GET /v1/models 出現模型，不代表它支援所有端點。支援 Chat Completions 不代表支援 Responses。Claude Code 需要合適的 Claude 模型與 Anthropic Messages 行為；生圖與影片模型無法替代。用於程式助手前，請讓客服確認模型的協定、串流、工具呼叫與上下文限制。

## 最小文字請求

以已確認支援 Chat Completions 的模型 ID 取代 YOUR_CHAT_MODEL_ID。生成請求會消耗餘額；先測試短文字非串流請求，再分別驗證串流與完整工具呼叫往返。

```bash
curl --fail-with-body -sS "https://u9ai.ai/v1/chat/completions" \
  -H "Authorization: Bearer $U9AI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_CHAT_MODEL_ID","messages":[{"role":"user","content":"Hello"}],"stream":false}'
```
## 圖像、影片與音樂介面

多模態模型各自有專屬欄位、供應商協定與非同步任務端點。請勿將影片模型送到 /chat/completions，也不要假設所有生圖模型都接受同一種請求。依模型規格與工作台支援的欄位操作；保存任務 ID，使用供應商規定的查詢端點輪詢。任務完成且存在有效輸出資源後，才有可下載結果。

/api/user/playground 是使用登入工作階段的網站介面，不能代替公開 API 金鑰驗證。外部串接請勿複製網站 Cookie。缺少模型專用文件時，請附模型 ID 與呼叫目的提交工單，確認介面契約再實作。

## 正式串接

保存請求編號和錯誤資訊，不記錄金鑰。建立請求逾時後不要盲目重送，任務可能已建立並產生費用；先查詢已知任務。串流中斷也不代表免費失敗，請核對最終請求狀態與錢包明細。