Imágenes

La generación de imágenes está representada en la navegación de documentos para que los documentos extranjeros mantengan un mapa de productos consistente. La disponibilidad de terminales públicos en el extranjero está basada en esquemas. Verifique GET /api/openapi.json antes de llamar a puntos finales de imágenes desde el código de producción.

Pedido

Cuando los puntos finales de imagen están habilitados, espere un modelo de tarea asíncrono: cree una tarea con un mensaje y opciones de modelo, luego realice una encuesta para completarla. Las solicitudes todavía utilizan la autenticación de portador:

Authorization: Bearer KITTA_API_KEY

No infieras rutas extranjeras a partir de otros documentos. Utilice únicamente rutas presentes en el esquema OpenAPI extranjero para el entorno implementado.

Respuesta

Las respuestas a las tareas de imagen suelen incluir la identificación de la tarea, el estado, la URL de la imagen del resultado en caso de éxito y un código de error en caso de error. Almacene la identificación de la tarea antes del sondeo para que los usuarios puedan recuperar el resultado después de actualizar la página o reiniciar el trabajador.

Facturación y créditos

La generación de imágenes puede cobrar por modelo, resolución, imágenes de referencia o tarea exitosa. Valide el tamaño del mensaje y los medios de entrada antes de crear una tarea y verifique Perfil antes de lotes grandes.

Errores

Maneje por separado el modelo no compatible, la imagen de referencia no válida, los créditos insuficientes y el error de procesamiento. Si no hay puntos finales de imagen en GET /api/openapi.json, trate la capacidad como no disponible públicamente para la cuenta.

Endpoints OpenAPI canónicos

• Listar modelos: GET /api/open/v1/media/models?mediaType=image
• Generar imagen: POST /api/open/v1/media/images/jobs
• Consultar tarea: GET /api/open/v1/media/images/jobs/{jobId}

Cada solicitud de creación debe incluir un encabezado Idempotency-Key único. La API usa cuota de API, no créditos de la suscripción web, y reembolsa la cuota de forma idempotente si falla el proveedor, el almacenamiento o la persistencia.