Ask
Answers a question from what was said in your recordings, in Markdown, with citations: the recording, where in it, and the words. About one recording: $0.05; across several (up to 40): $0.15. Charged only when it answers.
Authorization
apiKey AuthorizationBearer <token>
Authorization: Bearer taad_… (or taadtest_… for the sandbox). Never in a URL, never in a web page.
In: header
Header Parameters
Idempotency-Key?string
Any unique string (a UUID). Sending the same request again with the same key answers the first answer, and a paid call is never charged twice. Kept 24 hours.
Length
length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/ask" \ -H "Content-Type: application/json" \ -d '{ "question": "string" }'{ "id": "string", "object": "ask", "livemode": true, "question": "string", "answer_markdown": "string", "citations": [ { "recording_id": "string", "start_ms": -9007199254740991, "end_ms": -9007199254740991, "quote": "string" } ], "recording_ids": [ "string" ], "cost_usd": 0, "created_at": "string"}