跳至主要內容

認證

使用 Aether API 需要有效的 API 金鑰。所有 API 請求都必須包含認證標頭。

API 金鑰申請​

API 金鑰可於 Aether 控制台申請。請將申請到的金鑰妥善保管於安全處。

認證標頭​

所有 API 請求都必須包含以下標頭。

Authorization: Bearer <api_key>

cURL 範例​

curl -X POST "https://api.aetherforgeai.com/public/v1/generate/image" \
-H "Authorization: Bearer your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
  "prompt": "A beautiful sunset over mountains",
  "ai_model": "GPT Image 1.5"
}'

錯誤回應​

401 Unauthorized - Invalid API key​

當 API 金鑰無效或遺漏時回傳。

回應範例：

{
  "detail": "Invalid API key"
}

解決方法：

  • 確認 API 金鑰已正確複製
  • 確認已包含 Bearer 前綴與空格
  • 確認 API 金鑰未過期

404 Not Found User​

當 API 金鑰有效但找不到關聯的使用者時回傳。

回應範例：

{
  "detail": "Not Found User"
}

解決方法：

  • 確認 API 金鑰已連結至啟用中的使用者帳號
  • 於控制台確認帳號狀態

相關文件​