Image model
FLUX 3 Image
black-forest-labs/flux-3-image
black-forest-labs/flux-3-image is an image generation model from Black Forest Labs you can call on the OceanToken API; it supports image input.
Price card, similar models and questions answered: FLUX 3 Image on oceantoken.ai.
At a glance
| Model ID | black-forest-labs/flux-3-image |
|---|---|
| Type | Image |
| Publisher | Black Forest Labs |
| Price | On oceantoken.ai |
| Endpoint | /v1/images/generations, /v1/images/edits |
| API shape | OpenAI-compatible |
| In the catalog since | 2026-10-01 |
API
POST /v1/images/generations (also /v1/images/edits). Base URL https://api.oceantoken.ai, your OceanToken key as the bearer token. The OpenAI SDKs work unchanged; see the Quickstart.
Download this spec (JSON) · llms.txt for AI assistants
Basic
- curl
- Python
- JavaScript
curl https://api.oceantoken.ai/v1/images/generations \
-H "Authorization: Bearer $OCEANTOKEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "black-forest-labs/flux-3-image",
"prompt": "A lighthouse at dawn, watercolor",
"size": "21:9"
}'
import os
from openai import OpenAI
client = OpenAI(base_url="https://api.oceantoken.ai/v1", api_key=os.environ["OCEANTOKEN_API_KEY"])
result = client.images.generate(
model="black-forest-labs/flux-3-image",
prompt="A lighthouse at dawn, watercolor",
size="21:9",
)
print(result.data[0].url) # download within 24 hours
import OpenAI from 'openai';
const client = new OpenAI({baseURL: 'https://api.oceantoken.ai/v1', apiKey: process.env.OCEANTOKEN_API_KEY});
const result = await client.images.generate({
"model": "black-forest-labs/flux-3-image",
"prompt": "A lighthouse at dawn, watercolor",
"size": "21:9"
});
console.log(result.data[0].url); // download within 24 hours
Request parameters
Only what this model takes. Anything else in the request is left out before it reaches the model.
| Parameter | Type | Description |
|---|---|---|
modelrequired | string | This model's ID. |
promptrequired | string | What to draw. |
size | string 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21 | Aspect ratio. Width x height such as 1024x1024 is accepted too and mapped to its ratio. |
quality | string 1K, 2K, 4K | Resolution tier; low, medium and high are accepted as 1K, 2K and 4K. |
images | array up to 10 items | Up to 10 reference images to start from or draw on, each a public https:// URL or a data URL. The request is then an edit. |
Response
| Field | Type | Description |
|---|---|---|
created | integer | Unix time. |
data[].url | string | The image. Download it within 24 hours. |
Example response
{
"created": 1792000000,
"data": [
{
"url": "https://..."
}
]
}
More examples and how errors and billing work: Images.
Compared with similar models
Image models on OceanToken in the same price range as black-forest-labs/flux-3-image. Compare their prices on oceantoken.ai.
| Model | Publisher | Context |
|---|---|---|
FLUX 3 Imageblack-forest-labs/flux-3-image | Black Forest Labs | — |
Riverflow V2 Prosourceful/riverflow-v2-pro | Sourceful | — |
Recraft V4 Pro Vectorrecraft/recraft-v4-pro-vector | Recraft | — |
Recraft V4.1 Pro Vectorrecraft/recraft-v4.1-pro-vector | Recraft | — |
More from Black Forest Labs
- FLUX 3 Video
black-forest-labs/flux-3-video - FLUX Video Edit
black-forest-labs/flux-video-edit - FLUX Video Upscale
black-forest-labs/flux-video-upscale - Flux.2 Flex
black-forest-labs/flux.2-flex - Flux.2 Klein 4B
black-forest-labs/flux.2-klein-4b - Flux.2 Max
black-forest-labs/flux.2-max - Flux.2 Pro
black-forest-labs/flux.2-pro
All Black Forest Labs models on OceanToken
Use it
Create an account Price on oceantoken.ai
The facts on this page were read from the live OceanToken catalog on 2026-11-05 (UTC), when the documentation was built. Prices are published on oceantoken.ai.