Inicio rápido

Desde una cuenta nueva hasta una ejecución terminada y una llamada a la API desde tu propio servidor. Lleva unos cinco minutos.

1. Crea una cuenta y recarga créditos

   Crea una cuenta. Pasas a ser el propietario de una nueva organización. Las ejecuciones son de prepago, así que abre Facturación y recarga créditos; $10 son más que suficientes para empezar.

   Los créditos aparecen en cuanto Stripe confirma el pago, normalmente en cuestión de segundos.

2. Inicia una ejecución en el playground

   En el panel, abre Playground y elige Probar un ejemplo en la página de Ejecuciones, o escribe tu propio prompt. Pulsa ⌘↵ para iniciarla. El resultado llega en directo a la derecha, junto a cada paso que da el worker.

   Cada ejecución tiene una página con su resultado, una cronología de eventos y lo que costó.

3. Crea una clave de API

   Abre Claves de API y crea una clave de miembro. Se muestra una sola vez, con un fragmento listo para pegar en tu entorno. Mantenla en tu servidor.

   Terminal

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

4. Inicia la misma ejecución desde tu código

   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 respuesta es 202 Accepted con el id de la ejecución. La ejecución se pone en cola y empieza en cuanto un worker queda libre.

5. Obtén el resultado

   Consulta GET /v1/runs/{id} repetidamente hasta que el estado sea final: succeeded, failed, cancelled, timed_out o interrupted. Después espera a que billing_pending sea false, para que el coste esté liquidado. La respuesta de una ejecución correcta está en output; en cualquier otro estado final, error explica el motivo.

   cURLNode.jsCLI

   RUN_ID=run_4abb0f420c6623a12d2889610eb67284   # el id del paso anterior
   
   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"

   Si falta cost_micros, significa cero. Con --wait la CLI termina en cuanto el estado es final, así que vuelve a leer la ejecución con ephemeral runs get si necesitas el coste liquidado. También puedes transmitir los eventos desde GET /v1/runs/{id}/events. Para ejecuciones largas, añade a la solicitud un callback y Ephemeral te avisa cuando termine, sin que nada tenga que consultar.

   La respuesta de una ejecución terminada tiene este aspecto.

   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
   }

Siguientes pasos

• Ejecuta una investigación real con archivos, una conexión y acceso web.
• Guarda el prompt como un flujo de trabajo e inícialo por su nombre.
• Da a la ejecución archivos que leer y conexiones a las que llamar.
• Descubre cómo los presupuestos mantienen cada ejecución dentro de un límite.