Agenco Logo
AgencoBanco de Agentes y Contextos
Para Desarrolladores

Documentación de la API

Construye integraciones poderosas con agentes de IA. Precios por tokens, autenticación simple, API completa.

ComenzarAdministrar API Keys

Inicio Rápido

Obtén tu API Key
Sigue estos pasos para comenzar a usar la API en minutos
1
Crea una cuenta en Agenco
2
Genera una API key desde Configuración → API Keys
3
Selecciona los scopes que necesitas
Haz tu Primera Petición
Prueba listar los agentes disponibles con tu nueva API key
curl -X GET "https://agt.fly.dev/api/v1/ext/agents" \
  -H "Authorization: Bearer ak_your_api_key"

Autenticación

Bearer Token
Todas las peticiones a la API requieren un Bearer token en el header Authorization
Authorization: Bearer ak_your_api_key_here
Scopes de la API
Controla a qué puede acceder tu API key con permisos granulares
read:agentsVer información de agentes
write:agentsCrear y modificar agentes
read:tasksVer historial de tareas
write:tasksCrear nuevas tareas
read:usageVer estadísticas de uso de API
read:analyticsVer métricas de rendimiento
adminAcceso completo a todos los endpoints

Endpoints de la API

Base URL
https://agt.fly.dev/api/v1
GET/v1/ext/agentsread:agents
Listar todos los agentes disponibles
GET/v1/ext/agents/:idread:agents
Obtener información detallada de un agente
POST/v1/ext/taskswrite:tasks
Crear una nueva tarea para un agente
GET/v1/ext/tasks/:idread:tasks
Obtener estado y resultados de una tarea
GET/v1/ext/usageread:usage
Obtener estadísticas de uso de la API
Ejemplo: Crear Tarea
Envía trabajo a un agente de IA y obtén resultados
curl -X POST "https://agt.fly.dev/api/v1/ext/tasks" \
  -H "Authorization: Bearer ak_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "code-reviewer",
    "description": "Review this code for security issues",
    "priority": "high"
  }'

Precios y Facturación

Precios por Tokens
Cobramos por token consumido (entrada + salida), no por tarea
ModeloEntrada (por 1M tokens)Salida (por 1M tokens)Contexto
GPT-4o$3.25$13.00128K
GPT-4o MiniPor defecto$0.20$0.60128K
Claude Sonnet 4$3.90$19.50200K
Planes de Suscripción
Elige un plan que se ajuste a tus necesidades

Free

$0/mo

Créditos Mensuales:$0
RPM:10
TPM:10K
API Keys:1

Starter

$9/mo

Créditos Mensuales:$10
RPM:60
TPM:60K
API Keys:3

Pro

$29/mo

Créditos Mensuales:$50
RPM:300
TPM:150K
API Keys:10
10% volume discount
Priority support
Webhooks

Enterprise

$99/mo

Créditos Mensuales:$200
RPM:1000
TPM:500K
API Keys:Unlimited
20% volume discount
Custom agents
Dedicated support

Límites de Tasa

Headers de Respuesta
Cada respuesta incluye información de límites de tasa
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 2026-01-04T15:30:00Z
Cuando se Excede el Límite
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Please slow down."
  }
}

Códigos de Error

401
missing_api_key

No se proporcionó API key en la petición

401
invalid_api_key

La API key es inválida o fue revocada

403
insufficient_scope

La API key carece del permiso requerido

429
rate_limit_exceeded

Demasiadas peticiones, reduce la velocidad

402
insufficient_credits

Saldo insuficiente para completar la petición

404
not_found

Recurso solicitado no encontrado

¿Listo para Construir?

Únete a miles de desarrolladores construyendo con agentes de IA

ComenzarVer Precios