flux-2-dev

Text-to-Image • Black Forest Labs • Hosted

FLUX.2 [dev] is an image model from Black Forest Labs where you can generate highly realistic and detailed images, with multi-reference support.

Model Info
Terms and License	link ↗
Partner	Yes
Unit Pricing	$0.00021 per input 512x512 tile, per step, $0.00041 per output 512x512 tile, per step

export interface Env {
  AI: Ai;
}

export default {
  async fetch(request, env): Promise<Response> {
    const form = new FormData();
    form.append('prompt', 'a sunset with a dog');
    form.append('width', '1024');
    form.append('height', '1024');

    // FormData doesn't expose its serialized body or boundary. Passing it to a
    // Request (or Response) constructor serializes it and generates the Content-Type
    // header with the boundary, which is required for the server to parse the multipart fields.
    const formResponse = new Response(form);
    const formStream = formResponse.body;
    const formContentType = formResponse.headers.get('content-type')!;

    const resp = await env.AI.run("@cf/black-forest-labs/flux-2-dev", {
      multipart: {
        body: formStream,
        contentType: formContentType
      }
    });

    return Response.json(resp);
  },
} satisfies ExportedHandler<Env>;

curl --request POST \
  --url 'https://api.cloudflare.com/client/v4/accounts/{ACCOUNT}/ai/run/@cf/black-forest-labs/flux-2-dev' \
  --header 'Authorization: Bearer {TOKEN}' \
  --header 'Content-Type: multipart/form-data' \
  --form 'prompt=a sunset at the alps' \
  --form steps=25 \
  --form width=1024 \
  --form height=1024

Parameters

Input
Output

▶multipart{}

object

image

stringGenerated image as Base64 string.

API Schemas

Input
Output

{
  "type": "object",
  "properties": {
    "multipart": {
      "type": "object",
      "properties": {
        "body": {
          "type": "object"
        },
        "contentType": {
          "type": "string"
        }
      },
      "required": [
        "body",
        "contentType"
      ]
    },
    "required": [
      "multipart"
    ]
  }
}

{
  "type": "object",
  "properties": {
    "image": {
      "type": "string",
      "description": "Generated image as Base64 string."
    }
  }
}