# FaithGPT

> Gospel-centered Bible AI companion for Bible study, prayer, Scripture clarity, Christian content workflows, benchmarks, and API integrations.

## Primary URLs

- [Home](https://www.faithgpt.io/)
- [API](https://www.faithgpt.io/api)
- [API Docs JSON](https://www.faithgpt.io/api/faithgpt-api.docs.json)
- [OpenAPI](https://www.faithgpt.io/api/openapi.json)
- [Runtime Answer API](https://api.faithgpt.io/v1/faithgpt/answer)
- [Runtime Chat API](https://api.faithgpt.io/v1/chat/completions)
- [Runtime Models API](https://api.faithgpt.io/v1/models)
- [Runtime Usage API](https://api.faithgpt.io/v1/usage)
- [Benchmarks](https://www.faithgpt.io/benchmarks)
- [Benchmark Methodology](https://www.faithgpt.io/benchmarks/methodology)
- [3D Bible Worlds — explorable 3D scenes of biblical places](https://www.faithgpt.io/bible-scenes)
- [Voxel Bible Worlds — playable block-built 3D Bible worlds](https://www.faithgpt.io/voxel-worlds)
- [System Status — live service health and incidents](https://www.faithgpt.io/status)
- [Video Studio — AI Bible video creation](https://www.faithgpt.io/video-studio)
- [Bible Games & Quizzes — free Bible trivia, quizzes, Scripture memory games, and study tools](https://www.faithgpt.io/bible-games)

## API Notes

- Responses are clean Markdown (POST /v1/faithgpt/answer) or OpenAI-compatible JSON (POST /v1/chat/completions).
- API access requires a signed-in account on an active Max plan with API access and a valid bearer key.
- Credit usage is backend-calculated: reserved before generation, reconciled after, and reported as credits_charged.
- Read /v1/usage for authoritative usage, caps, and recent requests.
- API use is governed by the Terms of Service API Use section: https://www.faithgpt.io/terms#api-terms
- See https://www.faithgpt.io/api/security for security best practices.

## Per-request options (POST /v1/faithgpt/answer and POST /v1/chat/completions)

- response_format: "markdown" (default), "text", or "tagged" (keeps client-renderable <bible>/<expand> tags).
- include_thinking: true returns the model's reasoning (costs extra output tokens).
- include_tool_calls: true returns which tools the model invoked.
- tools: array enabling any of the tools below. Every tool's tokens and provider cost are added to credits_charged.

## FaithGPT API tools

- bible_lookup: Fetch the exact text of a Bible reference from the FaithGPT Bible database. Read-only. Trigger: Add "bible_lookup" to the tools array; the model calls it when an answer needs verse text.
- compare_translations: Compare how multiple translations render a passage, with optional original-language notes. Trigger: Add "compare_translations" to the tools array.
- commentary_lookup: Retrieve public-domain classic Bible commentary for a passage or keyword. Trigger: Add "commentary_lookup" to the tools array.
- verse_finder: Find Bible verses by topic, theme, or keyword. Trigger: Add "verse_finder" to the tools array.
- web_search: Search the web for current information and return a synthesized, sourced answer. Trigger: Add "web_search" to the tools array; the model calls it for time-sensitive or factual lookups.
- doctrine_guard: Review text for theological soundness against historic Christian orthodoxy. Trigger: Add "doctrine_guard" to the tools array; the model calls it to vet doctrinal claims.
- generate_devotional: Produce a short devotional (title, scripture, reflection, prayer) for a theme or verse. Trigger: Add "generate_devotional" to the tools array.