runapi-ai/flux-2

RunAPI Flux 2 Composer package for PHP applications

v0.2.0 2026-07-28 04:07 UTC

Requires

• php: >=8.2
• runapi-ai/core: ^0.2.5

Requires (Dev)

• phpunit/phpunit: ^11.5

Apache-2.0

• RunAPI

• php
• api
• composer
• sdk
• packagist
• runapi
• runapi-ai
• flux-2
• flux-2-api

Published on Packagist.org on 2026-07-28 04:08 UTC

README

The Flux 2 PHP SDK is the Composer package for Flux 2 on RunAPI. Use it when your PHP application needs associative-array request bodies, task status lookup, polling helpers, file helpers, and consistent RunAPI errors.

Install

composer require runapi-ai/flux-2

Quick start

<?php

require __DIR__ . "/vendor/autoload.php";

use RunApi\Flux2\Flux2Client;

$client = new Flux2Client(); // reads RUNAPI_API_KEY

$task = $client->textToImage->create([
    'model' => 'flux-2-flex-text-to-image',
    'prompt' => 'A precise product render on white marble',
]);

$status = $client->textToImage->get($task->id);

$result = $client->textToImage->run([
    'model' => 'flux-2-flex-text-to-image',
    'prompt' => 'A serene mountain lake at dawn',
]);

echo $result->images[0]->url . PHP_EOL;

Use create() to submit a task and return quickly, get() to fetch the latest task state, and run() when a script should create and poll until completion. In web request handlers, prefer create() plus webhook or later get() polling so a worker is not held open.

Flux 2 Max

Use flux-2-max-text-to-image or flux-2-max-remix-image for the highest-quality tier. Max requires a concrete aspect_ratio, supports output_resolution of 1k and output_count of 1 only, and accepts exactly one public HTTP(S) source image for remix.

Returned file URLs are temporary. Download and store generated files in your own durable storage within the retention window.

All SDK exceptions inherit from RunApi\Core\Errors\RunApiException, including validation, authentication, rate limit, task failure, and task timeout errors.

Links

• Model page: https://runapi.ai/models/flux-2
• SDK docs: https://runapi.ai/docs/resources/sdks
• Product docs: https://runapi.ai/docs/api/flux-2/text-to-image
• Pricing and rate limits: https://runapi.ai/models/flux-2/pro-text-to-image
• Full catalog: https://runapi.ai/models
• GitHub repository: https://github.com/runapi-ai/flux-2-php
• Multi-language SDK repository: https://github.com/runapi-ai/flux-2-sdk

License

Licensed under the Apache License, Version 2.0.