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
- Entre na Anthra em /signin.
- Abra /account/api-keys.
- Dê um nome à chave (por exemplo, “Quickstart — laptop”), marque os escopos
books:write,generation:runepublish:writee clique em Criar chave. - 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
- Endpoints de geração — narração, reescrita e o que cada escopo libera.
- Configuração do MCP — conecte a Anthra ao Claude Desktop, Cursor ou Claude Code para rodar as mesmas operações pelo chat.