Free.ai Docs
เริ่มเร็วใน 60 วินาที
โอเพนเอไอ-เหมาะสม API สนทนา หนึ่ง Bearer โต๊ะ, 400+ เครื่องมือ ทำงาน curl นี้, แล้วอ่านต่อ
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"
ข้อความเป็นเสียงName
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"
}
เครื่องมือพัฒนาโปรแกรมName
Python
pip install freeai-code
Nodenpm i freeai-code
ไป (กำลังมา)
รูบี้ (กำลังจะมาถึง)
หรือใช้ OpenAI SDK — พิมพ์ base_url ที่ api.free.ai/v1
วิธีการทำ
คำถามที่พบบ่อย
ลงทะเบียนที่ / signup /, ยืนยันอีเมลของคุณ และเปิด / account /? tab=api คลิกที่ สร้าง และกุญแจผู้ถือ (sk- free-...) จะปรากฏขึ้น บันทึกมันไว้ - เพื่อความปลอดภัย เราจะแสดงกุญแจเต็มเพียงครั้งเดียว
JSON การตอบสนอง /v1/chat/ สะท้อนรูปแบบ OpenAI: choices[].message.content สำหรับข้อความ, บวกกับวัตถุการใช้ที่รายงานค่าใช้จ่ายของท็อกน จุดจบของเสียง + ภาพ จะกลับมาเป็นซองจดหมาย JSON ที่มี output_url, share_url และ credits_used
ใช่ — ส่ง stream:true ไปยังคำร้องขอการสนทนา การตอบรับจะมาในรูปแบบ เหตุการณ์ส่งจากเซิร์ฟเวอร์ ด้วยข้อมูลเดียวกัน: {...} ซองจดหมาย เช่นเดียวกับโปรโตคอลสตรีม OpenAI ข้อความสุดท้ายจะเป็น data:[DONE]
ใช่ ส่งข้อมูล tools array ตามรูปแบบการเรียกใช้ tool ของ OpenAI โมเดลที่เรียกใช้ tool แบบพื้นฐาน จะคืนค่า tool_call ที่มีโครงสร้าง โมเดลที่เรียกใช้ tool แบบอื่นๆ จะกลับไปใช้คำสั่ง JSON-mode ที่ส่งออกรูปแบบเดียวกัน
ใช่ โมเดลการสนทนาที่รองรับการมองเห็นสามารถรับส่วนของเนื้อหา image_url (URL หรือ base64) ได้ สำหรับ STT, POST เสียงเป็น multipart/form-data ไปยัง /v1/stt/ สำหรับ 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.
เราเซ็นทุก webhook ด้วย HMAC-SHA256 บนส่วนตัวของ webhook ตัวจริง ลายเซ็นอยู่ในส่วนหัว X-Free-Signature (ถูกเข้ารหัสเป็น hex) ปฏิเสธการส่งข้อมูลที่ลายเซ็นไม่ตรงกับ 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 ของคุณ, และทำงานสแต็คการสรุปเดียวกัน สำหรับการติดตั้งคลาวด์ส่วนตัวที่จัดการได้ โปรดติดต่อเรา
โมเดลที่โฮสต์เอง ทำงานฟรีบน 30,000 โต๊ะของคุณในแต่ละวัน, จากนั้นจดบันทึกจำนวนโต๊ะที่ไม่ใช้แล้ว โมเดลพิเศษคือการจ่ายตามที่คุณไป: 1.50 × รายละเอียดการขาย, ลดลงเป็น 1.30 × ที่ $500/30d และ 1.15 × ที่ $2,000/30d.