快速開始
透過與 OpenAI、Anthropic 相容的 API，使用一把金鑰呼叫多個模型。本頁涵蓋驗證方式、串流輸出、模型選擇與錯誤處理。
相容 OpenAI SDK · Anthropic SDK · cURL
步驟 1 — 註冊並取得免費額度
步驟 2 — 建立 API 金鑰
步驟 3 — 設定你的 base URL
https://aaa.ashp.tw/v1
https://aaa.ashp.tw/v1/anthropic
步驟 4 — 送出你的第一個請求
curl https://aaa.ashp.tw/v1/chat/completions \
-H "Authorization: Bearer $AAA_TOKEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"messages": [{"role": "user", "content": "Hello!"}]
}'
請將你自己的 API 金鑰（以 sk- 開頭）以 Bearer 權杖形式放入 Authorization 標頭。
API 參考
身分驗證
每個請求都必須帶上你的 API 金鑰（以 sk- 開頭）。OpenAI 相容端點請使用 Authorization: Bearer 標頭；Anthropic 相容端點也可使用 x-api-key 標頭。請妥善保管金鑰，不要放進前端程式碼或公開的程式庫。
Authorization: Bearer $AAA_TOKEN_API_KEY
串流輸出
在請求中加入 stream: true，即可透過 Server-Sent Events（SSE）逐段接收輸出，適合聊天介面與長篇回覆。OpenAI 相容的 /v1/chat/completions 與 Anthropic 相容的 /v1/messages 都支援串流。
模型與定價
在請求的 model 欄位填入模型名稱即可，例如 claude-sonnet-4-6 或 gpt-5.4。可用模型與各模型的每百萬 token 價格請見定價頁面。
錯誤碼
| HTTP | 類型 |
|---|---|
401 | API 金鑰缺漏、無效或已被停用，請確認金鑰是否正確。 |
402 | 帳戶餘額不足，請儲值後再重試。 |
404 | 找不到請求的路徑或模型，請檢查 Base URL、路徑與 model 名稱。 |
429 | 請求過於頻繁，已觸發速率限制。請稍候並以指數退避方式重試。 |
500+ | 上游模型服務發生暫時性錯誤或逾時，請稍後重試；若持續發生，請聯絡 [email protected]。 |
影片生成 API（Seedance）
用同一把 API Key 生成 AI 影片。建立任務後會立即回傳任務 ID，再以 GET 查詢進度，完成時回傳影片網址。也相容方舟原生路徑 /v1/contents/generations/tasks。
curl https://aaa.ashp.tw/v1/videos/generations \
-H "Authorization: Bearer $AAA_TOKEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedance-1-5-pro-251215",
"content": [{"type": "text", "text": "A golden dragon flying over a neon city at night"}],
"resolution": "720p",
"duration": 5,
"ratio": "16:9"
}'
curl https://aaa.ashp.tw/v1/videos/generations/vid_xxxxxxxxxxxxxxxxxxxxxxxx \
-H "Authorization: Bearer $AAA_TOKEN_API_KEY"
計費：影片成功後才扣款，費用 = 影片 token × 模型單價；影片 token ≈ 寬 × 高 × 每秒影格 × 秒數 ÷ 1024。失敗或取消的任務不收費。影片網址約 24 小時後失效，請盡快下載。
金鑰個別限制
每把 API Key 都能在會員中心單獨設定累計與每日花費上限、可用模型、IP 白名單、到期時間與每分鐘請求上限，方便安全地把金鑰交給團隊成員、客戶或部署在伺服器上。超過限制時會回傳以下錯誤：
| HTTP | 類型 |
|---|---|
401 | key_expired — 金鑰已過期 |
402 | key_spend_limit — 已達這把金鑰的累計花費上限 |
403 | model_not_allowed / ip_not_allowed — 模型或來源 IP 不在這把金鑰的白名單內 |
429 | key_daily_limit / key_rate_limit — 已達每日花費上限或每分鐘請求上限 |
模型清單
GET /v1/models 會回傳目前開放的所有模型（OpenAI 格式），Cursor、Cline 等工具可直接讀取。
curl https://aaa.ashp.tw/v1/models -H "Authorization: Bearer $AAA_TOKEN_API_KEY"