Documentation
Integrate Velqa like any OpenAI-compatible API, and learn every feature of the product.
Base configuration
base_url = "https://api.velqa.dev/v1"
api_key = "sk-..."
Getting started
What is Velqa — the OpenAI-compatible LLM API payable in dirhams (MAD)
Velqa.dev is an API gateway for large language models, OpenAI- and Anthropic-compatible, giving developers across the Maghreb and Africa access to the best o...
Get started with velqa.dev in 2 minutes — LLM API payable in dirhams (MAD)
Velqa.dev is an OpenAI-compatible API gateway giving you access to the best open-weight models (Kimi K2.6, MiniMax M3, DeepSeek V4 Flash) with payment in Mor...
Velqa API authentication — `sk-...` key and Bearer header
Every request to the Velqa API authenticates with an API key of the form sk-..., passed in the Authorization: Bearer HTTP header. That's the only secret the...
Chat / LLM
Chat / LLM with Velqa — OpenAI-compatible API payable in MAD
Velqa's chat API follows the OpenAI POST /v1/chat/completions format exactly. To use it from existing code, just change the base_url to https://api.velqa.dev...
Streaming responses with Velqa — SSE, OpenAI-compatible
Velqa can return chat responses as a stream: tokens arrive as they're generated, via Server-Sent Events (SSE). This is ideal for a chat-style UI where you wa...
Tool calling / function calling with Velqa — OpenAI style
Tool calling lets a model call your functions: you describe tools in the tools parameter, the model replies with tool_calls, you run the matching function, t...
The `velqa-auto` model — automatic chat routing based on your plan
velqa-auto is a virtual model ID: send "model": "velqa-auto" and Velqa automatically routes your chat request to a suitable model, using a heuristic classifi...
Velqa's Anthropic-compatible API — `/v1/messages` endpoint, payable in MAD
On top of the OpenAI-compatible API, Velqa exposes an Anthropic-compatible endpoint: https://api.velqa.dev/v1/messages. Tools and SDKs built for Anthropic (i...
Inference APIs
Embeddings with Velqa.dev
Velqa offers two multilingual embedding models (strong in French and Arabic), ideal for semantic search, RAG and document comparison. They are available on t...
Reranking with Velqa.dev — reorder your RAG results (FR / AR)
Velqa offers multilingual reranking via qwen3-reranker-8b (Alibaba), on the API https://api.velqa.dev/v1/rerank. The reranker takes a query and a list of doc...
Image generation (text-to-image) with Velqa.dev
Velqa offers image generation via flux-2-klein-4b (Black Forest Labs, FLUX.2 family), on the OpenAI-compatible API https://api.velqa.dev/v1/images/generation...
Audio transcription (Speech-to-Text) with Velqa.dev
Velqa offers audio transcription via whisper-large-v3 (multilingual, strong in French / Arabic / darija), on the OpenAI-compatible API https://api.velqa.dev/...
Text-to-Speech with Velqa.dev
Velqa offers text-to-speech via kokoro-tts (hexgrad, via DeepInfra), on the OpenAI-compatible API https://api.velqa.dev/v1/audio/speech. You send text and a...
Dashboard
The velqa.dev dashboard — manage your account and API keys, pay in dirhams (MAD)
The velqa.dev dashboard puts everything a developer needs in one place: create API keys, try models with no code, track your spend, and top up your balance i...
velqa.dev API keys — create, limit, and revoke keys (pay in dirhams)
Your sk-... API keys authenticate every request to velqa.dev. This guide covers creating a key from the dashboard, restricting which models it can call, sett...
Track your velqa.dev usage — spend, history, and live quota (billed in dirhams)
The dashboard's Usage section shows where your budget goes: spend this month, daily breakdown by model, cost per project, a detailed request history, and a r...
velqa.dev Playground — try models with no API key or card (pay in dirhams)
The Playground lets you try velqa.dev models right in the browser, with no code. It's available publicly at /playground (no sign-up, with a demo quota) and f...
Billingbeta
velqa.dev plans & pricing — subscriptions and Recharge Boost payable in dirhams (MAD)
Velqa offers three monthly subscriptions (Starter, Dev, Pro) and a prepaid pay-as-you-go mode (Recharge Boost), all payable in Moroccan dirhams. This page ex...
velqa.dev Recharge Boost — top up your balance in dirhams (MAD) via Stripe or CMI
Recharge Boost is Velqa's prepaid pay-as-you-go balance: you pick an amount in dirhams, pay, and the credit is added to your balance to use every model with...
Automatic fallback to Boost on velqa.dev — stop getting blocked when your subscription runs out
Automatic fallback to Boost is a toggle that lets your spend spill over to your prepaid Boost balance when your subscription (Base) limits are exhausted, ins...
Auto top-up and low-balance alerts on velqa.dev — never run out of credit
Auto top-up saves a card and recharges your Boost balance as soon as it drops below a threshold you set; a low-balance email alert also warns you when the ba...
Currency and FX on velqa.dev — balances in USD, display in dirhams (MAD)
On Velqa, amounts are stored internally in USD but displayed in your local currency — Moroccan dirham (MAD) by default — using a daily exchange rate. The exa...
Sandbox Agentbeta
Velqa Sandbox Agent — run code in an ephemeral Docker sandbox (BETA)
Velqa's Sandbox Agent lets you build AI agents that actually run code inside an isolated, ephemeral Docker sandbox, straight from the dashboard. This is a BE...
Create and configure a Sandbox agent (BETA)
An agent is a reusable profile you set up once and then start as many times as you need. It defines the persona and environment of your Sandbox conversations...
Sandbox Agent conversations and turns (BETA)
Once you've configured an agent, you talk to it through conversations made of turns. Each turn spins up an ephemeral Docker sandbox where the agent does its...
Sandbox Agent tools (BETA)
Inside the sandbox, the agent doesn't just reply — it calls tools to act. During a turn, every tool call shows up live in the UI. This page describes the too...
Sandbox Agent workspace and artifacts (BETA)
Every sandbox has a workspace: the folder where files live during a turn. You can upload your own files for the agent to process, and the agent can publish a...
Tool integrations
Tool integrations — connect your coding agents to Velqa, pay in dirhams (MAD)
Velqa exposes an OpenAI-compatible API, so any OpenAI-compatible client (opencode, Cline, Roo Code, Kilo Code, Continue…) works with no plugin: you just chan...
Use Claude Code with Kimi K2.6 or DeepSeek in Morocco — velqa.dev
Configure Claude Code to use Kimi K2.6, DeepSeek or MiniMax M3 through velqa.dev, payable in Moroccan dirhams (MAD). No international Visa card required.
Use Kimi K2.6 and MiniMax M3 with opencode in Morocco — velqa.dev
Configure opencode to use Kimi K2.6 or MiniMax M3 through velqa.dev, payable in Moroccan dirhams (MAD). No international Visa card required.
Use Kimi K2.6 with Cline in Morocco — velqa.dev, pay in dirhams (MAD)
Configure the Cline VS Code extension to use velqa.dev models with local payment in Moroccan dirhams.
Use Kimi K2.6 with Roo Code in Morocco — velqa.dev, pay in dirhams (MAD)
Roo Code is a fork of Cline with advanced mode profiles (Code, Architect, Ask, Debug). It is configured the same way for an OpenAI-compatible provider.
Use Kimi K2.6 with Kilo Code in Morocco — velqa.dev, pay in dirhams (MAD)
Kilo Code is an OpenAI-compatible VS Code coding agent. Configure it in a few fields to use velqa.dev with payment in dirhams.
Use Kimi K2.6 with Continue in Morocco — velqa.dev, pay in dirhams (MAD)
Continue is a VS Code / JetBrains extension for code autocomplete and chat. Configure it to use velqa.dev models with payment in Moroccan dirhams.
Account
velqa.dev account — sign up, sign in, and verify your email (API you pay for in dirhams)
Creating a velqa.dev account takes seconds: email and password, or sign in with Google or GitHub. This guide covers registration, email verification (require...
velqa.dev settings — profile, language, ICE, and balance alerts (account billed in dirhams)
The dashboard's Settings section holds your account configuration: profile and organization details, dashboard language, billing address with ICE for Morocca...
velqa.dev referrals — earn $1 for every developer you invite (credited in dirhams)
The Referrals program rewards developers who spread the word about velqa.dev: your referred user gets $1 and you get $1 on their first payment. This guide ex...
Reference
Models available on velqa.dev — Prices in dirhams (MAD)
All the models below are reachable through velqa.dev's OpenAI-compatible API (https://api.velqa.dev/v1/chat/completions) and Anthropic-compatible API (https:...
Rate limits and budgets on Velqa.dev
Velqa applies per-key API limits to protect your balance and smooth out load: a maximum throughput (RPM / TPM) per model, and a monthly USD budget per key. T...
Velqa.dev API error codes and how to fix them
A rundown of the HTTP errors returned by the OpenAI-compatible API https://api.velqa.dev/v1, their most common cause and the fix to apply. Every error respon...