POST
/api/v1/imagine1 creditSynchronousFlux.2 Dev
Provider · Black Forest LabsType · T2IModel ID ·
flux-2-devUpstream ID · flux-2-devFlux.2 Dev by Black Forest Labs (via BLTCY). The cheapest model on the platform at 1 credit. Synchronous generation with fast inference. Ideal for drafts, testing, or high-volume bulk generation where cost matters more than quality.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| prompt | string | Required | The text prompt describing the image to generate. |
| model | string | Optional | Set to `flux-2-dev` to use this model.Default: flux-2-dev |
| 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-2-dev",
"prompt": "a red sports car on a mountain road",
"aspect_ratio": "16:9"
}'Response
This model is synchronous — the response includes the finished image_url directly. No polling required.
200 OK
{
"task_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "finished",
"image_url": "https://cdn.example.com/output.png"
}Tips
- 1At 1 credit, this is the best choice for rapid iteration and volume testing.