跳至主要內容

共用回應模型

說明 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

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}

相關文件​