Consultar 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
Cargo de esta tarea en CNY (el mismo cargo que cost_usd); suele ser 0 si la generación falla, y el cargo real si falla después de liquidarse el cobro
Importe en USD realmente descontado del saldo por esta tarea, el mismo que su registro de uso
Moneda de cost, siempre CNY
Errores
missing_api_key / invalid_api_key / api_key_expired)