FreeTheAi

Code Examples

<details> <summary><b>Chat — curl</b></summary> <br>

curl https://api.freetheai.xyz/v1/chat/completions \
  -H "Authorization: Bearer $FREETHEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bbg/moonshotai/Kimi-K2.5",
    "messages": [
      { "role": "user", "content": "Write a Python hello world." }
    ],
    "stream": true
  }'

</details>

<details> <summary><b>Chat — JavaScript</b></summary> <br>

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.FREETHEAI_API_KEY,
  baseURL: "https://api.freetheai.xyz/v1",
});

const res = await client.chat.completions.create({
  model: "bbg/moonshotai/Kimi-K2.5",
  messages: [{ role: "user", content: "Say hello." }],
});

console.log(res.choices[0].message.content);

</details>

<details> <summary><b>Chat — Python</b></summary> <br>

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.freetheai.xyz/v1",
)

res = client.chat.completions.create(
    model="bbg/moonshotai/Kimi-K2.5",
    messages=[{"role": "user", "content": "Say hello."}],
)

print(res.choices[0].message.content)

</details>

<details> <summary><b>Messages API — curl</b></summary> <br>

curl https://api.freetheai.xyz/v1/messages \
  -H "Authorization: Bearer $FREETHEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bbg/moonshotai/Kimi-K2.5",
    "max_tokens": 256,
    "messages": [
      { "role": "user", "content": "Write a migration plan." }
    ]
  }'

</details>

<details> <summary><b>Tool calling — Python</b></summary> <br>

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.freetheai.xyz/v1",
)

res = client.chat.completions.create(
    model="wsf/swe-1.6",
    tool_choice="required",
    messages=[{"role": "user", "content": "Get weather for Boston."}],
    tools=[{
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "Get the weather for a city.",
            "parameters": {
                "type": "object",
                "properties": {"city": {"type": "string"}},
                "required": ["city"],
                "additionalProperties": False,
            },
        },
    }],
)

print(res.choices[0].message.tool_calls)

</details>

<details> <summary><b>Image generation — curl</b></summary> <br>

curl https://api.freetheai.xyz/v1/images/generations \
  -H "Authorization: Bearer $FREETHEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "img/gpt-image-2",
    "prompt": "A neon sports car under rainy city lights"
  }'

The free API exposes img/gpt-image-2 for both generation and editing. Live availability and any future image models are in GET /v1/models.

Robust clients should support both response shapes:

• data[0].b64_json for base64 image data
• data[0].url for a generated image URL

</details>

<details> <summary><b>Image editing — Python</b></summary> <br>

import base64, requests, os

def edit_image(prompt, image_path):
    with open(image_path, "rb") as f:
        data_url = "data:image/png;base64," + \
            base64.b64encode(f.read()).decode()

    return requests.post(
        "https://api.freetheai.xyz/v1/images/edits",
        headers={
            "Authorization": f"Bearer {os.environ['FREETHEAI_API_KEY']}",
            "Content-Type": "application/json",
        },
        json={
            "model": "img/gpt-image-2",
            "prompt": prompt,
            "image": data_url,
        },
    ).json()

See examples/image_client.py for a beginner-friendly CLI tool that saves the key locally and handles both b64_json and url image responses.

</details>

---