API reference
Every endpoint, generated from the OpenAPI spec. Pick one to see its parameters and send a live request with your key.
POST
/chat/completionsCreate a chat completion
Parameters
Idempotency-Keyheaderstring — Retrying with the same key within 24h replays the first response (streams included, up to 2MB) instead of running and billing the request again. Keys are dropped after a 5xx so the retry runs.X-Titleheaderstring — Your app's name; shown in usage analytics and GET /generation.HTTP-Refererheaderstring — Your app's URL; shown in usage analytics. Also checked against a key's allowed_referrers.X-UltraGPT-Cacheheader"true" | "false" — Serve identical requests from the response cache (also accepted as X-OpenRouter-Cache).X-UltraGPT-Cache-TTLheaderintegerX-UltraGPT-Cache-Clearheader"true" | "false"Request body
modelrequiredstring — Model id; append :online for web searchmodelsstring[]messagesrequiredobject[]streambooleanstream_optionsobjectmax_tokensintegermax_completion_tokensintegertemperaturenumbertop_pnumbertop_kintegerstopstring | string[]seedintegerpresence_penaltynumberfrequency_penaltynumbertoolsobject[]tool_choiceobjectparallel_tool_callsbooleanresponse_formatobjectreasoningobjectreasoning_effortstringpluginsobject[]providerobjectuserstringsafety_identifierstring — Stable, hashed id of your end user; recorded on the generation (GET /generation `end_user`). Preferred over the deprecated `user`.Responses
200OK
429Rate limited (key RPM/TPM/concurrency, or the account ceiling across keys)
4XXError (OpenAI shape)
5XXError (OpenAI shape)
Response body
idstringobjectstringcreatedintegermodelstringchoicesobject[]usageobjectTry it
Requests go straight from your browser to the API with this key and are billed normally. The key stays in this tab only.
cURL
curl -X POST "https://api.ultragpt.pro/v1/chat/completions" \
-H "Authorization: Bearer $ULTRAGPT_API_KEY"