どうやって働くのか
API キーを取得
トークンを購入し、sk-free- キーを生成します
任意のエンドポイントを呼び出す
チャット、画像、TTS、STT、音楽、翻訳 - すべて一つのAPI
トークンで支払う
1つのバランス すべてのツールはトークンで 簡単だ
クイックスタート
# 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);
トークン価格
すべてのツールに対して一つのバランスを設定し、APIとウェブサイトを使用するときに同じ価格で提供します。
| モデル | タイプ | トークンコスト | ライセンス |
|---|---|---|---|
| クウェン2.5 7B | チャット/書き込み/コード | 実際に使用されたトークン (入力+出力) | アパッチ |
| FLUX.1 シュペルト | イメージ生成 | 1000トークン/画像 | アパッチ |
| こころ | テキストから音声へ | 4文字につき1トークン | アパッチ |
| ファスター・ウィスパー | 音声からテキストへ | 音声の速度は 4トークン/秒です | MIT |
| オーディオLDM 2 | ミュージック・ジェネレーション | トラック2000枚 | アパッチ |
| マッドラッド400 | 翻訳 (450+ 言語) | 実際に使用されたトークン | アパッチ |
| リアル・エスルガン | 画像アップスケール | 500トークン/画像 | BSD |
| ブラジル国鉄 | 背景を削除 | 500トークン/画像 | アパッチ |
| コグビデオX | 動画生成 | 5000トークン/ビデオ | アパッチ |
| デムクス | 音節分離 | トラック当たり500トークン | MIT |
アクセス GPT-4, Claude, Gemini, Llama, DeepSeek, 340+ 以上のモデル。トークンコストはプロバイダの価格に基づいて、我々のトークンに変換されます。
| モデル | プロバイダ | メッセージごとのトークン | ノート |
|---|---|---|---|
| GPT-4oミニ | OpenAI | ~20 | 安くて速い |
| ジェミニ2.0フラッシュ | グーグル | ~15 | とても速い |
| ミストラル・ネモ | ミストラル | ~10 | 偉大な価値 |
| ディープシーク | ディープシーク | ~30 | 強力推論 |
| ラマ3.3 70B | メタ | ~25 | オープンウェイト |
| クロード・ソネット第4番 | 人間 | ~400 | プレミアム品質 |
| GPT-4o | OpenAI | ~325 | プレミアム品質 |
| クウェン2.5 72B | アリババ | ~40 | 大きくて 能力がある |
346以上のモデルの完全なリストは /apps/ にあります。すべて同じ /v1/chat/ エンドポイントを使用します。 model パラメータを変更するだけです。
自己ホストモデル: 使ったトークンを払う 値引きはない
外部モデル: our_tokens = provider_usd_cost × 100,000 × 1.30
Example: GPT-4o costs $0.0025 per 1K prompt tokens. For 1,000 tokens: $0.0025 × 100,000 × 1.30 = 325枚 残高から。
すべてのエンドポイント
POST /v1/chat/ | どのモデルともチャットできます。ストリーミングもサポートします。 |
POST /v1/image/generate/ | テキストから画像 (FLUX, SDXL) |
POST /v1/image/edit/ | インペイント、アウトペイント、スタイル転送 |
POST /v1/image/enhance/ | アップスケール 2x/4x (リアル-ESRGAN) |
POST /v1/image/remove-bg/ | 背景を削除 (BRIA RMBG) |
POST /v1/video/generate/ | テキスト/画像をビデオに変換 (CogVideoX) |
POST /v1/tts/ | 音声生成 (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | ストリーミング TTS (リアルタイムオーディオチャンク) |
POST /v1/stt/transcribe/ | オーディオ/ビデオを転写 (99 言語) |
POST /v1/music/generate/ | テキスト説明から音楽を生成 |
POST /v1/music/separate/ | 独立した声部/ステム(デムクス) |
POST /v1/write/ | コンテンツを生成 (エッセイ、メール、ストーリーなど) |
POST /v1/code/generate/ | 任意の言語でコードを生成 |
POST /v1/summarize/ | テキストを要約 |
POST /v1/humanize/ | AI テキストを人間のように聞こえるようにします |
POST /v1/detect/ | AI 生成コンテンツを検出 |
POST /v1/translate/ | テキストを翻訳します (MadLAD-400, 450 以上の言語) |
POST /v1/ocr/ | 画像からテキストを抽出Name |
GET /v1/models | List all available models (self-hosted + external) |
GET /v1/status/{job_id}/ | 非同期ジョブの状態をチェック |
GET /health | APIヘルスチェック |
認証
ヘッダ Authorization に API キーを含めます:
Authorization: Bearer sk-free-YOUR_API_KEY
各応答には、使用されたトークンを示す free_ai_usage ブロックが含まれます。
{
"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"
}
}
料金制限とプラン
ウェブサイトとAPIで同じトークン価格。別々のAPI価格はありません。
| プラン | トークン/月 | API 要求/分 | プライス |
|---|---|---|---|
| 自由 | 5K/日(プール) | 10 | $0 |
| ベーシック | 250K | 30 | 月5ドル |
| プロ | 1.25M | 60 | 月額19ドル |
| ビジネス | 6.25M | 120 | 月額49ドル |
| エンタープライズ | カスタム | カスタム | コンタクト |
20万/5ドル、100万/15ドル、500万/40ドルのトークンパックが利用可能です。トークンは無効化されません。
Python SDK と CLI
Python開発ツールキット
Pythonコードから全てのAIツールにアクセスできます。
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
CLI プログラミングアシスタント
Claude Code、Cursor、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"
5K 無料トークン/日。BYOK サポート。346以上のモデル。Web IDE とのセッション同期。
GitHub PyPI Web IDEBYOK(自分の鍵を持って来い)
任意のプロバイダから自分のAPIキーを使用できます。 ゼロのマークアップ、ゼロの手数料。 Free.aiは 要求を代理するだけだ
| プロバイダ | 鍵のフォーマット | モデル | マークアップ |
|---|---|---|---|
| OpenAI | sk-proj-xxx | GPT-4o、GPT-4oミニ、o1、o3など | $0 |
| 人間 | sk-ant-xxx | クロード・ソネット第4番、オペラ第4番、俳句など | $0 |
| グーグル | AIzaSyxxx | ジェミニ2.5プロ、フラッシュなど | $0 |
| 他のプロバイダ | sk-or-xxx etc. | 346以上のモデルを全てのプロバイダから | $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
鍵も使い方も 請求書も 記録もない Free.aiドルの残高から 切り落とすこともない
APIFAQ
"model": "openai/gpt-4o" または "model": "anthropic/claude-sonnet-4"。詳細は /apps/ または GET /v1/models を参照してください。"stream":trueを設定してください。応答はサーバ送信イベント (SSE) を通して送信されます。free_ai_usage.tokens_charged フィールドをチェックしてください。pip install free-dot-ai。これは、すべてのエンドポイントをタイプされた応答で包み込みます。コードの助けを求める場合は、pip install free-dot-ai-codeをインストールしてください。APIは OpenAI にも従います。