CostIQ API · v1
AI inference through one clean API.
Use one CostIQ-issued key with a verified agent setup or any compatible Responses or Chat Completions client.
Start here
- Get your CostIQ API key. The shared base URL is
https://inference.costiq.xyz/v1and the model alias isgeneral-fast. - Run the four-step smoke test to verify authentication, model access, native Responses, and streaming.
- Choose a production-qualified setup for Codex or OpenCode, or use an SDK example.
- For another agent, check the compatibility contract before relying on it.
The API
CostIQ exposes a deliberately small public surface. Discover the models available to your key, then create native Responses or Chat Completions with or without streaming.
GET
/v1/modelsPOST
/v1/responsesPOST
/v1/chat/completionsBase URL
https://inference.costiq.xyz/v1Default alias
general-fastAuthentication
Bearer keyStreaming
Server-sent eventsYour credentials
Every person, application, and environment should use a separate CostIQ key. Each credential can have its own expiry, model access, request rate, token rate, concurrency, and estimated-spend budget.
Make a request
With COSTIQ_BASE_URL and COSTIQ_API_KEY set in your shell:
cURL
curl "$COSTIQ_BASE_URL/responses" \
-H "Authorization: Bearer $COSTIQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "general-fast",
"input": "Explain this in one sentence.",
"store": false
}'