Introduction
What DebateTalk is and how to make your first API call.
What is DebateTalk
DebateTalk is an API platform that runs multiple AI models against each other in a structured debate to produce a more accurate, balanced, and reasoned answer than any single model could provide alone.
Instead of asking one model a question and trusting its reply, DebateTalk assembles a panel of models and runs them through blind and deliberation rounds. The platform checks for consensus and synthesizes a final answer from the positions that survive scrutiny.
The result is a debate transcript containing individual model positions, a consensus determination, a synthesized answer, and accuracy scores for each participant. Every call to the debate endpoint produces this structured output, streamed in real time as the debate unfolds.
Why Multi-Model Debate
A single AI model is trained on a specific dataset with a specific objective. It has blind spots, biases, and overconfidence in certain domains. When you pit multiple models against each other in an adversarial structure, those blind spots get surfaced rather than amplified.
A model that states something confidently in round one may revise its position in round two after encountering a stronger counterargument from another model. The debate structure forces reasoning rather than retrieval. Consensus has to be earned, not assumed.
This is especially valuable for high-stakes questions: business decisions, factual research, predictions, ethical dilemmas, and brainstorming where a narrow or overconfident answer would be worse than a broad, well-contested one.
DebateTalk is not about which model “wins.” It is about converging on the best available answer given the current state of AI knowledge. The platform treats model disagreement as a signal, not a failure.
Quick Start
The debate endpoint accepts a plain-text question and streams the debate back as Server-Sent Events. No setup is required to make your first call. Unauthenticated requests work out of the box but are rate limited to 3 per hour. Authenticated requests unlock the full feature set based on your plan.
Unauthenticated request
Pass your question as the question query parameter. The -N flag disables buffering so you see events as they arrive.
curl -N "https://engine.debatetalk.ai/debate?question=Is%20nuclear%20energy%20good%20for%20the%20climate%3F"Authenticated request
Include your API token in the Authorization header to use your full plan quota and access all available models.
curl -N "https://engine.debatetalk.ai/debate?question=Is%20nuclear%20energy%20good%20for%20the%20climate%3F" \
-H "Authorization: Bearer YOUR_TOKEN"JavaScript with EventSource
The browser-native EventSource API handles SSE reconnection automatically. Parse each message as JSON to access the structured event data. Close the connection when the final event arrives.
const url = new URL("https://engine.debatetalk.ai/debate")
url.searchParams.set("question", "Is nuclear energy good for the climate?")
const source = new EventSource(url.toString())
source.onmessage = (e) => {
const event = JSON.parse(e.data)
console.log(event.type, event.data)
}
source.addEventListener("final", () => source.close())YOUR_TOKEN with an API key from your dashboard. Never expose your token in client-side code or public repositories. Unauthenticated calls are capped at 3 per hour per IP address.How to Use These Docs
The documentation is organized into five sections. Each section covers a distinct part of the platform.
Introduction (this page) gives you the conceptual overview and your first working API call. How Debates Work explains the methodology in detail: how rounds are structured, how models are selected, how consensus is determined, and what the final synthesis represents. API Reference documents every endpoint with full request and response schemas. Models covers the available models, the roles they can play in a debate, and how the platform selects them. Plans and Limits compares tiers, explains the credit system, and lists rate limits.
Use the sidebar to navigate between pages. Within each page, every section heading is linkable. Click the hash icon next to any heading to copy a direct anchor link, or use the in-page section links in the sidebar to jump without scrolling.
Use the search shortcut (⌘K on Mac, Ctrl+K on Windows and Linux) to find specific topics across all pages quickly.