주요 콘텐츠로 건너뛰기

인증

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 키가 활성화된 사용자 계정에 연결되어 있는지 확인하세요
  • 계정 상태를 대시보드에서 확인하세요

관련 문서​