Conecta tus agentes a AI360 con una clave

Usa nuestra API para integrar tus agentes con la plataforma AI360. Obtén una clave de acceso y autentica tus peticiones con el encabezado Authorization: Bearer ai360_TU_CLAVE.

Autenticación

Toda petición debe incluir la cabecera Authorization con el valor Bearer ai360_TU_CLAVE. Sin ella, la respuesta es 401.

Tu clave es un secreto: no la publiques en un repositorio, en el navegador ni en una captura. Si se te escapa, revócala y genera otra.

Endpoints disponibles

POST /api/v1/agents/run

Ejecuta una tarea en uno de tus agentes.

{
  "ok": true,
  "job_id": "string",
  "output": "string",
  "turns_used": 123,
  "events_count": 456
}

Códigos de error:

401 — Clave inválida o encabezado ausente
403 — Clave revocada, expirada o sin permiso agents
429 — Límite de tasa excedido o cuota mensual agotada

GET /api/v1/agents/status

Obtén el estado de un trabajo en ejecución o finalizado.

{
  "ok": true,
  "job_id": "string",
  "status": "pending|running|completed|failed",
  "progress": 0.75
}

Códigos de error: los mismos que en /run.

GET /api/v1/agents/stream

Obtén la salida en tiempo real de un trabajo.

{
  "ok": true,
  "job_id": "string",
  "events": [
    { "timestamp": "string", "type": "string", "data": "string" }
  ]
}

Códigos de error: los mismos que en /run.

Ejemplo con curl

curl -X POST https://tuai360.com/api/v1/agents/run \
  -H "Authorization: Bearer ai360_TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{"task":"ejecutar algo"}'

Límites

Ritmo de llamadas: depende de la clave, típicamente 30 por minuto.
Tokens al mes: depende de la clave contratada.