跳到主要内容

认证

使用 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 密钥已关联到激活的用户账户
  • 在控制台中检查账户状态

相关文档​