runapi-ai / midjourney

v0.3.1 2026-09-04 10:17 UTC

Requires

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

Requires (Dev)

• phpunit/phpunit: ^11.5

Apache-2.0

• RunAPI

• php
• api
• composer
• sdk
• packagist
• midjourney
• runapi
• runapi-ai
• midjourney-api

Published on Packagist.org on 2026-09-04 10:18 UTC

README

The Midjourney PHP SDK is the language-specific package for Midjourney on RunAPI. Use this package when your application needs Composer installs, associative-array request bodies, first-video extension, task status lookup, and consistent RunAPI errors in PHP.

This README is the PHP package guide for the public midjourney-php split repository. For model details, use https://runapi.ai/models/midjourney; for API reference, use https://runapi.ai/docs/api/midjourney/text-to-image; for SDK docs, use https://runapi.ai/docs/resources/sdks.

Install

composer require runapi-ai/midjourney

Quick start

<?php

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

use RunApi\Midjourney\MidjourneyClient;

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

$task = $client->textToImage->create([
    'model' => 'midjourney-v8.1',
    'enable_prompt_translation' => true,
    'include_split_images' => true,
    'prompt' => 'A precise product render on white marble',
]);

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

$result = $client->textToImage->run([
    'model' => 'midjourney-v8.1',
    'enable_prompt_translation' => true,
    'include_split_images' => true,
    '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.

imageToPrompt, shortenPrompt, and getSeed return their terminal response directly when available and otherwise follow an accepted Task automatically. To observe an accepted shortenPrompt Task, iterate over subscribe() until its terminal update.

RunAPI-generated file URLs are temporary. Download and store generated files in your own durable storage within the retention window; do not treat returned URLs as long-term assets.

Language notes

Pass request parameters as associative arrays with snake_case keys. The available resources are textToImage, imageToVideo, extendVideo, editImage, imageToPrompt, shortenPrompt, and getSeed. extendVideo accepts the task ID of an account-owned completed direct image-to-video task and continues its first video; extension tasks cannot be chained. Keep RUNAPI_API_KEY in the environment or your secret manager; never commit API keys or callback secrets.

Links

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

License

Licensed under the Apache License, Version 2.0.