Início rápido

De uma conta nova a uma execução concluída e a uma chamada de API feita pelo seu próprio servidor. Leva cerca de cinco minutos.

1. Crie uma conta e adicione créditos

   Crie uma conta. Você se torna o proprietário de uma nova organização. As execuções são pré-pagas, então abra Faturamento e adicione créditos; $10 são mais que suficientes para começar.

   Os créditos aparecem assim que o Stripe confirma o pagamento, geralmente em alguns segundos.

2. Inicie uma execução no playground

   No painel, abra o Playground e escolha Testar um exemplo na página de Execuções, ou escreva seu próprio prompt. Pressione ⌘↵ para iniciar. A saída é transmitida à direita, ao lado de cada etapa que o worker executa.

   Toda execução tem uma página com sua saída, uma linha do tempo de eventos e o custo.

3. Crie uma chave de API

   Abra Chaves de API e crie uma chave de membro. Ela é exibida uma única vez, com um trecho pronto para colar no seu ambiente. Mantenha-a no seu servidor.

   Terminal

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

4. Inicie a mesma execução a partir do seu 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
     }'

   A resposta é 202 Accepted com o id da execução. A execução entra na fila e começa assim que um worker estiver livre.

5. Obtenha o resultado

   Consulte GET /v1/runs/{id} até que o status seja final: succeeded, failed, cancelled, timed_out ou interrupted. Depois espere billing_pending ser false, para que o custo esteja liquidado. A resposta de uma execução bem-sucedida está em output; em qualquer outro status final, error explica o motivo.

   cURLNode.jsCLI

   RUN_ID=run_4abb0f420c6623a12d2889610eb67284   # o id do passo 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"

   Se cost_micros não aparecer, ele é zero. Com --wait, a CLI retorna assim que o status é final; leia a execução de novo com ephemeral runs get se precisar do custo liquidado. Você também pode transmitir os eventos de GET /v1/runs/{id}/events. Para execuções longas, adicione um callback à requisição e o Ephemeral chama você quando terminar, sem que nada precise consultar.

   A resposta de uma execução concluída tem este formato.

   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
   }

Próximos passos

• Execute uma investigação real com arquivos, uma conexão e acesso à web.
• Salve o prompt como um fluxo de trabalho e inicie-o pelo nome.
• Dê à execução arquivos para ler e conexões para chamar.
• Saiba como os orçamentos mantêm cada execução dentro de um limite.