# Wizard API

{% hint style="info" %}
Chat API has been deprecated in favor of the [Universal Agents](/launch/universal-agents.md#aikek-wizard), the new method of delivering AIKEK [Universal Agents](/launch/universal-agents.md) and [Fractal](/fractal.md) data infra to builders.
{% endhint %}

## Knowledge Ask Json

> Answer a question using the Fractal knowledge engine.\
> \
> This endpoint returns a JSON object with \`answer\`, \`sources\`, and \`sentiment\` fields.\
> Sentiment is a domain-agnostic integer in the \[1, 10] range, where 1 is very negative\
> and 10 is very positive.

```json
{"openapi":"3.1.0","info":{"title":"FastAPI","version":"0.1.0"},"security":[{"HTTPBearer":[]}],"components":{"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}},"schemas":{"KnowledgeAskJSONPayload":{"properties":{"question":{"type":"string","title":"Question","description":"User question"},"search_mode":{"type":"string","enum":["deep","fast","ultrafast"],"title":"Search Mode","description":"Retrieval depth preset","default":"fast"}},"type":"object","required":["question"],"title":"KnowledgeAskJSONPayload","description":"Payload for the JSON-mode knowledge ask endpoint.\n\nAttributes\n----------\nquestion: str\n    The user's question to answer.\nsearch_mode: Literal[\"deep\", \"fast\", \"ultrafast\"]\n    Retrieval depth preset. Controls number of documents fetched."},"KnowledgeAskJSONResponse":{"properties":{"answer":{"type":"string","title":"Answer"},"sources":{"items":{"type":"string"},"type":"array","title":"Sources"},"sentiment":{"type":"integer","maximum":10,"minimum":1,"title":"Sentiment"}},"type":"object","required":["answer","sources","sentiment"],"title":"KnowledgeAskJSONResponse","description":"Response model for JSON-mode knowledge ask.\n\nAttributes\n----------\nanswer: str\n    Final answer text. Markdown is allowed.\nsources: list[str]\n    Deduplicated list of source URLs used for the answer.\nsentiment: int\n    Domain-agnostic sentiment on a 1–10 scale (1 very negative, 10 very positive)."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/knowledge/ask":{"post":{"tags":["knowledge"],"summary":"Knowledge Ask Json","description":"Answer a question using the Fractal knowledge engine.\n\nThis endpoint returns a JSON object with `answer`, `sources`, and `sentiment` fields.\nSentiment is a domain-agnostic integer in the [1, 10] range, where 1 is very negative\nand 10 is very positive.","operationId":"knowledge_ask_json_knowledge_ask_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeAskJSONPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeAskJSONResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

***

## Chat API Costs

Wizard API has a flat fee of 2 credits per request. Learn more about API Credits at [API Pricing](/developers/api-pricing.md).

{% content-ref url="/pages/rGRrhRvj2BZTVn8ueTRj" %}
[API Usage Examples](/developers/api-usage-examples.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.alphakek.ai/developers/wizard-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.