Início rápido

Em cerca de cinco minutos, você vai gerar uma chave de API, criar um livro a partir de uma premissa de uma linha, gerar o esboço, escrever o primeiro capítulo e publicá-lo em uma URL pública — tudo pela linha de comando.

1. Gere uma chave de API

  1. Entre na Anthra em /signin.
  2. Abra /account/api-keys.
  3. Dê um nome à chave (por exemplo, “Quickstart — laptop”), marque os escopos books:write, generation:run e publish:write e clique em Criar chave.
  4. Copie o token (ele começa com ant_live_) — esta é a única vez que ele será exibido.
export ANTHRA_TOKEN="ant_live_…paste here…"
export ANTHRA_BASE="https://anthra.com/api/v1"

2. Crie um livro

curl -X POST "$ANTHRA_BASE/books" \
  -H "authorization: Bearer $ANTHRA_TOKEN" \
  -H "content-type: application/json" \
  -d '{
    "premise": "A travel memoir about a year spent walking the old salt roads of southern Europe.",
    "genre": "Memoir",
    "modelTier": "sonnet"
  }'

A resposta inclui o id do livro. Guarde-o:

export BOOK_ID="…uuid…"

3. Gere o esboço

Esta chamada é síncrona (10–60 s). Quando ela retorna, o livro já tem título, subtítulo, descrição, cor de capa e uma lista inicial de capítulos.

curl -X POST "$ANTHRA_BASE/books/$BOOK_ID/outline" \
  -H "authorization: Bearer $ANTHRA_TOKEN"

4. Escreva o primeiro capítulo

O endpoint de escrita transmite a prosa como text/plain e salva o capítulo quando o stream termina. Redirecione direto para um arquivo:

# Get the first chapter id from the outline response, or list them:
CH_ID=$(curl -s "$ANTHRA_BASE/books/$BOOK_ID" \
  -H "authorization: Bearer $ANTHRA_TOKEN" \
  | python -c "import sys,json; print(json.load(sys.stdin)['data']['chapters'][0]['id'])")

curl -N -X POST "$ANTHRA_BASE/books/$BOOK_ID/chapters/$CH_ID/write" \
  -H "authorization: Bearer $ANTHRA_TOKEN"

Continue chamando /write para cada capítulo, em ordem — o escritor usa o final do capítulo anterior para manter a continuidade.

5. Publique

curl -X POST "$ANTHRA_BASE/books/$BOOK_ID/publish" \
  -H "authorization: Bearer $ANTHRA_TOKEN" \
  -H "content-type: application/json" \
  -d '{ "publish": true, "visibility": "unlisted" }'

A resposta inclui readerUrl — compartilhe.

Acesse todo o conjunto de ferramentas

Tudo o que o agente do app faz (mais de 300 ferramentas — análise de prosa, o painel de especialistas, continuidade e construção de mundo, edição estrutural, colaboração e mais) está disponível pelo gateway genérico de ferramentas. Liste o catálogo e chame qualquer ferramenta pelo nome:

# Every tool + its JSON Schema
curl "$ANTHRA_BASE/tools" \
  -H "authorization: Bearer $ANTHRA_TOKEN"

# Invoke one by name
curl -X POST "$ANTHRA_BASE/tools/generate_outline" \
  -H "authorization: Bearer $ANTHRA_TOKEN" \
  -H "content-type: application/json" \
  -d '{ "bookId": "'"$BOOK_ID"'" }'

Próximos passos