Free.ai Docs
60초만에 빠른 시작.
OpenAI 호환 채팅 API. 하나의 베어러 토큰, 400개 이상의 도구. 이 컬을 실행한 다음 계속 읽어보세요.
curl https://api.free.ai/v1/chat/ \
-H "Authorization: Bearer sk-free-YOUR-KEY" \
-H "Content-Type: application/json" \
-d '{"model":"qwen2.5-7b","messages":[{"role":"user","content":"Hello!"}]}'무엇을 만들고 싶으십니까?
빠른 시작
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}이미지 생성
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}이미지 편집
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"텍스트 음성 변환기
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}음성을 텍스트로
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"번역
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}SDK
Python
pip install freeai-code
Nodenpm i freeai-code
가자
루비 (곧 출시)
또는 OpenAI SDK를 사용하여 api.free.ai/v1 에서 base_url 을 지정합니다.
레시피
자주 묻는 질문
/signup/ 에서 등록하고, 이메일을 확인하고, /account/?tab=api 를 엽니다. 생성 을 클릭하면 보유자 키 (sk-free-...) 가 나타납니다. 저장하십시오. 보안을 위해 전체 키를 한 번만 표시합니다.
JSON. /v1/chat/ 응답은 OpenAI 형태를 반영합니다. 텍스트에 대한 choices[].message.content 와 토큰 비용을 보고하는 사용 객체가 추가됩니다. 오디오 + 이미지 엔드포인트는 output_url, share_url, credits_used가 포함된 JSON 봉투를 반환합니다.
Yes — 채팅 요청에 stream:true 를 전달합니다. 응답은 OpenAI 스트리밍 프로토콜과 동일한 data: {...} 봉투를 가진 Server-Sent 이벤트로 도착합니다. 마지막 메시지는 data:[DONE] 입니다.
OpenAI 툴 호출 스키마에 따라 tools 배열을 전달합니다. 네이티브 툴 호출 모델은 구조화된 tool_calls를 반환하며, 비네이티브 모델은 동일한 형태를 내보내는 JSON 모드 프롬프트로 돌아갑니다.
예. 비전 지원 채팅 모델은 image_url 콘텐츠 부분(URL 또는 base64)을 허용합니다. STT의 경우 오디오를 multipart/form-data로 /v1/stt/로 POST합니다. PDF의 경우 /v1/pdf/extract/을 사용하여 OCR을 수행하고 결과에 대해 채팅합니다.
플랜에 묶인 월간 통화 제한(1,000 무료, 10,000 기본, 100,000 프로, 1M 비즈니스)과 구입한 토큰 잔액. 초당 초과 제한이 없습니다. 일일 무료 풀은 API 호출이 아닌 웹 요청에만 적용됩니다.
freeai-code on npm + PyPI for our Coder IDE wrapper. For the raw API, the OpenAI SDKs (Python + Node) and most LLM frameworks (LangChain, LlamaIndex, Vercel AI SDK) work — set base_url to https://api.free.ai/v1 and your Bearer key.
모든 웹훅은 원본 본문 위에 HMAC-SHA256로 서명합니다. 서명은 X-Free-Signature 헤더에 있습니다(16진수로 인코딩). 서명이 HMAC(your_webhook_secret, raw_body)와 일치하지 않는 페이로드는 거부합니다.
{error:{message, type, code}}. 402 = out of credits (response includes upgrade URL + shortfall in tokens). 429 = daily pool exhausted (web only). 400 = validation error. 5xx = our problem; retry with exponential backoff.
/v1/chat/ 엔드포인트는 OpenAI ChatCompletion 요청 스키마를 받아들이고 동일한 응답 형태를 반환합니다. 대부분의 기존 OpenAI 클라이언트 코드는 base_url + api_key 두 줄을 변경하여 작동합니다.
예 — 모든 셀프 호스팅 모델은 오픈 소스입니다(Apache 2.0 / MIT). gpu_api 레포는 공개되므로 복제하고 GPU를 공급하고 동일한 추론 스택을 실행하십시오. 관리형 프라이빗 클라우드 설치를 원하시면 저희에게 문의하십시오.
프리미엄 모델은 사용량에 따라 지불합니다. 소매 마크업 1.50배, $500/30일에 1.30배, $2,000/30일에 1.15배로 떨어집니다. 라이브 비용은 모든 모델 페이지와 API 응답에 대해 적용되며 토큰 충전은 $1부터 시작됩니다.