Ir para o conteúdo principal

Ciclo de Vida do Job Assíncrono

Todas as operações de geração na API AetherAI são processadas de forma assíncrona. Após criar um job, você deve verificar o status fazendo polling.

Criando um Job​

Ao enviar uma requisição POST, um job_id é retornado imediatamente. O processamento da imagem ocorre em segundo plano.

Exemplo de Requisição​

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"
}'

Exemplo de Resposta​

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

Fazendo Polling do Status do Job​

Envie uma requisição GET com o job_id retornado para verificar o status do job.

curl -X GET "https://api.aetherforgeai.com/public/v1/job/{job_id}" \
-H "Authorization: Bearer your_api_key_here"

Valores de Status​

StatusDescrição
PendingO job está aguardando ou em processamento
SucceedO job foi concluído com sucesso
FailedOcorreu um erro durante o processamento do job

Exemplos de Resposta por Status​

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",
"https://cdn.aetherforgeai.com/images/abc123.gif"
]
}

Failed​

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

Estratégia de Polling​

Recomendamos fazer polling nos seguintes intervalos para verificar a conclusão do job:

  • Polling inicial: 1 segundo após a criação do job
  • Intervalos subsequentes: 2-5 segundos
  • Tempo máximo de polling: 1 minuto (varia conforme o tipo de job)

Exemplo em Python​

import time
import requests

def poll_job_status(job_id, api_key, max_attempts=60):
headers = {"Authorization": f"Bearer {api_key}"}

for attempt in range(max_attempts):
response = requests.get(
f"https://api.aetherforgeai.com/public/v1/job/{job_id}",
headers=headers
)
data = response.json()

if data["status"] == "Succeed":
return data["image_urls"]
elif data["status"] == "Failed":
raise Exception(f"Job failed: {data.get('error_message', 'Unknown error')}")

time.sleep(2)

raise TimeoutError("Job polling timed out")

Documentação Relacionada​