> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Midjourney Describe API の接続と使用

> Midjourney generation 集成指南 - XHuoAPI

Midjourney Describe API の主な機能は、画像をアップロードすることで、その画像の説明を取得することです。この API を使用するには、画像ファイルのアドレスを渡すだけで、API は画像の詳細な説明を返します。煩雑なパラメータ設定は不要で、高品質な画像説明を得ることができます。

さまざまな画像フォーマットに対応：JPEG、PNG、GIF などの主流の画像フォーマットを簡単に認識し処理できます。

この文書では、Midjourney Describe API の接続説明を詳しく紹介し、簡単に統合し、この API の強力な機能を十分に活用できるようにします。Midjourney Describe API を使用することで、画像説明の自動化を簡単に実現し、業務効率を向上させることができます。

## 申請プロセス

Midjourney Describe API を使用するには、まず 申請ページ [Midjourney Describe API ](https://api.xhuoapi.ai/documents/870e973b-712a-4686-ab8b-beae27f129ce) で該当するサービスを申請する必要があります。ページに入ったら、「Acquire」ボタンをクリックします。

![申請ページ](https://cdn.xhuoapi.ai/rci31i.png)

まだログインまたは登録していない場合は、自動的に[ログインページ](https://api.xhuoapi.ai)にリダイレクトされ、登録とログインを促されます。ログインまたは登録後、現在のページに自動的に戻ります。

初回申請時には無料のクレジットが付与され、この API を無料で使用できます。

## リクエスト例

画像を例にとり、この API の使用方法を示します。風景画像があると仮定し、その画像をアップロードして説明を取得する方法を示します。

### リクエスト例画像

![例画像](https://cdn.xhuoapi.ai/kg7xp3.png)

### リクエストヘッダーとリクエストボディの設定

**Request Headers** には以下が含まれます：

* `accept`：JSON形式のレスポンス結果を受け取ることを指定します。ここには `application/json` と記入します。
* `authorization`：APIを呼び出すためのキーで、申請後に直接ドロップダウンから選択できます。

**Request Body** には以下が含まれます：

* `image_url`：アップロードする画像ファイルのアドレス。

設定は以下の図のようになります：

![](https://cdn.xhuoapi.ai/eeui10.png)

### コード例

ページの右側には、さまざまな言語のコードが自動生成されています。

<p>
  <img src="https://cdn.xhuoapi.ai/8edj9z.png" width="400" className="m-auto" />
</p>

一部のコード例は以下の通りです：

#### CURL

```bash theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/midjourney/describe' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image_url": "https://cdn.xhuoapi.ai/kg7xp3.png"
}'
```

#### Python

```python theme={null}
import requests

url = "https://api.xhuoapi.ai/v1/midjourney/describe"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "image_url": "https://cdn.xhuoapi.ai/kg7xp3.png"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())
```

### レスポンス例

リクエストが成功すると、API は画像の 4 つの説明情報を返します。例えば：

```json theme={null}
{
  "descriptions": [
    "公園の真ん中に立つ十字型の道路標識があり、周囲には木々と草原があります。背景は晴れており、暖かい色合いです。葉の間から日光が差し込み、その一部に当たっています。その街路ポストの一方には「昆明公園」と書かれた別の標識もあり、とても美しく見えます。この写真は自然の素晴らしさを示しています。人々にリラックスや静けさの感情を与えます。 --ar 75:44",
    "公園にある「K鬥」道路標識の写真で、両側には木々と草があります。前には2つの標識が取り付けられた薄い黄色の金属ポールがあります。背景には緑の葉を通して日光が差し込み、温かい雰囲気を作り出しています。周囲には水蒸気も漂っています。これはSony A7R IVカメラを使用してLeica Mレンズで撮影されました。このシーンは自然と人間の創造物の調和と静けさを伝えています。 --ar 75:44",
    "開放的な公園の真ん中に立つ十字型の街路標識があり、周囲には木々と草原があります。日が葉の間から差し込み、一部に温かい光の効果を生み出しています。前方には別の緑地に続く道路があります。そのポストの一方には「石林公園内」の情報もあります。このシーンは人々に自然との調和と静けさの感情を与えます。自然光、Unreal Engineスタイルの3Dレンダリング、リアルな写真スタイル。 --ar 75:44",
    "公園に立つ十字型の標識があり、周囲には青々とした木々と太陽の下の鮮やかな緑の草があります。標識には未知の言語で「VIDEO ANNattacks」と書かれており、神秘的で興味を引く雰囲気を作り出しています。このシーンはCanon EOS R5カメラを使用して高解像度で撮影され、現代の写真スタイルで複雑な詳細を示す驚くべき視覚効果を提供します。 --ar 75:44"
  ]
}
```

結果には `descriptions` フィールドがあり、4つの結果が含まれており、それぞれが候補の説明内容です。

## エラーハンドリング

APIを呼び出す際にエラーが発生した場合、APIは対応するエラーコードと情報を返します。例えば：

* `400 token_mismatched`：不正なリクエスト、パラメータが不足または無効である可能性があります。
* `400 api_not_implemented`：不正なリクエスト、パラメータが不足または無効である可能性があります。
* `401 invalid_token`：未認証、無効または不足している認証トークン。
* `429 too_many_requests`：リクエストが多すぎます、レート制限を超えました。
* `500 api_error`：内部サーバーエラー、サーバーで何かがうまくいきませんでした。

### エラー応答例

```
{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}
```

## 結論

この文書を通じて、Midjourney Describe API を使用して画像説明を行う方法を理解しました。この文書が、API の接続と使用をより良くする手助けとなることを願っています。ご不明な点がございましたら、いつでも技術サポートチームにお問い合わせください。