APIリファレンス
Midjourney 画像からプロンプト
画像からプロンプトへのエンドポイントを使用して、同じレスポンスで結果を受け取ります。
01
概要
画像からプロンプトへのエンドポイントを使用し、同じレスポンスから結果を読み取ります。
クイックスタート
- APIキーを作成し、RUNAPI_API_KEYとして設定します。
- 本文がリクエストスキーマと一致するPOSTリクエストを送信します。
- 成功レスポンスのボディから結果を読み取る。
エンドポイント
- ベースURL
https://runapi.ai- API バージョン
v1- 認証
Authorization: Bearer YOUR_API_TOKEN
02
サポートされているモデル
現在の料金、レート制限、商用利用の詳細については、モデルページを開いてください。
03
JSONボディリクエストスキーマ
このエンドポイントで宣言されたフィールドのみを送信してください。
リクエストボディフィールド1件
source_image_urlstring
必須
04
HTTP 200成功レスポンス
POST /api/v1/midjourney/image_to_prompt
レスポンススキーマ
JSON
{
"properties": {
"billing": {
"properties": {
"refund": {
"oneOf": [
{
"properties": {
"refunded_at": {
"type": "string"
}
},
"required": [
"refunded_at"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"reservation": {
"oneOf": [
{
"properties": {
"amount_cents": {
"type": "integer"
}
},
"required": [
"amount_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"settlement": {
"oneOf": [
{
"properties": {
"amount_micro_cents": {
"type": "integer"
},
"charged_amount_cents": {
"type": "integer"
}
},
"required": [
"charged_amount_cents",
"amount_micro_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
}
},
"required": [
"reservation",
"settlement",
"refund"
],
"type": "object",
"unevaluatedProperties": false
},
"prompts": {
"items": {
"type": "string"
},
"maxItems": 4,
"minItems": 4,
"type": "array"
}
},
"required": [
"prompts",
"billing"
],
"type": "object",
"unevaluatedProperties": false
}
レスポンス例
JSON
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"prompts": [
"A quiet coastal town at sunrise in a painterly style.",
"A cinematic sunrise above a calm seaside village.",
"Warm morning light over a peaceful coastal settlement.",
"An atmospheric seaside town beneath a golden sky."
]
}
05
HTTP 401エラー
POST /api/v1/midjourney/image_to_prompt
レスポンススキーマ
JSON
{
"properties": {
"error": {
"description": "人が読めるエラーメッセージ。",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
レスポンス例
JSON
{
"error": "Authentication required"
}
06
HTTP 400エラー
POST /api/v1/midjourney/image_to_prompt
レスポンススキーマ
JSON
{
"oneOf": [
{
"properties": {
"error": {
"description": "人が読めるエラーメッセージ。",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
},
{
"properties": {
"error": {
"description": "人間が読める形式のバリデーションサマリー。",
"type": "string"
},
"errors": {
"additionalProperties": {
"items": {
"type": "string"
},
"type": "array"
},
"description": "公開リクエストフィールドをキーとするバリデーションメッセージ。各フィールドに対して人間が読める文字列の配列が含まれます。",
"type": "object"
}
},
"required": [
"error",
"errors"
],
"type": "object",
"unevaluatedProperties": false
}
]
}
レスポンス例
JSON
{
"error": "source_image_url is required"
}
07
HTTP 402エラー
POST /api/v1/midjourney/image_to_prompt
レスポンススキーマ
JSON
{
"properties": {
"error": {
"description": "人が読めるエラーメッセージ。",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
レスポンス例
JSON
{
"error": "Insufficient balance"
}
08
HTTP 429エラー
POST /api/v1/midjourney/image_to_prompt
レスポンススキーマ
JSON
{
"properties": {
"error": {
"description": "人が読めるエラーメッセージ。",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
レスポンス例
JSON
{
"error": "API key credit limit exceeded"
}
09
HTTP 409エラー
POST /api/v1/midjourney/image_to_prompt
レスポンススキーマ
JSON
{
"properties": {
"error": {
"description": "人が読めるエラーメッセージ。",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
レスポンス例
JSON
{
"error": "The request uses features that are not supported for the selected model"
}
10
HTTP 429エラー
POST /api/v1/midjourney/image_to_prompt
レスポンススキーマ
JSON
{
"properties": {
"error": {
"description": "人が読めるエラーメッセージ。",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
レスポンス例
JSON
{
"error": "Rate limit reached. Please retry later."
}
11
HTTP 503エラー
POST /api/v1/midjourney/image_to_prompt
レスポンススキーマ
JSON
{
"properties": {
"error": {
"description": "人が読めるエラーメッセージ。",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
レスポンス例
JSON
{
"error": "Pricing is pending for this endpoint"
}
12
HTTP 504エラー
POST /api/v1/midjourney/image_to_prompt
レスポンススキーマ
JSON
{
"properties": {
"error": {
"description": "人が読めるエラーメッセージ。",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
レスポンス例
JSON
{
"error": "The request timed out"
}
13
HTTP 502エラー
POST /api/v1/midjourney/image_to_prompt
レスポンススキーマ
JSON
{
"properties": {
"error": {
"description": "人が読めるエラーメッセージ。",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
レスポンス例
JSON
{
"error": "Bad Gateway"
}
14
生成されたコードサンプル
cURLを直接使用するか、お使いの言語向けのSDKをインストールしてください。各サンプルは、このリファレンスに示されたバリデーション済みリクエストを送信します。
インストール
Shell
pip install runapi-midjourney
PYTHON
import os
from runapi.midjourney import MidjourneyClient
client = MidjourneyClient(api_key=os.environ["RUNAPI_API_KEY"])
result = client.image_to_prompt.run(
source_image_url="https://cdn.runapi.ai/public/samples/image.jpg"
)