Free.ai API

하나의 API 키, 모든 AI 도구, 간단한 토큰 청구.

어떻게 작동하는지

1
API 키 가져오기

토큰을 구입한 후 sk-free- 키를 생성하십시오.

2
모든 엔드포인트 호출

Chat, 이미지, TTS, STT, 음악, 번역 - 모든 하나의 API

3
토큰으로 지불

하나의 균형. 모든 도구는 토큰 비용. 간단합니다.

빠른 시작

# 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);

토큰 가격 정책

모든 도구에 대해 하나의 잔액을 사용합니다. API 또는 웹 사이트를 사용하는 경우 동일한 가격.

셀프 호스팅 모델 가장 저렴한
모델종류토큰 비용라이선스
Qwen 2. 5 7B코드실제 사용된 토큰 (입력+출력)Apache 2.0 로 복사
크기이미지 생성이미지당 5,000 토큰Apache 2.0 로 복사
Kokoro 로 복사텍스트 음성 변환기4 문자당 1 토큰Apache 2.0 로 복사
faster-whisper 로 복사음성을 텍스트로초당 4 토큰의 오디오MIT 메디컬 센터
AudioLDM 2 로 복사음악 생성트랙당 2,000 토큰Apache 2.0 로 복사
MadLAD-400 로 복사번역 (450+ 언어)실제 사용된 토큰Apache 2.0 로 복사
Real-ESRGAN 로 복사이미지 크기 조정이미지당 500 토큰BSD
브리아 렙배경 제거이미지당 500 토큰Apache 2.0 로 복사
CogVideoX 로 복사비디오 생성30,000 tokens/videoApache 2.0 로 복사
Stem Separator (Mel-Band RoFormer + SCNet)보컬 분리500 토큰/트랙MIT + Apache-2.0
외부 모델 579 models

GPT-6, Claude, Gemini, Llama, DeepSeek 및 나머지 579 모델에 액세스합니다. 토큰 비용은 당사 토큰으로 변환된 공급업체 가격을 기반으로 합니다.

모델공급자메시지당 토큰메모
GPT-4의 미니오픈AI~20저렴하고 빠르게
Gemini 2.0 플래시구글~15매우 빠르게
Mistral 에 대한 메시지Mistral 로 복사~10훌륭한 가치
DeepSeek 버전 3DeepSeek 로 복사~30강한 추론
Llama 3. 3 70B목표~25오픈 웨이트
Claude Sonnet 4 페이지 1 페이지 2애니메이션~400프리미엄 품질
GPT-4 을( 를) 찾을 수 없습니다.오픈AI~325프리미엄 품질
Qwen 2. 5 72B알리바바~40크고, 능력이 있습니다

Full list of 579 models at /models/. All use the same /v1/chat/ endpoint - just change the model parameter.

토큰 공식

자체 호스팅 모델: 사용한 정확한 토큰을 지불합니다. 마킹이 없습니다.

외부 모델: our_tokens = provider_usd_cost × 100,000 × 1.30

예: GPT-4o는 1K 프롬프트 토큰당 $0.0025의 비용이 듭니다. 1,000 토큰의 경우: $0.0025 × 100,000 × 1.30 = 325 토큰 귀하의 잔액에서.

모든 엔드포인트

