Other providers
Connect DeepSeek, Mistral, xAI, Groq, Cerebras, Fireworks, Moonshot, MiniMax, Cloudflare and other model providers to Hull.
Hull can use any provider in its model catalog, not only the ones with their own page. This page lists common ones with the provider ID and the credential each needs.
Connect any provider
Every provider here connects the same way.
Open Settings, go to Providers, choose Add provider, select the provider and enter its credentials.
Providers
| Provider | Provider ID | Key setting |
|---|---|---|
| Alibaba Cloud Model Studio | alibaba (international), alibaba-cn (China) | DASHSCOPE_API_KEY |
| Azure OpenAI | azure | AZURE_API_KEY and AZURE_RESOURCE_NAME |
| Cerebras | cerebras | CEREBRAS_API_KEY |
| Chutes | chutes | CHUTES_API_KEY |
| Cloudflare Workers AI | cloudflare-workers-ai | CLOUDFLARE_ACCOUNT_ID and CLOUDFLARE_API_KEY |
| Cloudflare AI Gateway | cloudflare-ai-gateway | CLOUDFLARE_ACCOUNT_ID, CLOUDFLARE_GATEWAY_ID and CLOUDFLARE_API_TOKEN |
| DeepSeek | deepseek | DEEPSEEK_API_KEY |
| Fireworks AI | fireworks-ai | FIREWORKS_API_KEY |
| Groq | groq | GROQ_API_KEY |
| Inception | inception | INCEPTION_API_KEY |
| MiniMax | minimax | MINIMAX_API_KEY |
| Mistral AI | mistral | MISTRAL_API_KEY |
| Moonshot AI (Kimi) | moonshotai (international), moonshotai-cn (China) | MOONSHOT_API_KEY |
| OVHcloud AI Endpoints | ovhcloud | OVHCLOUD_API_KEY |
| Requesty | requesty | REQUESTY_API_KEY |
| Synthetic | synthetic | SYNTHETIC_API_KEY |
| Venice AI | venice | VENICE_API_KEY |
| xAI | xai | XAI_API_KEY, or sign in with a SuperGrok subscription |
| Z.AI | zai | ZHIPU_API_KEY |
| ZenMux | zenmux | ZENMUX_API_KEY |
The provider list in Hull is the source of truth. If a provider you want isn't listed but has an OpenAI-compatible API, add it as an OpenAI-compatible provider.
Provider notes
Cloudflare
Cloudflare has two providers. Workers AI runs Cloudflare-hosted models and needs your account ID and a Workers AI API key. AI Gateway routes requests to other providers through your Cloudflare gateway and needs your account ID, gateway ID and a gateway API token. When you connect either one, Hull prompts for any value it can't find in the environment.
If your organization gives you a complete gateway URL, set provider.<id>.options.baseURL instead. Hull then skips the account and gateway ID checks.
xAI subscription sign-in
With a SuperGrok subscription, you can sign in with xAI instead of using an API key. When connecting xAI, choose:
- xAI Grok OAuth (SuperGrok Subscription) to sign in through your browser. The callback uses a local server on
127.0.0.1:56121. - xAI Grok OAuth (Headless / Remote / VPS) on a remote machine, container or SSH session. Hull shows a code to enter at a URL on any device.
- Manually enter API Key to use an API key instead.
xAI rotates refresh tokens on each use. If you run several Hull processes at once and one loses its session, run hull auth login --provider xai again. Subscription access applies to Hull on your machine; cloud agents use Hull Gateway.
Mistral
Reasoning-capable Mistral Small 4 models (mistral-small-2603, mistral-small-latest) offer a high reasoning variant.
Alibaba and Moonshot regions
Accounts in mainland China use separate endpoints. Use the alibaba-cn or moonshotai-cn provider with the same key if the international provider rejects it.