README

MiniMax adapter for adachsoft/ai-image-contract.

Installation

composer require adachsoft/ai-image-minimax

Usage

use AdachSoft\AiImageContract\Collections\ImageInputCollection;
use AdachSoft\AiImageContract\Models\GenerationRequest;
use AdachSoft\AiImageContract\ValueObjects\ImageSize;
use AdachSoft\AiImageContract\ValueObjects\Prompt;
use AdachSoft\AiImageMiniMax\Factory\MiniMaxImageGeneratorFactory;

$generator = MiniMaxImageGeneratorFactory::create('your-api-key');

$response = $generator->generate(new GenerationRequest(
    prompt: new Prompt('A futuristic city at sunset, cyberpunk style'),
    imageInputs: new ImageInputCollection([]),
    size: new ImageSize(1024, 1024),
    options: [
        'model' => 'image-01',
        'response_format' => 'url',
        'n' => 1,
        'prompt_optimizer' => true,
    ],
));

foreach ($response->images as $image) {
    if ($image->url !== null) {
        echo $image->url . PHP_EOL;
    }
}

Notes

This adapter supports text-to-image requests using the MiniMax image generation endpoint.

Current adapter behavior:

• imageInputs are rejected as unsupported by this provider adapter.
• The request size is converted into the MiniMax aspect_ratio payload field.
• The adapter currently expects MiniMax to return image URLs.

Contract Compatibility

This package is compatible with adachsoft/ai-image-contract ^0.2.

The updated contract introduces provider-level exception semantics such as retryable failures and content moderation rejections. This adapter maps MiniMax transport and HTTP failures to the contract exceptions exposed by the library.

Exceptions

The adapter may throw exceptions from adachsoft/ai-image-contract, including:

• InvalidInputException when unsupported request features are used.
• RetryableException for temporary transport failures, rate limits, and 5xx responses.
• ContentModerationException for moderation or safety-filter style rejections.
• GenerationFailedException for non-retryable provider failures or invalid generation responses.