Obtener detalles de la tarea

GEThttps://97ai.97claude.com/api/generate/{taskId}

Consulta el estado y el resultado de una tarea de generación asíncrona por su taskId (parámetro de ruta). Sondea este endpoint cada pocos segundos hasta que state sea success o fail.

state es uno de: waiting, queuing, generating, success, fail
En caso de éxito, resultUrls contiene las URLs del contenido generado (o resultText para salida de texto)
creditsConsumed refleja el costo real facturado; las tareas fallidas no se facturan
balance es tu saldo de créditos restante tras la liquidación

Solicitud

Autorización

Proporciona tu token Bearer en el encabezado Authorization.

Authorization: Bearer <YOUR_API_KEY>

Parámetros de consulta

taskIdstring (path)obligatorio

El identificador de la tarea devuelto por POST /api/generate.

Ejemplo: task_12345678

Respuestas

200 · Respuesta exitosa — application/json

taskIdstringobligatorio

Identificador de la tarea

Ejemplo: task_12345678

statestringobligatorio

waiting | queuing | generating | success | fail

Ejemplo: success

resultUrlsstring[]opcional

URLs del contenido generado cuando state es success

Ejemplo: ["https://.../out.jpg"]

resultTextstringopcional

Salida de texto para modelos que producen texto

creditsConsumedintegerobligatorio

Créditos realmente facturados por esta tarea

Ejemplo: 5

failMsgstringopcional

Mensaje de error cuando state es fail

balanceintegerobligatorio

Tu saldo de créditos restante

Ejemplo: 1950

Códigos de estado

Código	Descripción
200	Éxito — la solicitud se procesó correctamente
400	Solicitud incorrecta — parámetros incorrectos o ausentes
401	No autorizado — credenciales de autenticación ausentes o no válidas
405	Método no permitido — el método de la solicitud no es compatible
500	Error del servidor — ocurrió un error inesperado, reinténtalo

Ejemplos

Solicitud — cURL

cURL

curl -X GET "https://97ai.97claude.com/api/generate/task_12345678" \
  -H "Authorization: Bearer YOUR_API_KEY"

Respuesta — 200

JSON

{
  "taskId": "task_12345678",
  "state": "success",
  "resultUrls": ["https://example.com/generated.jpg"],
  "resultText": null,
  "creditsConsumed": 5,
  "failMsg": "",
  "balance": 1950
}