Schnellstart

Vom neuen Konto zur abgeschlossenen Ausführung und zum API-Aufruf von Ihrem eigenen Server. Das dauert etwa fünf Minuten.

1. Konto erstellen und Guthaben aufladen

   Erstellen Sie ein Konto. Sie werden Inhaber einer neuen Organisation. Ausführungen werden vorausbezahlt: Öffnen Sie Abrechnung und laden Sie Guthaben auf; $10 reichen für den Anfang völlig aus.

   Das Guthaben erscheint, sobald Stripe die Zahlung bestätigt, in der Regel innerhalb weniger Sekunden.

2. Ausführung im Playground starten

   Öffnen Sie im Dashboard den Playground und wählen Sie auf der Seite „Ausführungen“ Beispiel ausprobieren oder schreiben Sie einen eigenen Prompt. Mit ⌘↵ starten Sie ihn. Die Ausgabe erscheint rechts als Stream, neben jedem Schritt des Workers.

   Jede Ausführung hat eine eigene Seite mit ihrer Ausgabe, einem Zeitverlauf der Ereignisse und den entstandenen Kosten.

3. API-Schlüssel erstellen

   Öffnen Sie API-Schlüssel und erstellen Sie einen Mitgliedsschlüssel. Er wird nur einmal angezeigt, zusammen mit einem Snippet, das Sie direkt in Ihre Umgebung einfügen können. Bewahren Sie ihn auf Ihrem Server auf.

   Terminal

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

4. Dieselbe Ausführung aus Ihrem Code starten

   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
     }'

   Die Antwort lautet 202 Accepted und enthält die id der Ausführung. Die Ausführung wird in die Warteschlange gestellt und startet, sobald ein Worker frei ist.

5. Ergebnis abrufen

   Fragen Sie GET /v1/runs/{id} ab, bis der Status final ist: succeeded, failed, cancelled, timed_out oder interrupted. Warten Sie danach, bis billing_pending den Wert false hat, damit die Kosten abgerechnet sind. Die Antwort einer erfolgreichen Ausführung steht in output; bei jedem anderen finalen Status erklärt error den Grund.

   cURLNode.jsCLI

   RUN_ID=run_4abb0f420c6623a12d2889610eb67284   # die id aus dem vorherigen Schritt
   
   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"

   Fehlt cost_micros, bedeutet das null. Mit --wait kehrt die CLI zurück, sobald der Status final ist; lesen Sie die Ausführung mit ephemeral runs get erneut, wenn Sie die abgerechneten Kosten brauchen. Sie können auch Ereignisse über GET /v1/runs/{id}/events streamen. Bei langen Ausführungen können Sie der Anfrage einen Callback mitgeben; Ephemeral ruft Sie dann auf, sobald die Ausführung beendet ist, und nichts muss abgefragt werden.

   Die Antwort einer beendeten Ausführung sieht so aus.

   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
   }

Nächste Schritte

• Führen Sie eine echte Untersuchung mit Dateien, einer Verbindung und Webzugriff aus.
• Speichern Sie den Prompt als Workflow und starten Sie ihn über den Namen.
• Geben Sie der Ausführung Dateien zum Lesen und Verbindungen zum Aufrufen.
• Erfahren Sie, wie Budgets jede Ausführung innerhalb eines Limits halten.