Welcome to the official docs for GPT4Free – free and convenient AI endpoints you can use directly in your apps, scripts, and even right in your browser. 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}")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>Examples
-
Text generation:
g4f client "Explain quantum computing in simple terms" -
Image description:
g4f client image.jpg "Describe this image" -
Image generation (with supported models):
g4f client -m flux -O output.jpg "A futuristic cityscape"
- API endpoints and usage *new
- Available Providers & Models
- Selecting a Provider
- Provider Documentation
- 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
- Routing with custom models (OpenClaw)
- 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/
-
Legal: The homepage and documentation may display ads served by Google AdSense. Usage logs and parts of prompts may be stored for up to 14 days to detect abuse and multiple accounts; account data of optional member accounts is kept for at least 90 days. See the Privacy Policy and Terms of Service.
-
Pollinations AI:
GPT4Free and g4f.dev are continuously improving. Have fun building, and let the bots do the heavy lifting for you!