TokelyAPI REFERENCE
Responses
Use stateless text input with models that support the Responses API.
POST /v1/responses
Check the model page for Responses support. Send input as a text string or an array of text messages. Use store=false and include conversation history yourself.
curl https://api.tokely.me/v1/responses \
-H "Authorization: Bearer $TOKELY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5-mini",
"input": "Explain an API in one sentence.",
"max_output_tokens": 1024,
"store": false
}'Core parameters
Choose a model that supports the requested options.
| Parameter | Description |
|---|---|
| model | Required. Enabled model with Responses support. |
| input | Required. Text or 1–128 text/history items. |
| instructions | Optional text instructions. |
| max_output_tokens | Output budget including reasoning. Default: 256. |
| store | Must be false. Stored conversations are unsupported. |
| stream | Set true for Responses SSE events. |
| tools | Up to 32 function tools. No provider-hosted tools. |
Read output and continue
The JSON response contains output items. Extract text from message content items with type output_text. Function calls appear as separate output items.
For the next turn, send prior input and relevant output items in input. previous_response_id and conversation storage are not supported.