Una API para cada tarea

REST, JSON y un webhook.

Envíe un lote, sígalo y descargue el resultado. La referencia completa está en el portal para desarrolladores, junto a sus claves.

Claves

Cree claves en el portal para desarrolladores cuando su equipo haya pasado la verificación de empresa y añadido una tarjeta. Envíe la clave como token Bearer.

Las claves de prueba empiezan por ath_test_, procesan hasta 100 elementos por lote en las máquinas de Atheron y nunca cargan su tarjeta
Las claves reales empiezan por ath_live_ y ejecutan tareas reales
Una clave necesita el permiso nebula para enviar tareas
Las claves se muestran una sola vez y solo se guardan como hash

Abrir la documentación completa

Webhooks

Cuando un lote termina, enviamos batch.completed a su dirección de webhook, firmado para que pueda comprobar que viene de nosotros. Una entrega fallida se reintenta durante 3 días.

En la referencia completa

Inicio rápido
Tareas y modelos
Formatos de entrada
Resultados y conservación
Tareas compartibles y privadas
Tareas de ajuste fino
Webhooks y firmas
Errores y límites
Uso y facturación

Endpoints

Cada petición y cada respuesta es JSON.

POST /api/v1/nebula/batches
Enviar un lote: la tarea, el modelo, sus elementos, si es compartible y una dirección de webhook.
GET /api/v1/nebula/batches/{id}
El estado de un lote y cuántos fragmentos están terminados.
GET /api/v1/nebula/batches/{id}/results
Un enlace de corta duración al archivo de resultados, cuando el lote ha terminado.
POST /api/v1/nebula/batches/{id}/cancel
Detener un lote. Los fragmentos terminados se conservan y se facturan.
GET /api/v1/nebula/models
El catálogo de modelos, con la tarea, la licencia y los límites de cada uno.

Ejemplo

Enviar un lote

curl https://developers.aton-network.org/api/v1/nebula/batches \
  -H "Authorization: Bearer $ATHERON_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "embed",
    "model": "bge-base-en-v1.5",
    "shareable": false,
    "items": [
      { "id": "doc-1", "text": "Machine learning on a shared network." },
      { "id": "doc-2", "text": "Every result is checked twice." }
    ],
    "webhook": "https://example.com/hooks/nebula"
  }'

Consultarlo

curl https://developers.aton-network.org/api/v1/nebula/batches/bat_123 \
  -H "Authorization: Bearer $ATHERON_KEY"

{ "id": "bat_123", "state": "running", "shards": { "done": 12, "total": 40 } }

Abrir la documentación completa

¿Una pregunta que la documentación no responde? Hable con nuestro equipo.

Hablar con ventas