README

OpenAI 图像生成 API (beta) 的 PHP 客户端。

客户端允许

根据文本提示生成图像。
下载并保存生成的图像。

入门指南

安装

composer require krisciunaskarolis/openai-images-generator

认证

OpenAI API 使用 API 密钥进行认证。请访问您的 API 密钥页面以获取您在请求中将使用的 API 密钥。

图像生成

基于文本提示生成图像

use Krisciunas\OpenAi\Api\GenerateImageCommand;
use Krisciunas\OpenAi\Api\ImagePrompt;

$authorizationToken = 'YOUR-OPENAI-API-KEY';
$imagesGenerationCommand = new GenerateImageCommand();

$imagesData = $imagesGenerationCommand->execute(
    $authorizationToken,
    new ImagePrompt(
        'small kitty playing with red fish', //A text description of the desired images. The maximum length is 1000 characters.
        4, //Number of images to generate. Must be between 1 and 10
        ImagePrompt::SIZE_256x256, // The size of generated images
        ImagePrompt::FORMAT_URL //The format in which images are returned
    ),
);

保存图像

保存生成的图像

$imagesPersistor = new ImagesPersist('/PATH/TO/IMAGES/DIRECTORY/');
$imagesPersistor->persist($imagesData, 'FILENAME_FORMAT_%s.png');

支持两种图像响应格式（URL 和 base_64 编码的图像数据）。

保存图像时，文件名格式中的占位符将被图像计数器值替换，从 0 开始。

支持的反应格式

\Krisciunas\OpenAi\Api\ImagePrompt::FORMAT_URL;
\Krisciunas\OpenAi\Api\ImagePrompt::FORMAT_BASE_64;

支持图像大小

\Krisciunas\OpenAi\Api\ImagePrompt::SIZE_256x256;
\Krisciunas\OpenAi\Api\ImagePrompt::SIZE_512x512;
\Krisciunas\OpenAi\Api\ImagePrompt::SIZE_1024x1024;

限制

根据 OpenAI 的说法，图像 API 处于 beta 版。在此期间，API 和模型将不断发展。为确保所有用户都能舒适地原型设计，默认的速率限制为每分钟 20 张图像，5 分钟内 50 张。

作者

Karolis Kriščiūnas

krisciunaskarolis / openai-images-generator

维护者

详细信息