端點約定
Starmodel 對外只有一個 OpenAI 相容閘道。所有請求都打同一個 base URL：路徑決定能力，model 欄位決定模型。
Base URL
https://api.starmodel.ai/v1這是你的閘道網域。在其後接上下面的端點路徑，並為每個請求帶上 Authorization: Bearer $API_KEY 驗證。
端點總覽
| 能力 | 方法 | 路徑 |
|---|---|---|
| 對話補全 | POST | /v1/chat/completions |
| Anthropic messages | POST | /v1/messages |
| Responses API | POST | /v1/responses |
| 生成圖片 | POST | /v1/images/generations |
| 編輯圖片 | POST | /v1/images/edits |
| 生成影片 | POST | /v1/videos/generations |
| 語音合成 | POST | /v1/audio/speech |
| 模型列表 | GET | /v1/models |
同步與非同步
Chat、messages、responses 在一次 HTTP 請求內回傳。設 stream: true 即以 Server-Sent Events（text/event-stream）串流回傳，以 data: [DONE] 結束。
圖片、影片、語音 生成在上游是長耗時任務，但閘道會替你輪詢任務並回傳統一的同步 JSON 結果——不需要你再去輪詢 task id。影片請把用戶端逾時調大。被限流的請求回傳 HTTP 429，並帶 Retry-After 回應標頭。
從直連廠商遷移
端點皆與 OpenAI 相容，多數情況下你只需改 base_url：
- client = OpenAI(api_key=OPENAI_KEY)+ client = OpenAI(+ api_key=SEEAI_KEY,+ base_url="https://api.starmodel.ai/v1",+ )用 Anthropic SDK？把它的 base_url 指向同一個閘道，呼叫 /v1/messages 即可。