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/Write/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 | 30 000 jetons/vidéo | Apache 2.0 |
| Stem Separator (Mel-Band RoFormer + SCNet) | Séparation vocale | 500 jetons/piste | MIT + Apache-2.0 |
Accès GPT-6, Claude, Gemini, Llama, DeepSeek et le reste des modèles 579. Le coût de la jeton est basé sur les prix du fournisseur convertis en nos 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 |
Tous les modèles 579 sont utilisés au point d'arrivée /models/. Tous utilisent le même paramètre /v1/chat/ - il suffit de changer le paramètre model.
Modèles auto-organisés: Vous payez les jetons utilisés.
Modèles externes: our_tokens = provider_usd_cost × 100,000 × 1.30
Exemple : GPT-4o coûte 0,0025 $ par jeton d'appel 1K. Pour 1 000 jeton : 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 l'image (FLUX, SDXL) |
POST /v1/image/edit/ | Inpaint, outpaint, transfert de style |
POST /v1/image/enhance/ | 2x/4x (Real-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 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/stems séparés (Mel-Band RoFormer + SCNet) |
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 l'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"
PyPI
PyPI
Assistant de codage de l'ICL
Option libre et open source pour le code Claude, le curseur et le copilote GitHub.
pip install freeai-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 jetons gratuits/jour. BYOK supporté. modèles 579. Synchronisation de session avec Web IDE.
PyPI 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 de proxénéter la requête.
| Fournisseur | Format de la clé | Modèles | Marquage |
|---|---|---|---|
| Ouvrir 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. | modèles 579 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": "anthropique/claude-sonnet-4". Liste complète à /modèles/ ou GET /v1/modèles."stream": true dans votre demande de chat. Les réponses sont fournies via Server-Sent Events (SSE).free_ai_usage.tokens_charged dans chaque réponse de l'API.pip install free-dot-ai. It wraps every endpoint with typed responses. For coding assistance, install pip install freeai-code. The API also follows OpenAI's format, so you can use the openai Python/Node SDK with our base URL. API docs