Free.ai Docs
Bắt đầu nhanh trong 60 giây.
API trò chuyện tương thích với OpenAI. Một token Bearer, hơn 400 công cụ. Chạy cuộn này, sau đó đọc tiếp.
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!"}]}'Anh muốn xây gì?
Bắt đầu nhanh
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}Tạo ảnh
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}Sửa ảnh
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"Văn bản sang giọng nói
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}Từ nói sang văn bản
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"Dịch
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}SDK
Python
pip install freeai-code
Nodenpm i freeai-code
Đi đi
Ruby (đang tới)
Hoặc sử dụng OpenAI SDK — point base_url at api.free.ai/v1
Công thức
Câu hỏi thường gặp
Đăng ký tại /signup/, xác nhận email của bạn, và mở /account/?tab=api. Nhấn Create và một khóa Bearer (sk-free-...) sẽ xuất hiện. Lưu nó — vì an toàn chúng tôi chỉ hiển thị khóa đầy đủ một lần.
JSON. Phản hồi /v1/chat/ phản chiếu hình dạng OpenAI: choices[].message.content cho văn bản, cộng với một đối tượng sử dụng báo cáo chi phí token. Audio + image endpoints return a JSON envelope with output_url, share_url, and credits_used.
Yes — truyền stream:true trên yêu cầu chat. Phản hồi đến như Sự kiện gửi từ máy chủ với cùng một dữ liệu: {...} phong bì như giao thức truyền OpenAI. Thông điệp cuối cùng là data:[DONE].
Có. Chuyển một ma trận công cụ theo kiểu gọi công cụ OpenAI. Mô hình gọi công cụ bản địa trả về tool_calls có cấu trúc; các mô hình không bản địa quay lại một lời nhắc chế độ JSON phát ra cùng một hình dạng.
Có. Các mô hình trò chuyện có khả năng nhìn nhận chấp nhận các phần nội dung image_url (URLs hoặc base64). Đối với STT, POST âm thanh như là dữ liệu đa phần/trang vào /v1/stt/. Đối với PDF, dùng /v1/pdf/extract/ để OCR và trò chuyện về kết quả.
Một giới hạn gọi hàng tháng gắn với kế hoạch của bạn (1.000 miễn phí, 10.000 cơ bản, 100.000 chuyên nghiệp, 1M kinh doanh) cộng với số tiền còn lại của token đã mua. Không có giới hạn theo giây. Số tiền miễn phí hàng ngày chỉ áp dụng cho yêu cầu mạng, không phải gọi 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.
Chúng tôi ký mỗi webhook với HMAC-SHA256 trên cơ thể thô. Chữ ký là trong đầu X-Free-Signature (mật mã hóa hex). Từ chối bất kỳ tải trọng nào mà chữ ký không phù hợp với HMAC( bí mật_webhooks_của_Bạn, cơ thể_rượu).
{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.
Điểm kết thúc /v1/chat/ chấp nhận kiểu mẫu yêu cầu OpenAI ChatCompletion và trả lại cùng một hình dạng đáp ứng. Hầu hết mã khách hàng OpenAI hiện có hoạt động bằng cách thay đổi hai dòng — base_url + api_key.
Có — mọi mô hình tự lưu trữ là mã nguồn mở (Apache 2.0 / MIT). Thư viện gpu_api của chúng tôi là công khai; sao chép nó, cung cấp GPU của bạn, và chạy cùng một đống suy luận. Để cài đặt đám mây riêng tư được quản lý, liên hệ với chúng tôi.
Các mẫu tự lưu trữ chạy miễn phí trên hồ bơi 30.000 token hàng ngày của bạn, sau đó tính toán số token thô. Các mẫu Premium được trả theo cách bạn đi: 1.50 × giá bán lẻ, giảm xuống 1.30 × ở $ 500 / 30d và 1.15 × ở $ 2.000 / 30d.