HopBase DocsConsultar una tarea de imagen
Consulta el estado y el resultado de las tareas asíncronas de imagen de GPT Image / Gemini (`Prefer: respond-async`).
/v1/images/tasksCon Prefer: respond-async, Generar imágenes o Editar imágenes devuelven de inmediato 202 y task_id; después consulte con este endpoint. El ID de tarea solo puede ir en el parámetro de consulta task_id; no se admite en la ruta.
Los estados son, en orden, pending / processing / retrying; los estados finales son completed y failed. Al terminar, lea result_content: una línea  con ruta relativa por imagen; anteponga https://api.hop-base.com para abrirla. Esa dirección se abre sin clave: no la comparta públicamente, descárguela a su propio almacenamiento lo antes posible y no la use como almacenamiento a largo plazo.
Solo los problemas que aparecen durante la generación (como una imagen de referencia de Gemini que no se puede descargar o un rechazo del modelo) hacen fallar la tarea; en ese caso solo se devuelve una cadena error, sin código de error. Al enviar solo se comprueba que el saldo sea mayor que 0, sin reservar importe; tras el estado final, usage muestra el cargo real y solo lo ve la clave que creó la tarea.
Las imágenes de Kling y Midjourney no pasan por aquí; use Consultar una tarea de video.
Encabezados
Bearer sk-…: una clave de API creada en la consola; su grupo debe incluir el modelo solicitado
Parámetros de consulta
El task_id devuelto al enviar
Longitud≥ 1 caracteres
Respuesta
200Objeto de tarea (incluidas las fallidas)
ID de la tarea
pending / processing / retrying están en curso; completed / failed son estados finales
Valorespendingprocessingretryingcompletedfailed
Resultado al terminar: Markdown, una línea  por imagen. La dirección es relativa; anteponga https://api.hop-base.com para acceder. Se abre sin clave: no la comparta públicamente y descárguela y guárdela lo antes posible
Motivo del fallo (cadena en inglés, sin código de error); solo aparece con failed
Aparece cuando la tarea está en completed o failed; solo lo ve la clave que creó la tarea
Importe realmente descontado del saldo por esta tarea; suele ser 0 si la generación falla, y el cargo real si falla después de liquidarse el cobro
Moneda contable, actualmente CNY
Importe en CNY (conversión fija 1 USD = 6.8 CNY), para conciliación
Importe en USD, para conciliación
Errores
missing_api_key / invalid_api_key / api_key_expired)