Démarrage rapide

D'un nouveau compte à une exécution terminée, puis à un appel d'API depuis votre propre serveur. Comptez environ cinq minutes.

1. Créer un compte et recharger des crédits

   Créez un compte. Vous devenez propriétaire d'une nouvelle organisation. Les exécutions sont prépayées : ouvrez Facturation et rechargez des crédits ; $10 suffisent largement pour commencer.

   Les crédits apparaissent dès que Stripe confirme le paiement, généralement en quelques secondes.

2. Lancer une exécution dans le playground

   Dans le tableau de bord, ouvrez Playground et choisissez Essayer un exemple sur la page Exécutions, ou écrivez votre propre prompt. Appuyez sur ⌘↵ pour la lancer. La sortie s'affiche en direct à droite, à côté de chaque étape franchie par le worker.

   Chaque exécution a sa page, avec sa sortie, une chronologie des événements et son coût.

3. Créer une clé API

   Ouvrez Clés API et créez une clé de membre. Elle n'est affichée qu'une fois, avec un extrait prêt à coller dans votre environnement. Gardez-la sur votre serveur.

   Terminal

   export EPHEMERAL_URL=https://app.ephemer.al
   export EPHEMERAL_API_KEY=eak_…

4. Lancer la même exécution depuis votre code

   cURLNode.jsCLI

   curl $EPHEMERAL_URL/v1/runs \
     -H "Authorization: Bearer $EPHEMERAL_API_KEY" \
     -H "Content-Type: application/json" \
     -H "Idempotency-Key: $(uuidgen)" \
     -d '{
       "prompt": "Summarize the input in one sentence",
       "input": { "text": "The export finished but two invoices are missing." },
       "max_cost_micros": 500000
     }'

   La réponse est 202 Accepted, avec l'id de l'exécution. L'exécution est mise en file d'attente et démarre dès qu'un worker est libre.

5. Récupérer le résultat

   Interrogez GET /v1/runs/{id} jusqu'à ce que le statut soit final : succeeded, failed, cancelled, timed_out ou interrupted. Attendez ensuite que billing_pending vaille false, pour que le coût soit réglé. La réponse d'une exécution réussie se trouve dans output ; pour tout autre statut final, error en donne la raison.

   cURLNode.jsCLI

   RUN_ID=run_4abb0f420c6623a12d2889610eb67284   # l'id de l'étape précédente
   
   while true; do
     RUN=$(curl -sf "$EPHEMERAL_URL/v1/runs/$RUN_ID" \
       -H "Authorization: Bearer $EPHEMERAL_API_KEY") || exit 1
     case $(jq -r .status <<<"$RUN") in
       succeeded|failed|cancelled|timed_out|interrupted)
         [ "$(jq -r .billing_pending <<<"$RUN")" = false ] && break ;;
     esac
     sleep 2
   done
   
   jq '{status, output, error, cost_micros}' <<<"$RUN"

   Un cost_micros absent signifie zéro. Avec --wait, la CLI rend la main dès que le statut est final : relisez l'exécution avec ephemeral runs get si vous avez besoin du coût réglé. Vous pouvez aussi suivre les événements en flux via GET /v1/runs/{id}/events. Pour les exécutions longues, ajoutez un callback à la requête : Ephemeral vous appelle à la fin, et rien n'a besoin d'interroger.

   La réponse d'une exécution terminée ressemble à ceci.

   GET /v1/runs/run_…

   {
     "id": "run_4abb0f420c6623a12d2889610eb67284",
     "status": "succeeded",
     "output": "Two invoices are missing from an otherwise complete export.",
     "cost_micros": 3120,
     "max_cost_micros": 500000,
     "billing_pending": false
   }

Étapes suivantes

• Lancez une vraie investigation avec des fichiers, une connexion et un accès web.
• Enregistrez le prompt comme workflow et lancez-le par son nom.
• Donnez à l'exécution des fichiers à lire et des connexions à appeler.
• Découvrez comment les budgets maintiennent chaque exécution dans une limite.