API Free.ai
Une clé API. Chaque outil d'IA. Facturation simple en jeton.
Comment ça marche
Obtenez une clé API
Acheter des jetons, puis générer votre touche 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. Simple.
Démarrage rapide
# 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": "flux-schnell"}'
# 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": "flux-schnell", # 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: "flux-schnell" })
});
// 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/écriture/code | Jetons réels utilisés (entrées + sorties) | Apache 2.0 |
| FLUX.1 Schnell | Génération d'images | 1000 jetons/image | Apache 2.0 |
| Kokoro | Texte au discours | 1 jeton par 4 caractères | Apache 2.0 |
| plus rapide-whisper | Discours au texte | 4 jetons/seconde d'audio | MIT |
| AudioLDM 2 | Génération de musique | 2 000 jetons/piste | Apache 2.0 |
| MadLAD-400 | Traduction (450+ langs) | Jetons effectifs utilisés | Apache 2.0 |
| VRAI-ESRGAN | Mise à niveau de l'image | 500 jetons/image | BSD |
| BRIA RMBG | Suppression de l'arrière-plan | 500 jetons/image | Apache 2.0 |
| CogVideoX | Génération de vidéos | 5 000 jetons/vidéo | Apache 2.0 |
| Démucs | Séparation vocale | 500 jetons/piste | MIT |
Access GPT-4, Claude, Gemini, Llama, DeepSeek et 340+ autres modèles. Le coût du jeton est basé sur le prix du fournisseur converti en jetons.
| Modèle | Fournisseur | ~Jetons par message | Remarques |
|---|---|---|---|
| Mini GPT-4o | Ouverture de 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 | Motifs forts |
| Lama 3.3 70B | Méta | ~25 | Poids ouverts |
| Claude Sonnet 4 | Anthropique | ~400 | Qualité supérieure |
| GPT-4o | Ouverture de 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 jetons utilisés.
Modèles externes: our_tokens = provider_usd_cost × 100,000 × 1.30
Exemple : GPT-4_o coûte $0.0025 par jeton d'invite 1K. Pour 1 000 jeton : $0.0025 × 100 000 × 1,30 = 325 jetons de votre équilibre.
Tous les points de fin
POST /v1/chat/ | Dialoguez avec n'importe quel modèle (auto-hôte ou externe). Streaming pris en charge. |
POST /v1/image/generate/ | Texte vers image (FLUX, SDXL) |
POST /v1/image/edit/ | Inpaint, outpaint, transfert de style |
POST /v1/image/enhance/ | Haut de gamme 2x/4x (Réel-ESRGAN) |
POST /v1/image/remove-bg/ | Supprimer l'arrière-plan (BRIA RMBG) |
POST /v1/video/generate/ | Texte/image sur vidéo (CogVideoX) |
POST /v1/tts/ | Générer un discours (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | Streaming TTS (chunks audio en temps réel) |
POST /v1/stt/transcribe/ | Traccrivez l'audio/vidéo (plus rapide, 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 (essai, courriel, histoire, etc.) |
POST /v1/code/generate/ | Générer du code dans n'importe quelle langue |
POST /v1/summarize/ | Résumer le texte |
POST /v1/humanize/ | Faire en sorte que le texte de l'IA soit 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é de l'API |
Authentification
Inclure votre clé d'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 tarifaires et plans
Même prix en jeton sur le site Web et l'API. Pas de prix d'API séparé.
| Plan | Jetons/mois | Demandes d'API/Min | Prix |
|---|---|---|---|
| Gratuit | 30K/day (pool) | 10 | $0 |
| Données de base | 250K | 30 | 5 $/mois |
| Pour | 1.25M | 60 | 19 $/mois |
| Entreprises | 6.25M | 120 | 49 $/mois |
| Entreprise | Personnalisé | Personnalisé | Personne à contacter |
Boîtes 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
Alternative libre et open-source à Claude Code, Cursor et GitHub Copilot.
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 free tokens/day. BYOK supported. 346+ models. Session sync with Web IDE.
GitHub PyPI Web IDEBYOK (Appliquez votre propre clé)
Utilisez vos propres clés API de n'importe quel fournisseur. Le balisage zéro, les frais zéro. Free.ai vient juste de donner raison à la demande.
| Fournisseur | Format de la clé | Modèles | Marquage |
|---|---|---|---|
| Ouverture de l'AI | sk-proj-xxx | GPT-4o, GPT-4o Mini, o1, o3, etc. | $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 d'enregistrement, pas de déductions 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\