주요 콘텐츠로 건너뛰기

공유 응답 모델

Aether API에서 사용하는 공유 응답 스키마를 설명합니다.

JobIdResponse​

비동기 작업을 생성하는 모든 POST 엔드포인트에서 반환됩니다.

스키마​

필드타입설명
job_idstring (UUID)생성된 작업의 고유 식별자

예시​

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000"
}

사용 엔드포인트​

  • POST /public/v1/generate/image
  • POST /public/v1/generate/effect/v1
  • POST /public/v1/generate/effect/v2
  • POST /public/v1/image-tune/upscale
  • POST /public/v1/image-tune/inpaint/v1
  • POST /public/v1/image-tune/inpaint/v2
  • POST /public/v1/image-tune/remove-background
  • POST /public/v1/image-tune/equip-variation
  • POST /public/v1/sprite/lite
  • POST /public/v1/sprite/plus
  • POST /public/v1/sprite/zenith
  • POST /public/v1/sprite/pulsar

GetJobStatusResponse​

작업 상태 조회 엔드포인트에서 반환됩니다.

스키마​

필드타입필수설명
job_idstring (UUID)예작업의 고유 식별자
statusstring예작업 상태 (Pending, Succeed, Failed)
image_urlsarray[string]아니오완료된 이미지 URL 목록 (Succeed 상태에서만 제공)

상태별 응답 예시​

Pending​

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "Pending",
  "image_urls": []
}

Succeed​

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "Succeed",
  "image_urls": ["https://cdn.aetherforgeai.com/images/abc123.png"]
}

Failed​

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "Failed",
  "image_urls": []
}

사용 엔드포인트​

  • GET /public/v1/job/{job_id}

관련 문서​