# Tukai Developers

> API Tukai compatible avec les SDK OpenAI et Anthropic (texte), CLI tukai pour Claude Code. Abonnement, crédits en dinars tunisiens et limites d'usage partagés avec l'application Tukai.

- URL de base OpenAI : https://chat.tuk-ai.com/v1
- URL de base Anthropic : https://chat.tuk-ai.com
- Authentification : Authorization: Bearer tuk_sk_… (ou x-api-key)
- Opérations : POST /v1/chat/completions, POST /v1/messages, POST /v1/messages/count_tokens, GET /v1/models (public)
- Modèle par défaut du catalogue public : chat-aion-labs-aion-3-0-mini
- Texte seulement. Ignorés sans avertissement : images et audio en entrée, outils côté OpenAI, response_format, temperature. Absents : Responses API, embeddings, images, audio, fichiers, lots. Tukai n'expose pas de serveur MCP.

## Documentation (français)

- [Premier appel](https://developers.tuk-ai.com/docs/quickstart.md) : Créez une clé sur votre compte Tukai, gardez-la dans une variable d'environnement et envoyez une première requête de texte en quelques minutes.
- [Compatibilité OpenAI et Anthropic](https://developers.tuk-ai.com/docs/compatibility.md) : Ce que l'API Tukai reprend des API OpenAI et Anthropic, ce qu'elle ne reprend pas, et ce qu'il faut changer dans une intégration existante.
- [Clés d'API](https://developers.tuk-ai.com/docs/authentication.md) : Comment fonctionne une clé tuk_sk_, comment la créer, la limiter, la garder en sécurité et la révoquer sans perdre l'historique.
- [Crédits et facturation](https://developers.tuk-ai.com/docs/billing.md) : Les mêmes droits et le même solde en dinars pour l'application et l'API, la réservation à chaque appel, le plafond mensuel par clé et ce qui n'existe pas encore.
- [Erreurs](https://developers.tuk-ai.com/docs/errors.md) : Chaque code d'erreur de l'API compatible, sa cause, ce qu'il coûte et ce qu'il faut faire, avec l'identifiant de requête à transmettre au support.
- [Mise en production](https://developers.tuk-ai.com/docs/production.md) : La liste de contrôle avant de servir de vrais utilisateurs - clés, solde partagé, limites réelles, erreurs, données, support - et le cas des agences.
- [Données](https://developers.tuk-ai.com/docs/data.md) : Ce qui arrive au contenu de vos requêtes API, ce que Tukai conserve, ce qui n'est jamais journalisé, et où lire le cadre juridique.
- [CLI tukai (Claude Code)](https://developers.tuk-ai.com/tools/cli.md) : Installer la CLI tukai, connecter une machine à votre compte, lancer Claude Code sur votre solde Tukai, suivre la consommation et couper l'accès.
- [MCP](https://developers.tuk-ai.com/tools/mcp.md) : Ce que Tukai propose, et ne propose pas, autour du Model Context Protocol, et comment utiliser Tukai dans vos outils de développement.
- [Brouillons de réponse à des messages clients](https://developers.tuk-ai.com/cookbook/assistant-messages.md) : Un petit script qui propose une réponse courte, en français, en derja ou en anglais, à des messages clients — toujours relue par un humain avant envoi.
- [Migrer une intégration du SDK OpenAI](https://developers.tuk-ai.com/cookbook/migrer-sdk.md) : Les trois lignes à changer pour faire passer un code du SDK OpenAI sur l'API Tukai, et une vérification gratuite que la migration est prête.
- [Une première tâche avec la CLI tukai](https://developers.tuk-ai.com/cookbook/tache-cli.md) : Installer la CLI, confier à Claude Code une tâche courte et sans risque dans un dossier d'essai, retrouver la dépense, puis couper l'accès.

## Documentation (English)

- [First call](https://developers.tuk-ai.com/en/docs/quickstart.md) : Create a key on your Tukai account, keep it in an environment variable, and send a first text request in a few minutes.
- [OpenAI and Anthropic compatibility](https://developers.tuk-ai.com/en/docs/compatibility.md) : What the Tukai API takes from the OpenAI and Anthropic APIs, what it does not, and what to change in an existing integration.
- [API keys](https://developers.tuk-ai.com/en/docs/authentication.md) : How a tuk_sk_ key works, how to create it, limit it, keep it safe and revoke it without losing its history.
- [Credits and billing](https://developers.tuk-ai.com/en/docs/billing.md) : The same entitlements and dinar balance for the app and the API, the reservation on each call, the monthly cap per key, and what does not exist yet.
- [Errors](https://developers.tuk-ai.com/en/docs/errors.md) : Every error code of the compatible API, its cause, what it costs and what to do, with the request identifier to send to support.
- [Going to production](https://developers.tuk-ai.com/en/docs/production.md) : The checklist before serving real users - keys, shared balance, actual limits, errors, data, support - and the case of agencies.

## Référence

- [Contrat OpenAPI public](https://developers.tuk-ai.com/openapi.json)
- [Modèles](https://developers.tuk-ai.com/models)