Resumen de la API
La API REST de AstrApp te deja crear proyectos y datasets, lanzar entrenamientos y chatear con modelos desde tu propio código.
URL base
https://app.astrapp.lat/api/v1Todas las rutas de esta referencia cuelgan de esa URL. Los ids de proyectos, datasets y entrenamientos son UUID. Los cuerpos van en JSON salvo la subida de archivos, que usa multipart/form-data.
Autenticación
Manda una API Key en el header Authorization:
Authorization: Bearer sk_live_…No todas las rutas aceptan API Key
Formato de respuesta
El resultado casi siempre viene en data, pero el sobre cambia según la ruta.
| Tipo | Forma | Ejemplo |
|---|---|---|
| Objeto | { "success": true, "data": { … } } | GET /projects/{projectId} |
| Lista paginada | { "success": true, "data": [ … ], "pagination": { … } } | GET /projects |
| Solo data | { "data": … } | GET /datasets, POST /chat |
La paginación trae total, page, per_page y total_pages, y se controla con los parámetros page y per_page (en proyectos, 20 por defecto y 100 como máximo). Algunas rutas responden fuera de este esquema, como POST /ingest: sigue el ejemplo de cada página.
Los errores tienen su propio formato, con error.code y error.message. Están en Códigos de error.
No es la API de OpenAI
POST /chat recibe model, messages, temperature, max_tokens y top_p como la API de OpenAI, pero responde con su propio formato. Un SDK de OpenAI no funciona sin adaptarlo.Secciones de la referencia
Endpoints
Todas las rutas, cuáles aceptan API Key y sus límites.
Proyectos
Crear, listar, actualizar y archivar proyectos.
Datasets
Crear datasets, importar archivos y leer sus ejemplos.
Entrenamiento
Lanzar un fine-tuning en una GPU rentada.
Inferencia
Chat con modelos por el proxy de AstrApp.
Códigos de error
Formato de error y códigos que devuelve la API.