Documentation
Intègre Velqa comme n'importe quelle API OpenAI-compatible, et découvre chaque fonctionnalité du produit.
Configuration de base
base_url = "https://api.velqa.dev/v1"
api_key = "sk-..."
Démarrage
Qu'est-ce que Velqa — l'API LLM OpenAI-compatible payable en dirhams (MAD)
Velqa.dev est un gateway d'API pour grands modèles de langage, compatible OpenAI et Anthropic, qui donne aux développeurs du Maghreb et d'Afrique un accès au...
Démarrer avec velqa.dev en 2 minutes — API LLM payable en dirhams (MAD)
Velqa.dev est un gateway API OpenAI-compatible qui donne accès aux meilleurs modèles open-weight (Kimi K2.6, MiniMax M3, DeepSeek V4 Flash) avec paiement en...
Authentification à l'API Velqa — clé `sk-...` et header Bearer
Toutes les requêtes vers l'API Velqa s'authentifient avec une clé API de la forme sk-..., passée dans l'en-tête HTTP Authorization: Bearer. C'est le seul sec...
Chat / LLM
Chat / LLM avec Velqa — API OpenAI-compatible payable en MAD
L'API de chat de Velqa suit exactement le format OpenAI POST /v1/chat/completions. Pour l'utiliser depuis un code existant, il suffit de changer la base_url...
Streaming des réponses avec Velqa — SSE en OpenAI-compatible
Velqa peut renvoyer les réponses de chat en flux (streaming) : les tokens arrivent au fur et à mesure de leur génération, via Server-Sent Events (SSE). C'est...
Tool calling / function calling avec Velqa — style OpenAI
Le tool calling permet à un modèle d'appeler vos fonctions : vous décrivez des outils dans le paramètre tools, le modèle répond avec des tool_calls, vous exé...
Le modèle `velqa-auto` — routage automatique du chat selon votre offre
velqa-auto est un ID de modèle virtuel : envoyez "model": "velqa-auto" et Velqa route automatiquement votre requête de chat vers un modèle adapté, à l'aide d...
API Anthropic-compatible de Velqa — endpoint `/v1/messages` payable en MAD
En plus de l'API OpenAI-compatible, Velqa expose un endpoint compatible Anthropic : https://api.velqa.dev/v1/messages. Les outils et SDK conçus pour Anthropi...
APIs d'inférence
Embeddings avec Velqa.dev
Velqa propose deux modèles d'embeddings multilingues (forts en français et en arabe), idéaux pour la recherche sémantique, le RAG et la comparaison de docume...
Reranking avec Velqa.dev — reclasser vos résultats de RAG (FR / AR)
Velqa propose le reranking multilingue via qwen3-reranker-8b (Alibaba), sur l'API https://api.velqa.dev/v1/rerank. Le reranker prend une requête et une liste...
Génération d'images (text-to-image) avec Velqa.dev
Velqa propose la génération d'images via flux-2-klein-4b (Black Forest Labs, famille FLUX.2), sur l'API OpenAI-compatible https://api.velqa.dev/v1/images/gen...
Transcription audio (Speech-to-Text) avec Velqa.dev
Velqa propose la transcription audio via whisper-large-v3 (multilingue, fort en français / arabe / darija), sur l'API OpenAI-compatible https://api.velqa.dev...
Synthèse vocale (Text-to-Speech) avec Velqa.dev
Velqa propose la synthèse vocale via kokoro-tts (hexgrad, via DeepInfra), sur l'API OpenAI-compatible https://api.velqa.dev/v1/audio/speech. Vous envoyez du...
Dashboard
Le tableau de bord velqa.dev — piloter votre compte et vos clés API en dirhams (MAD)
Le tableau de bord de velqa.dev réunit tout ce dont un développeur a besoin : créer des clés API, tester les modèles sans écrire de code, suivre votre consom...
Clés API velqa.dev — créer, limiter et révoquer vos clés (paiement en dirhams)
Vos clés API sk-... authentifient chaque requête vers velqa.dev. Ce guide explique comment les créer depuis le tableau de bord, restreindre les modèles autor...
Suivre votre consommation velqa.dev — dépense, historique et quota en temps réel (en dirhams)
La section Usage du tableau de bord montre où part votre budget : dépense du mois, répartition quotidienne par modèle, coût par projet, historique détaillé d...
Playground velqa.dev — tester les modèles sans clé API ni carte (paiement en dirhams)
Le Playground vous laisse essayer les modèles de velqa.dev directement dans le navigateur, sans écrire une ligne de code. Il est accessible publiquement sur...
Facturationbeta
Offres et tarifs velqa.dev — abonnements et Recharge Boost payables en dirhams (MAD)
Velqa propose trois abonnements mensuels (Starter, Dev, Pro) et un mode prépayé pay-as-you-go (Recharge Boost), tous payables en dirhams marocains. Cette pag...
Recharge Boost velqa.dev — recharger votre solde en dirhams (MAD) par Stripe ou CMI
La Recharge Boost est le solde prépayé pay-as-you-go de Velqa : vous choisissez un montant en dirhams, vous payez, et le crédit est ajouté à votre solde pour...
Fallback automatique vers Boost sur velqa.dev — ne plus être bloqué quand votre abonnement est épuisé
Le fallback automatique vers Boost est une option qui laisse votre dépense déborder sur votre solde prépayé Boost lorsque les limites de votre abonnement (Ba...
Recharge automatique et alerte solde bas sur velqa.dev — ne tombez jamais à court de crédit
La recharge automatique enregistre une carte et recharge votre solde Boost dès qu'il passe sous un seuil que vous fixez ; une alerte email vous prévient auss...
Devise et taux de change sur velqa.dev — soldes en USD, affichage en dirhams (MAD)
Sur Velqa, les montants sont stockés en interne en USD mais affichés dans votre devise locale — le dirham marocain (MAD) par défaut — via un taux de change m...
Sandbox Agentbeta
Sandbox Agent Velqa — exécuter du code dans un sandbox Docker éphémère (BETA)
Le Sandbox Agent de Velqa vous permet de créer des agents IA qui exécutent réellement du code dans un sandbox Docker isolé et éphémère, directement depuis le...
Créer et configurer un agent Sandbox (BETA)
Un agent est un profil réutilisable que vous configurez une fois puis démarrez autant de fois que nécessaire. Il définit la personnalité et l'environnement d...
Conversations et tours du Sandbox Agent (BETA)
Une fois un agent configuré, vous discutez avec lui à travers des conversations composées de tours. Chaque tour démarre un sandbox Docker éphémère où l'agent...
Outils de l'agent Sandbox (BETA)
Dans le sandbox, l'agent ne se contente pas de répondre : il appelle des outils pour agir. Pendant un tour, chaque appel d'outil s'affiche en direct dans l'i...
Espace de travail et artefacts du Sandbox Agent (BETA)
Chaque sandbox dispose d'un espace de travail : le dossier où vivent les fichiers pendant un tour. Vous pouvez y uploader vos propres fichiers pour que l'age...
Intégrations outils
Intégrations outils — brancher vos agents de code sur Velqa, payer en dirhams (MAD)
Velqa expose une API compatible OpenAI, donc n'importe quel client OpenAI-compatible (opencode, Cline, Roo Code, Kilo Code, Continue…) fonctionne sans plugin...
Utiliser Claude Code avec Kimi K2.6 ou DeepSeek au Maroc — velqa.dev
Configurez Claude Code pour utiliser Kimi K2.6, DeepSeek ou MiniMax M3 via velqa.dev, payable en dirhams marocains (MAD). Pas de carte Visa internationale né...
Utiliser Kimi K2.6 et MiniMax M3 avec opencode au Maroc — velqa.dev
Configurez opencode pour utiliser Kimi K2.6 ou MiniMax M3 via velqa.dev, payable en dirhams marocains (MAD). Pas de carte Visa internationale nécessaire.
Utiliser Kimi K2.6 avec Cline au Maroc — velqa.dev, payer en dirhams (MAD)
Configurez l'extension VS Code Cline pour utiliser les modèles velqa.dev avec un paiement local en dirhams marocains.
Utiliser Kimi K2.6 avec Roo Code au Maroc — velqa.dev, payer en dirhams (MAD)
Roo Code est un fork de Cline avec des profils de mode avancés (Code, Architect, Ask, Debug). Il se configure de la même façon pour un provider OpenAI-compat...
Utiliser Kimi K2.6 avec Kilo Code au Maroc — velqa.dev, payer en dirhams (MAD)
Kilo Code est un agent de code VS Code compatible OpenAI. Configurez-le en quelques champs pour utiliser velqa.dev avec paiement en dirhams.
Utiliser Kimi K2.6 avec Continue au Maroc — velqa.dev, payer en dirhams (MAD)
Continue est une extension VS Code / JetBrains pour l'autocomplétion et le chat de code. Configurez-la pour utiliser les modèles velqa.dev avec un paiement e...
Compte
Compte velqa.dev — inscription, connexion et vérification d'email (API payable en dirhams)
Créer un compte velqa.dev prend quelques secondes : email et mot de passe, ou connexion via Google ou GitHub. Ce guide couvre l'inscription, la vérification...
Paramètres velqa.dev — profil, langue, ICE et alertes de solde (compte payable en dirhams)
La section Paramètres du tableau de bord regroupe la configuration de votre compte : informations de profil et d'organisation, langue d'affichage, adresse de...
Parrainage velqa.dev — gagnez 1 $ par développeur invité (crédité en dirhams)
Le programme de Parrainage récompense les développeurs qui font découvrir velqa.dev : votre filleul reçoit 1 $ et vous recevez 1 $ dès son premier paiement....
Référence
Modèles disponibles sur velqa.dev — Prix en dirhams (MAD)
Tous les modèles ci-dessous sont accessibles via l'API OpenAI-compatible (https://api.velqa.dev/v1/chat/completions) et l'API Anthropic-compatible (https://a...
Limites de débit et budgets sur Velqa.dev
Velqa applique des limites par clé API pour protéger votre solde et lisser la charge : un débit maximal (RPM / TPM) par modèle, et un budget mensuel en USD p...
Codes d'erreur de l'API Velqa.dev et comment les corriger
Récapitulatif des erreurs HTTP renvoyées par l'API OpenAI-compatible https://api.velqa.dev/v1, leur cause la plus fréquente et la correction à appliquer. Cha...