Aller au contenu
NEBULA

nebula@atheron:/fr/docs$

// Documentation

Une API pour chaque tâche

REST, JSON et un webhook.

Soumettez un lot, suivez-le et téléchargez le résultat. La référence complète se trouve dans le portail des développeurs, à côté de vos clés.

Clés

Créez des clés dans le portail des développeurs une fois que votre équipe a passé la vérification d'entreprise et ajouté une carte. Envoyez une clé comme jeton Bearer.

  • Les clés de test commencent par ath_test_, traitent jusqu'à 100 éléments par lot sur les machines d'Atheron et ne débitent jamais votre carte
  • Les clés réelles commencent par ath_live_ et exécutent de vraies tâches
  • Une clé a besoin du droit nebula pour soumettre des tâches
  • Les clés sont affichées une seule fois et conservées seulement sous forme hachée
Ouvrir la documentation complète

Webhooks

Quand un lot se termine, nous envoyons batch.completed à votre adresse de webhook, signé pour que vous puissiez vérifier qu'il vient de nous. Une livraison en échec est relancée pendant 3 jours.

Dans la référence complète

  • Démarrage rapide
  • Tâches et modèles
  • Formats d'entrée
  • Résultats et conservation
  • Tâches partageables et privées
  • Tâches d'ajustement fin
  • Webhooks et signatures
  • Erreurs et limites
  • Utilisation et facturation

Points d'accès

Chaque requête et chaque réponse est en JSON.

  • POST /api/v1/nebula/batches

    Soumettre un lot : la tâche, le modèle, vos éléments, s'il est partageable et une adresse de webhook.

  • GET /api/v1/nebula/batches/{id}

    L'état d'un lot et le nombre de fragments terminés.

  • GET /api/v1/nebula/batches/{id}/results

    Un lien de courte durée vers le fichier de résultats, une fois le lot terminé.

  • POST /api/v1/nebula/batches/{id}/cancel

    Arrêter un lot. Les fragments terminés sont conservés et facturés.

  • GET /api/v1/nebula/models

    Le catalogue de modèles, avec la tâche, la licence et les limites de chacun.

Exemple

Soumettre un lot
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"
  }'
Le suivre
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 } }
Ouvrir la documentation complète

Une question à laquelle la documentation ne répond pas? Parlez à notre équipe.

Joindre les ventes