어떻게 작동하는지
API 키 가져오기
토큰을 구입한 후 sk-free- 키를 생성합니다.
모든 엔드포인트 호출
채팅, 이미지, TTS, STT, 음악, 번역 — 모두 하나의 API
토큰으로 지불
하나의 균형. 모든 도구 비용 토큰. 간단합니다.
빠른 시작
# 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 또는 웹사이트를 사용하는 경우에도 동일한 가격을 적용합니다.
| 모델 | 종류 | 토큰 비용 | 라이선스 |
|---|---|---|---|
| __ 프리아이 테름 13__ 2.5 7B | 채팅/쓰기/코드 | 실제 사용된 토큰 (입력+출력) | 아파치 2. 0 |
| FLUX.1 빠른 | 이미지 생성 | 1,000 토큰/이미지 | 아파치 2. 0 |
| 코코로 | 텍스트 음성 변환기Name | 4 문자당 1 토큰 | 아파치 2. 0 |
| 빠른 속삭임 | 음성을 텍스트로 | 초당 4개의 오디오 토큰 | MIT 로스쿨 |
| 오디오LDM 2 | 음악 생성 | 2,000 토큰/트랙 | 아파치 2. 0 |
| 메이드라드-400 | 번역 (450+ 언어) | 실제 사용된 토큰 | 아파치 2. 0 |
| 실제 검색 | 이미지 크기 조정 | 500 토큰/이미지 | BSD |
| 브리아 렙그 | 배경 제거 | 500 토큰/이미지 | 아파치 2. 0 |
| 코그비디오X | 비디오 생성 | 5,000 토큰/비디오 | 아파치 2. 0 |
| 데뮤크 | 보컬 분리 | 500 토큰/트랙 | MIT 로스쿨 |
GPT-4, Claude, Gemini, Llama, DeepSeek, 그리고 340+ 이상의 모델들을 액세스하세요. 토큰 비용은 토큰으로 변환된 공급자 가격을 기반으로 합니다.
| 모델 | 공급자 | 메시지당 토큰 | 메모 |
|---|---|---|---|
| GPT-4o 미니 | 오픈AI | ~20 | 저렴하고 빠르게 |
| Gemini 2.0 플래시 | 구글 | ~15 | 매우 빠르게 |
| 니모 | __ 12 년 __ | ~10 | 훌륭한 가치 |
| __ 프리아이 터미널 11__ V3 | __ 11 년 __ | ~30 | 강한 추론 |
| Llama 3.3 70B 14개의 글자 | 목표 | ~25 | 오픈 웨이트 |
| Claude Sonnet 4 페이지 1 페이지 2 | 애니메이션 | ~400 | 프리미엄 품질 |
| __ 프리 터미널 9 _ o | 오픈AI | ~325 | 프리미엄 품질 |
| Qwen 2.5 72B 100% 완벽한 품질의 음악을 즐기세요. | 알리바바 | ~40 | 크고, 능력이 있습니다 |
/apps/에서 346+ 모델의 전체 목록을 볼 수 있습니다. 모두 같은 /v1/chat/ 엔드포인트를 사용합니다.
셀프 호스팅 모델: 사용한 정확한 토큰만 지불하세요.
외부 모델: our_tokens = provider_usd_cost × 100,000 × 1.30
예: GPT-4o는 1K 프롬프트 토큰당 $0.0025의 비용이 듭니다. 1,000 토큰의 경우: $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/ | 별도의 보컬/스템 (Demucs) |
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/ | 이미지에서 텍스트 추출 |
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/월 |
| 엔터프라이즈 | 사용자 정의 | 사용자 정의 | 연락처 |
사용 가능한 토큰 팩: 200K/$5, 1M/$15, 5M/$40. 토큰은 만료되지 않습니다.
파이썬 SDK & CLI
파이썬 SDK
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 코드, 커서, 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+ 모델. 웹 IDE와 세션 동기화.
GitHub PyPI Web IDEBYOK(자신의 키를 가져오기)
모든 공급자의 API 키를 사용합니다. 제로 마킹, 제로 수수료. Free.ai은 요청을 프록시합니다.
| 공급자 | 키 형식 | 모델 | 마크업 |
|---|---|---|---|
| 오픈AI | sk-proj-xxx | GPT-4o, GPT-4o 미니, o1, o3 등 | $0 |
| 애니메이션 | sk-ant-xxx | Claude Sonnet 4, 오푸스 4, 하이쿠 등 | $0 |
| 구글 | AIzaSyxxx | Gemini 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 잔액에서 토큰 공제 없음
API 자주 묻는 질문
"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를 설치하세요.