Here you’ll find a clear overview, quick examples, and entry points to deeper docs for every major feature.
For full install guides—choose your method:
For rapid starts, you can use either Python or JavaScript (web).
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[0].message.content)Output:
Hello! How can I assist you today?
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[0].url}")More Python client info → and Async client →
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[0].url;
console.log(`Generated Image URL: ${imageUrl}`);
// Example: document.body.innerHTML += `<img src="${imageUrl}" />`;
</script>$ g4f client "Explain quantum computing"- Available Providers & Models
- Selecting a Provider
- API docs (full spec)
- File API Documentation (Files and Documents)
- Media Documentation (Audio, Image and Video)
- Vision Support (Image Upload)
- Image Editing & Variation
- Authentication, Configuration Guide (.har and cookies)
- Advanced: Create your own Provider
- Integrations: LangChain, PydanticAI
- GUI/WebUI, Phone, Backend API
- Troubleshooting
-
Open Source: GitHub: gpt4free/g4f.dev
-
Contribute & Report Bugs: PRs & issues are welcome!
-
Project Website: https://g4f.dev/
-
Pollinations AI:
GPT4Free and g4f.dev are continuously improving. Have fun building, and let the bots do the heavy lifting for you!
