POST
/api/v1/imagine1 creditAsynchronousFlux Schnell
Provider · Black Forest LabsType · T2IModel ID ·
flux-schnellUpstream ID · flux-schnell (BFL direct)Flux.1 Schnell by Black Forest Labs. The fastest Flux.1 model at 1 credit. Designed for speed over quality — useful for quick previews or high-volume pipelines where latency matters. Asynchronous despite being fast.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| prompt | string | Required | The text prompt describing the image to generate. |
| model | string | Optional | Set to `flux-schnell` to use this model.Default: flux-schnell |
| aspect_ratio | string | Optional | Output aspect ratio. Allowed: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3.Default: 1:1 |
| negative_prompt | string | Optional | What to avoid in the generation. Max 4000 characters. |
| webhook_url | string | Optional | URL where we POST the completed task result. |
| webhook_secret | string | Optional | Sent as x-webhook-secret header in webhook delivery for verification. |
Example Request
cURL
curl -X POST https://api.journeyapi.com/api/v1/imagine \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-schnell",
"prompt": "quick sketch of a tabby cat",
"aspect_ratio": "1:1"
}'Immediate Response
Returns immediately with a task ID. Poll /fetch or set a webhook_url to receive the result.
200 OK
{
"task_id": "550e8400-e29b-41d4-a716-446655440000"
}Tips
- 1Same 1 credit as Flux.2 Dev but uses BFL direct polling (async). Use Flux.2 Dev instead if you prefer synchronous responses.
Quirks & Gotchas
Asynchronous: requires polling /fetch or a webhook, even though generation is fast.