OpenAI-compatible API

Use Floodgate with curl and OpenAI SDKs.

Floodgate implements a standard OpenAI-compatible API at:

https://api.floodgate.dev/v1

Send your API key as a bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

---

Available Endpoints

Endpoint	Method	Purpose
/v1/models	GET	List all models available to your account
/v1/chat/completions	POST	Generate chat completions, reasoning, and tool calls
/v1/responses	POST	Responses wire API for Codex CLI and modern agent clients
/v1/images/generations	POST	Generate images using gpt-image-2 or gpt-image-2.5
/v1/images/edits	POST	Edit images or inpaint using text prompts and masks

---

Chat Completions

cURL

curl "https://api.floodgate.dev/v1/chat/completions" \
  -H "Authorization: Bearer $FLOODGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-sol",
    "messages": [
      {"role": "user", "content": "Write a TypeScript debounce function with proper generics."}
    ],
    "stream": true
  }'

---

Image Generations

Floodgate supports high-performance image generation using gpt-image-2 ($0.30/call) and `gpt-image-2.5` ($0.40/call).

cURL

curl "https://api.floodgate.dev/v1/images/generations" \
  -H "Authorization: Bearer $FLOODGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5",
    "prompt": "A modern minimalist logo of a geometric fox, clean lines, vector art",
    "size": "1024x1024",
    "n": 1
  }'

For detailed image parameter references, resolution options, and image edit/inpainting examples, read the Image Generation Guide.

---

Streaming Responses

Floodgate supports Server-Sent Events (SSE) streaming for all completion models. Simply pass "stream": true in your request body:

Python Streaming

stream = client.chat.completions.create(
    model="gpt-6-luna",
    messages=[{"role": "user", "content": "Count from 1 to 10."}],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content is not None:
        print(chunk.choices[0].delta.content, end="", flush=True)
print()

Always include the /v1 prefix in your base URL (https://api.floodgate.dev/v1) when configuring OpenAI SDKs or compatible tooling.