Chat / 법률
POST /v1/chat/Chat 모델(자체 호스팅 또는 외부)을 사용합니다. 스트리밍 지원.
이미지
POST /v1/image/generate/이미지로 텍스트 (FLUX, SDXL)
POST /v1/image/edit/Inpaint, outpaint, 스타일 전송
POST /v1/image/enhance/2x/4x 업스케일 (Real-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/오디오/비디오 녹음 (faster-whisper, 99개 언어)
음악 & 오디오
POST /v1/music/generate/텍스트 설명에서 음악 생성
POST /v1/music/separate/별도의 보컬/스템 (Mel-Band RoFormer + SCNet)
텍스트 도구
POST /v1/write/콘텐츠 생성(에세이, 이메일, 스토리 등)
POST /v1/code/generate/모든 언어로 코드 생성
POST /v1/summarize/텍스트 요약
POST /v1/humanize/AI 텍스트를 인간답게 들리게 만들기
POST /v1/detect/AI 생성 콘텐츠 감지
번역 및 OCR
POST /v1/translate/텍스트 번역 (MadLAD-400, 450개 이상의 언어)
POST /v1/ocr/이미지에서 텍스트 추출
유틸리티
GET /v1/modelsList all available models (self-hosted + external)
GET /v1/status/{job_id}/비동기 작업 상태 확인
GET /healthAPI 상태 검사

인증

API 키를 Authorization 헤더에 포함합니다.

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 요청/분가격
자유30K/일 (풀)10$0
기본250K30$5/월
프로1.25M60$19/월
비즈니스6.25M120$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"
PyPI PyPI 플러그인
CLI 코딩 지원

Claude 코드, 커서 및 GitHub Copilot에 대한 무료, 오픈 소스 대안.

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 무료 토큰 / 하루. BYOK 지원. 579 모델. Web IDE와 세션 동기화.

PyPI PyPI 플러그인 웹 IDE

BYOK(자신의 키를 가져오기)

모든 공급자의 API 키를 사용합니다. 제로 마킹, 제로 수수료. Free.ai는 단지 요청을 프록시합니다.

공급자키 형식모델마크업
오픈AIsk-proj-xxxGPT-4o, GPT-4o 미니, o1, o3 등$0
애니메이션sk-ant-xxxClaude Sonnet 4, 오푸스 4, 하이쿠 등$0
구글AIzaSyxxxGemini 2.5 프로, 플래시 등$0
다른 제공자sk-or-xxx etc.모든 공급자의 579 모델$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 FAQ 에 대한 질문

무료 계정은 하루에 30K 토큰을 받습니다. 유료 계획은 더 많은 토큰과 더 높은 속도 제한을 제공합니다.

아니요! 동일한 토큰, 동일한 가격. 토큰 잔액은 웹사이트와 API 사이에 공유됩니다. 둘 다 사용, 동일한 비용.

같은 엔드포인트에서 모델 매개변수를 변경하면 됩니다. 예를 들어, "model": "openai/gpt-4o" 또는 "model": "anthropic/claude-sonnet-4". 전체 목록은 /models/ 또는 GET /v1/models 에서 찾을 수 있습니다.

예! /v1/chat/ 엔드포인트는 OpenAI 채팅 완성 형식을 따릅니다. OpenAI와 호환되는 모든 SDK를 사용할 수 있습니다. 기본 URL을 https://api.free.ai로 변경하고 Free.ai API 키를 사용하는 것만으로 충분합니다.

네! 채팅 요청에서 "stream": true를 설정합니다. 응답은 서버 전송 이벤트(SSE)를 통해 전달됩니다.

402 응답과 오류 메시지가 표시됩니다. /pricing/에서 토큰을 더 구입하거나 일일 무료 풀이 리셋될 때까지 기다려 주세요. 셀프 호스팅 모델은 일일 한도 내에서 항상 사용할 수 있습니다.

예! 모든 셀프 호스팅 모델은 MIT/Apache 2.0 라이센스입니다. 생성 된 콘텐츠는 상업적 용도로 사용할 수 있습니다.

자체 호스팅: GPU에서 실행됩니다. 가장 저렴하고, 가장 빠르며, 가장 개인적입니다. 외부: 모델 제공자에 프록시됩니다. GPT-4, Claude, Gemini 등에 액세스합니다. 제공자 API 수수료로 인해 더 많은 토큰이 필요합니다.

/account/에서 계정 페이지를 방문하거나 각 API 응답에서 free_ai_usage.tokens_charged 필드를 확인합니다.

Yes! Install our Python SDK: 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

99.9% 가동 시간을 목표로 합니다. Enterprise 플랜에는 SLA 보증이 포함되어 있습니다. /health 에서 실시간 상태를 확인하십시오.

hello@free.ai 로 이메일을 보내거나 /contact/ 를 방문하십시오. Pro+ 계획은 우선 지원을 받습니다. 오류 응답에는 디버깅을 위한 error_id가 포함됩니다.

Love Free.ai? Tell your friends!

이 페이지 평가하기