Documentación

Guías técnicas, referencias de API y descripciones generales de la arquitectura para la red AIL2.

Introducción a AIL2

AIL2 es una solución de escalado de Capa 2 diseñada específicamente para cargas de trabajo de Inteligencia Artificial. Salva la brecha entre los masivos requisitos de cómputo y el consenso de blockchain distribuido, escalando la inteligencia al infinito.

Nota: La Beta de la Red Principal de AIL2 está actualmente en vivo. Los desarrolladores pueden comenzar a desplegar modelos en nuestra red GPU distribuida inmediatamente.

1. Instalación del SDK

Para comenzar a desarrollar con AIL2, instale nuestro SDK principal y sus dependencias pares. El SDK proporciona todas las herramientas necesarias para interactuar con la red AIL2, enviar tareas de inferencia y gestionar modelos.

bash
npm install @ail2/sdk ethers

Después de la instalación, puede importar el SDK en su proyecto y configurar su ID de proyecto y clave API para la inicialización:

javascript
import { AIL2Client } from '@ail2/sdk';

const client = new AIL2Client({
  projectId: 'your_project_id_here', // 从开发者控制台获取
  apiKey: 'your_api_key_here' // 妥善保管你的密钥
});

2. Lance en 5 Minutos

Después de obtener su project_id desde la consola de desarrollador, puede comenzar a construir con una sola llamada a la API. A continuación se muestra un ejemplo completo para enviar una tarea de inferencia al modelo nebula-ai:

bash
curl -X POST "https://api.ail2.network/v1/infer" \
  -H "Authorization: Bearer $AIL2_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "p_12345",
    "model_id": "nebula-ai",
    "input": {"prompt": "Explain decentralized AI in simple terms"}
  }'

Ejemplo de respuesta:

json
{
  "task_id": "task_abc678def",
  "status": "processing",
  "results": "Decentralized AI distributes computation across a network..."
}

3. Conceptos Básicos

Prueba de Inferencia

El mecanismo de consenso central de la red AIL2. A través de la tecnología Optimistic ZK-Rollup, verifica criptográficamente que el proceso de ejecución de modelos de IA por parte de nodos de cómputo no confiables coincide exactamente con lo esperado, asegurando la corrección de los resultados de inferencia descentralizados y proporcionando la base de incentivos para nodos honestos.

Canales de Estado

Una capa de transacción fuera de la cadena eficiente diseñada para lograr escalabilidad infinita. Permite a los usuarios realizar microtransacciones de alta frecuencia e interacciones de estado fuera del Core Rollup de AIL2, sincronizándose con la blockchain subyacente solo en el momento de la liquidación final, mejorando enormemente la composibilidad y la experiencia del usuario de las aplicaciones de IA.

Economía de Tokens

La capa de incentivos del ecosistema AIL2. Los tokens se utilizan para pagar los recursos de cómputo de la red (GPU), hacer staking para convertirse en nodos validadores, participar en la gobernanza y recompensar a los participantes que proporcionan poder de cómputo, almacenamiento y servicios de validación a la red, impulsando el funcionamiento continuo de toda la red de IA descentralizada.

4. REFERENCIA DE API

API de InferenciaPOST/v1/infer

El punto final central para enviar tareas de inferencia de modelos de IA.

Request Body Parameters

  • project_id
    STRING / REQUIRED

    Identificador único de tu proyecto.

  • model_id
    STRING / REQUIRED

    ID del modelo a invocar (ej. nebula-ai).

  • input
    OBJECT / REQUIRED

    Datos de entrada específicos del modelo, generalmente contiene campos como prompt.

  • parameters
    OBJECT / OPTIONAL

    Parámetros de inferencia opcionales, como temperature, max_tokens.

Respuesta: Devuelve un objeto JSON que contiene task_id, status y results asincrónicos.

Registro de ModelosGET/v1/models

Punto final para consultar la lista de modelos de IA disponibles u obtener detalles de un modelo específico.

Query Parameters

id
STRING / OPTIONAL

Especifica el ID del modelo para obtener su información detallada. Si se omite, devuelve la lista.

Respuesta: Devuelve un array de modelos o un solo objeto de modelo, que contiene metadatos como ID, nombre, descripción, formatos de entrada/salida, etc.

5. Facturación y Uso

AIL2 adopta un modelo de facturación por uso real. Las tarifas se calculan en función de la complejidad del modelo de IA invocado, la duración del cómputo de GPU consumida (en segundos) y el volumen de datos procesados (número de tokens de entrada/salida).

Ver uso y saldo

Puede ver los detalles del consumo de recursos, el saldo restante y el historial de facturación del proyecto actual en tiempo real en el panel 'Billing' de la consola de desarrollador.

Alertas de facturación

El sistema enviará un recordatorio por correo electrónico cuando su saldo caiga por debajo del umbral establecido, asegurando que su servicio de IA no se interrumpa por saldo insuficiente.

Métodos de pago (Soporte Multi-cadena)

Actualmente se admite la liquidación a través del token nativo AIL2 en las siguientes seis cadenas de blockchain principales, aprovechando plenamente la ventaja multi-cadena de AIL2 como una capa IA unificada:

ETHBSCGIWAXLayerBaseMantle