GPT4Free Documentation Hub

Welcome to the official docs for GPT4Free – free and convenient AI endpoints you can use directly in your apps, scripts, and browser. Here you’ll find clear overviews, quick examples, and entry points to deeper docs for every major feature.

Installation & Setup

For full install guides — choose your method:

For rapid starts, you can use either Python or JavaScript (web).

Getting Started

📝 Text Generation

Python example for chat completion (with and without web search):

from g4f.client import Client

client = Client()
response = client.chat.completions.create(
    model="gpt-4.1",  # Try "gpt-4o", "deepseek-v3", etc.
    messages=[{"role": "user", "content": "Hello"}],
    web_search=False
)
print(response.choices.message.content)

Output:

Hello! How can I assist you today?

🎨 Image Generation

Generate images with a single call (returns URLs or base64):

from g4f.client import Client

client = Client()
response = client.images.generate(
    model="flux",  # Other models: 'dalle-3', 'gpt-image', etc.
    prompt="a white siamese cat",
    response_format="url"
)
print(f"Generated image URL: {response.data.url}")

More Python client info → and Async client →

🧙‍♂️ Using GPT4Free.js

Use the official JS client right in the browser—no backend needed.

For text generation:

<script type="module">
    import Client from 'https://g4f.dev/dist/js/client.js';

    const client = new Client();
    const result = await client.chat.completions.create({
        model: 'gpt-4.1',  // Or "gpt-4o", "deepseek-v3"
        messages: [{ role: 'user', content: 'Explain quantum computing' }]
    });
    console.log(result.choices[0].message.content);
</script>

And for image generation:

<script type="module">
    import Client from 'https://g4f.dev/dist/js/client.js';

    const client = new Client();
    const response = await client.images.generate({
        model: "flux", // Or "dalle-3", "gpt-image"
        prompt: "a white siamese cat"
    });
    const imageUrl = response.data.url;
    console.log(`Generated Image URL: ${imageUrl}`);
    // Example: document.body.innerHTML += `<img src="${imageUrl}" />`;
</script>

See more JS client usage →

💻 Using CLI Client

$ g4f client "Explain quantum computing"

CLI Client documentation →

Deep Dives

Community & Links

GPT4Free and g4f.dev are continuously improving. Have fun building, and let the bots do the heavy lifting for you!

← Back to GPT4Free GitHub