API Documentation
OpenAI-compatible. Generate images and video with one API.
Generate your first image in 4 lines
from openai import OpenAI
client = OpenAI(
base_url="https://api.fluxpool.ai/v1",
api_key="fp_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
)
response = client.images.generate(
model="flux-2-pro",
prompt="A dragon perched on a neon-lit Tokyo rooftop, 8K",
size="1024x1024"
)
# response.data[0].url is a presigned S3 URL — poll it (GET with
# Range: bytes=0-0) until the file is ready. Expires after 1 hour.
print(response.data[0].url) Explore the docs
- ⚡
Quickstart
Generate your first image and video in under 2 minutes.
Read → - 🔑
Authentication
API keys, headers, and auth patterns.
Read → - 🖼️
Image Generation
Endpoints, parameters, and supported image models.
Read → - 🎬
Video Generation
Text-to-video, image-to-video, and async patterns.
Read → - 🧩
Models
Full model list with IDs, capabilities, pricing, and parameters.
Read → - 📦
SDKs & Libraries
Use the OpenAI SDK today. Native Fluxpool SDKs coming soon.
Read → - 🔗
Async & Polling
How to poll presigned URLs and generation status. Webhooks coming soon.
Read → - 🤖
MCP Server
Use Fluxpool from Claude Desktop and other MCP-compatible agents.
Read → - 📖
API Reference
Full endpoint reference with interactive examples.
Open →
💡 Already using the OpenAI SDK?
You're 90% done. Change the base URL to https://api.fluxpool.ai/v1 and use your Fluxpool API key. That's it. All OpenAI image generation SDK methods work out of the box.
Install
pip install openai Python (OpenAI SDK)
npm install openai Node.js (OpenAI SDK)
cURL / REST
The official OpenAI SDK works with Fluxpool. No proprietary SDK required. View all SDK options →
Base configuration
https://api.fluxpool.ai/v1 Authorization: Bearer fp_live_xxx fp_live_ + 40 hex chars application/json Supported models
The canonical model list is served live by the API. Call GET /v1/models to see everything you can call today. Two verified examples to get you started:
| Model ID | Type | Endpoint |
|---|---|---|
flux-2-pro | Image | /v1/images/generations |
seedance-v2 | Video | /v1/videos/generations |
Need help?
Email us for account, billing, or API questions. We usually reply within one business day.
hi@fluxpool.ai