DocumentationAI
Cloud AI Providers
Access OpenAI, Anthropic, Gemini, DeepSeek, and other frontier models via direct API keys or compatible gateways.
Kapinote supports direct connections to leading cloud AI APIs and OpenAI-compatible gateways. Create your API key in the provider's console, configure it under Settings → AI → Cloud, enter your desired Model ID, and click Verify.
Model Lifecycle Tip: AI models evolve rapidly. The examples in Kapinote provide convenient starting points, but always verify current Model IDs against official provider documentation.
Supported providers & defaults
| Provider | Kapinote Default Base URL | Setup & Credential Guide |
|---|---|---|
| OpenAI API | https://api.openai.com | Follow the OpenAI Quickstart to generate an API key |
| Azure OpenAI | Your Azure resource deployment URL | Set Model to your Azure Deployment Name; copy Key and Endpoint from Azure |
| OpenAI-compatible | Your gateway or proxy URL | Enter your provider's API key, endpoint, and exact Model ID |
| Anthropic | https://api.anthropic.com | Generate an API key in the Anthropic Console |
| Google Gemini | https://generativelanguage.googleapis.com/v1beta | Create an API key via the Gemini API Guide |
| OpenRouter | https://openrouter.ai/api | Create a key in OpenRouter Settings and specify provider/model slug |
| DeepSeek | https://api.deepseek.com/v1 | Create a platform key and specify deepseek-chat or deepseek-reasoner per DeepSeek Docs |
| Moonshot (Kimi) | https://api.moonshot.cn/v1 | Create an API key in the Moonshot Platform |
| Aliyun DashScope | https://dashscope.aliyuncs.com/compatible-mode/v1 | Generate a key via Aliyun Model Studio for Qwen models |
| Z.AI (Zhipu) | https://api.z.ai/api/paas/v4/chat/completions | Generate a key from the Z.AI Platform for GLM models |
| AWS Bedrock | us-east-1 (specify AWS Region) | Create Bedrock API Credentials and enable Model Access |
Three ways to connect OpenAI
- OpenAI Official API: Uses standard API keys and Model IDs (e.g.,
gpt-4o,gpt-4o-mini). - Azure OpenAI: Requires your resource endpoint; the Model field must contain your custom Azure Deployment Name, not the generic model name.
- OpenAI-compatible Gateways: Connects to Groq, Together AI, OneAPI, or self-hosted proxy routers.
Regional endpoints & special paths
- Aliyun Mainland vs. International: Kapinote defaults to the mainland China DashScope endpoint. If using an Alibaba Cloud International account, update the Base URL to
https://dashscope-intl.aliyuncs.com/compatible-mode/v1. - Z.AI: Kapinote's default Base URL includes
/chat/completions. Do not truncate or duplicate this path unless your gateway specifically requires it. - AWS Bedrock: Enter the AWS region (e.g.,
us-east-1,us-west-2) in the Base URL field. Ensure model access is granted in that region and provide the full Bedrock model ARN or ID (e.g.,anthropic.claude-3-5-sonnet-20241022-v2:0).
Credential security recommendations
- Generate dedicated API keys specifically for Kapinote to cleanly track usage and costs.
- Set billing alerts and monthly spending caps in your provider dashboard.
- Never paste credentials into shared screenshots or public bug trackers.
- If a key is accidentally exposed, immediately revoke and regenerate it in your provider console.