API Free.ai
Une clé API. Chaque outil AI. Facturation simple.
Comment ça marche
Obtenez une clé API
Achetez des jetons, puis générer votre clé sk-free-
Appeler n'importe quel point d'arrivée
Chat, images, TTS, STT, musique, traduction — toutes les API
Payer en jetons
Un seul équilibre, chaque outil coûte des jetons.
Démarrer rapidement
# Chat with AI
curl -X POST https://api.free.ai/v1/chat/ \
-H "Authorization: Bearer sk-free-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"messages": [{"role": "user", "content": "Hello!"}],
"model": "qwen7b"
}'
# Generate an image — self-hosted (free within daily allowance)
curl -X POST https://api.free.ai/v1/image/generate/ \
-H "Authorization: Bearer sk-free-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "A sunset over mountains", "model": "sdxl"}'
# Generate with a premium model (paid tokens only — FLUX Kontext, Seedream,
# Ideogram, Nano Banana, Gemini 3 Pro, etc.). Full list at /v1/providers.
curl -X POST https://api.free.ai/v1/image/generate/ \
-H "Authorization: Bearer sk-free-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "A sunset over mountains", "model": "premium/flux-pro/kontext"}'
# Generate a video (premium)
curl -X POST https://api.free.ai/v1/video/generate/ \
-H "Authorization: Bearer sk-free-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "A cat running in slow motion", "duration": 5, "model": "premium/kling-video/v2.6/pro/text-to-video"}'
# Text to speech
curl -X POST https://api.free.ai/v1/tts/ \
-H "Authorization: Bearer sk-free-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"text": "Hello world", "voice": "default", "model": "kokoro"}'
# Translate text
curl -X POST https://api.free.ai/v1/translate/ \
-H "Authorization: Bearer sk-free-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"text": "Hello world", "target": "es"}'
import requests
API_KEY = "sk-free-YOUR_KEY"
BASE = "https://api.free.ai"
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}
# Chat
r = requests.post(f"{BASE}/v1/chat/", headers=HEADERS, json={
"messages": [{"role": "user", "content": "Hello!"}],
"model": "qwen7b" # or "openai/gpt-4o", "anthropic/claude-sonnet-4", etc.
})
print(r.json()["choices"][0]["message"]["content"])
# Generate image — self-hosted (free within daily allowance)
r = requests.post(f"{BASE}/v1/image/generate/", headers=HEADERS, json={
"prompt": "A sunset over mountains",
"model": "sdxl", # or "premium/flux-pro/kontext" for paid tier
"aspect_ratio": "16:9"
})
print(r.json()["image_url"])
# Generate video (premium — see /v1/providers for the full list)
r = requests.post(f"{BASE}/v1/video/generate/", headers=HEADERS, json={
"prompt": "A cat running in slow motion",
"duration": 5,
"model": "premium/kling-video/v2.6/pro/text-to-video"
})
print(r.json()["video_url"])
# Text to speech
r = requests.post(f"{BASE}/v1/tts/", headers=HEADERS, json={
"text": "Hello world",
"model": "kokoro",
"voice": "af_heart"
})
print(r.json()["audio_url"])
# Transcribe audio
r = requests.post(f"{BASE}/v1/stt/transcribe/", headers=HEADERS, json={
"url": "https://example.com/audio.mp3",
"model": "whisper"
})
print(r.json()["text"])
const API_KEY = "sk-free-YOUR_KEY";
const BASE = "https://api.free.ai";
// Chat
const chat = await fetch(`${BASE}/v1/chat/`, {
method: "POST",
headers: { "Authorization": `Bearer ${API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
messages: [{ role: "user", content: "Hello!" }],
model: "qwen7b"
})
});
const data = await chat.json();
console.log(data.choices[0].message.content);
// Generate image — self-hosted (free within daily allowance)
const img = await fetch(`${BASE}/v1/image/generate/`, {
method: "POST",
headers: { "Authorization": `Bearer ${API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({ prompt: "A sunset over mountains", model: "sdxl" })
});
// Premium image model (paid tokens) — full list at /v1/providers
const imgPro = await fetch(`${BASE}/v1/image/generate/`, {
method: "POST",
headers: { "Authorization": `Bearer ${API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({ prompt: "A sunset over mountains", model: "premium/flux-pro/kontext" })
});
console.log((await img.json()).image_url);
Prix symbolique
Tout coûte des jetons. Un équilibre pour tous les outils. Même prix que vous utilisez l'API ou le site Web.
| Modèle | Type | Coût du jeton | Licence |
|---|---|---|---|
| Qwen 2,5 7B | Chat/Ecrit/Code | Jetons utilisés (entrées + sorties) | Apache 2.0 |
| FLUX.2 Klein | Génération d'images | 5 000 jetons/image | Apache 2.0 |
| Kokoro | Synthèse vocale | 1 jeton par 4 caractères | Apache 2.0 |
| faster-whisper | Discours au texte | 4 jetons/seconde d'audio | MIT |
| AudioLDM 2 | Génération de musique | 2000 jetons/piste | Apache 2.0 |
| MadLAD-400 | Traduction (450 langs et plus) | Jetons effectifs utilisés | Apache 2.0 |
| Real-ESRGAN | Mise à niveau de l'image | 500 jetons/image | BSD |
| BRIA RMBG | Suppression des antécédents | 500 jetons/image | Apache 2.0 |
| CogVideoX | Génération de vidéos | 5 000 jetons/vidéo | Apache 2.0 |
| Demucs | Séparation vocale | 500 jetons/piste | MIT |
Accès GPT-4, Claude, Gemini, Llama, DeepSeek et 340+ autres modèles. Le coût de jeton est basé sur le prix du fournisseur converti en jetons.
| Modèle | Fournisseur | ~Tokens par message | Annexe |
|---|---|---|---|
| GPT-4o Mini | Ouvrir l'AI | ~20 | Pas cher, rapide |
| Flash Gemini 2.0 | ~15 | Très rapide | |
| Némo Mistral | Mistral | ~10 | Grande valeur |
| DeepSeek V3 | DeepSeek | ~30 | Un raisonnement fort |
| Llama 3,3 70B | Méta | ~25 | Poids ouverts |
| Claude Sonnet 4 | Anthropique | ~400 | Qualité supérieure |
| (0)o | Ouvrir l'AI | ~325 | Qualité supérieure |
| Qwen 2,5 72B | Alibaba | ~40 | Grand, capable |
Liste complète des 346 modèles+ à /apps/. Tous utilisent le même paramètre /v1/chat/ — il suffit de changer le paramètre model.
Modèles auto-organisés: Vous payez exactement les tokens utilisés.
Modèles externes: our_tokens = provider_usd_cost × 100,000 × 1.30
Exemple : GPT-4_o coûte $0.0025 par token d'invite 1K. Pour 1 000 token : $0.0025 × 100 000 × 1,30 = 325 jetons de votre équilibre.
Tous les points de fin
POST /v1/chat/ | Chat avec n'importe quel modèle (auto-hôte ou externe). |
POST /v1/image/generate/ | Texte vers image (FLUX, SDXL) |
POST /v1/image/edit/ | Inpaint, outpaint, transfert de style |
POST /v1/image/enhance/ | Haut de la gamme 2x/4x (Real-ESRGAN) |
POST /v1/image/remove-bg/ | Supprimer l'arrière-plan (BRIA RMBG) |
POST /v1/video/generate/ | Texte/image vers la vidéo (CogVideoX) |
POST /v1/tts/ | Générer la parole (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | Streaming TTS (en temps réel) |
POST /v1/stt/transcribe/ | Traccrivez audio/vidéo (faster-whisper, 99 langues) |
POST /v1/music/generate/ | Générer de la musique à partir de la description texte |
POST /v1/music/separate/ | Voix/tiges séparées (Demucs) |
POST /v1/write/ | Générer du contenu (discours, courriel, histoire, etc.) |
POST /v1/code/generate/ | Générer du code dans n'importe quelle langue |
POST /v1/summarize/ | Résumé du texte |
POST /v1/humanize/ | Faire du texte AI un son humain |
POST /v1/detect/ | Détecter le contenu généré par l'IA |
POST /v1/translate/ | Traduire le texte (MadLAD-400, 450+ langues) |
POST /v1/ocr/ | Extraire du texte des images |
GET /v1/models | List all available models (self-hosted + external) |
GET /v1/status/{job_id}/ | Vérifier l'état de l'emploi async |
GET /health | Contrôle de santé API |
Authentification
Inclure votre clé API dans l'en-tête Autorisation:
Authorization: Bearer sk-free-YOUR_API_KEY
Chaque réponse comprend un bloc free_ai_usage montrant les jetons utilisés :
{
"choices": [...],
"free_ai_usage": {
"tokens_used": 142, // actual tokens processed
"tokens_charged": 142, // tokens deducted from your balance
"source": "self_hosted", // or "external"
"model": "qwen7b"
}
}
Limites et plans de taux
Même prix jeton sur le site Web et API. Pas de prix API séparé.
| Plan | Jetons/mois | Demandes d'API/min | Prix |
|---|---|---|---|
| Gratuit | 30 K/jour (pool) | 10 | $0 |
| Fondement | 250K | 30 | 5 dollars par mois |
| Pour | 1.25M | 60 | 19 dollars/mois |
| Entreprises | 6.25M | 120 | 49 $/mois |
| Entreprise | Personnalisé | Personnalisé | Personne à contacter |
Packs de jetons disponibles : 200K/$5, 1M/$15, 5M/$40. Les jetons n'expirent jamais.
Python SDK & CLI
Python SDK
Accédez à chaque outil d'IA à partir de votre code Python.
pip install free-dot-ai
from freeai import FreeAI
ai = FreeAI(api_key="sk-free-xxx")
# Chat
response = ai.chat("What is Python?")
print(response.text)
# Image generation
image = ai.image("A sunset over mountains")
image.save("sunset.png")
# Text to speech
audio = ai.tts("Hello world", voice="af_heart")
audio.save("hello.mp3")
# Translation
result = ai.translate("Hello", to="es")
print(result.text) # "Hola"
GitHub
PyPI
Assistant de codage de l'ICL
Option libre et open-source pour le code Claude, le curseur et le copilote GitHub.
pip install free-dot-ai-code
# Start a coding session
cd your-project/
free-code
# Ask about your codebase
free-code ask "How does auth work?"
# Execute a task
free-code run "Add unit tests for User model"
30K tokens gratuits/jour. BYOK supporté. 346+ modèles. Synchronisation de session avec Web IDE.
GitHub PyPI IDE WebBYOK (Appliquez votre propre clé)
Utilisez vos propres clés API de n'importe quel fournisseur. Un balisage zéro, des frais zéro. Free.ai vient juste de donner raison à la demande.
| Fournisseur | Format de la clé | Modèles | Marquage |
|---|---|---|---|
| Ouvrir l'AI | sk-proj-xxx | Les données sont disponibles sur le site web de l'Agence. | $0 |
| Anthropique | sk-ant-xxx | Claude Sonnet 4, Opus 4, Haiku, etc. | $0 |
AIzaSyxxx | Gemini 2.5 Pro, Flash, etc. | $0 | |
| Autres fournisseurs | sk-or-xxx etc. | 346 modèles + de tous les fournisseurs | $0 |
# Python SDK with BYOK
from freeai import FreeAI
ai = FreeAI(provider="openai", api_key="sk-proj-xxx")
response = ai.chat("Hello", model="gpt-4o")
# CLI with BYOK
# free-code config set provider openai
# free-code config set api_key sk-proj-xxx
Votre clé, votre utilisation, votre facture, pas de compte, pas de déductions de jeton sur votre solde de Free.ai.
FAQ de l'API
"model": "openai/gpt-4o" ou "model": "anthropic/claude-sonnet-4". Liste complète à /apps/ ou GET /v1/models."stream": true dans votre demande de chat. Les réponses sont envoyées via Server-Sent Events (SSE).free_ai_usage.tokens_charged dans chaque réponse de l'API.pip installez free-dot-ai. Il enveloppe chaque paramètre avec des réponses dactylographiées. Pour l'assistance au codage, installez pip installez free-dot-ai-code. L'API suit également OpenAI\