Free.ai Docs
60秒でクイックスタート
OpenAI 互換のチャット API。1つのベアトークン、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"テキスト・トゥ・スピーチ
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
来る
Ruby (来週)
またはOpenAI SDKを使って api.free.ai/v1 に base_url を指定してください。
レシピ
よくある質問
/signup/ で登録し、メールアドレスを確認し、 /account/?tab=api を開きます。 生成をクリックすると、持ち主キー (sk-free-...) が表示されます。保存してください。安全のため、鍵の全文は一度だけ表示されます。
音声と画像のエンドポイントは output_url, share_url, credits_used を含む JSON エンベロープを返します。
チャット要求に stream:true を渡す。応答は OpenAI ストリーミングプロトコルと同じ data:{...} エンベロープを持つサーバ送信イベントとして到着します。最終メッセージは data:[DONE] です。
はい。OpenAIツール呼び出しスキームに従ってツール配列を渡します。ネイティブツール呼び出しモデルは構造化された tool_calls を返します。非ネイティブモデルは同じ形を出力する JSONモードプロンプトに戻ります。
はい。ビジョンサポートチャットモデルは image_url コンテンツの一部 (URL または base64) を受け入れます。STT の場合、オーディオを multipart/form-data として /v1/stt/ に POST します。PDF の場合、OCR に /v1/pdf/extract/ を使用し、結果についてチャットします。
プランに関連付けられた月間通話制限 (無料 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 で署名されます。署名は X-Free-Signature ヘッダ (十六進法エンコード) にあります。署名が 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.
これは、OpenAI ChatCompletion のリクエストスキームを受け入れ、同じ応答形式を返します。 ほとんどの既存の OpenAI クライアントコードは、 base_url + api_key の2行を変更することで動作します。
はい、すべてのセルフホストモデルはオープンソース (Apache 2.0 / MIT) です。私たちの gpu_api リポジトリは公開されています。クローンして、GPUを提供し、同じ推論スタックを実行してください。管理されたプライベートクラウドインストールの場合は、私たちに連絡してください。
プレミアモデルは、小売価格の1.50倍、$500/30日で1.30倍、$2,000/30日で1.15倍に下がる、使用分ごとに支払う。ライブコストは、モデルページごとに、API応答ごとに、トークン充填は$1から始まる。