Zum Hauptinhalt springen

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.

Die Hauptfunktion der Midjourney Shorten API besteht darin, den offiziellen Midjourney-Befehl /shorten (Prompt-Analyse) zu integrieren, um einen Prompt zu analysieren, die Schlüsselwörter mit dem höchsten Gewicht zu erkennen und 5 prägnantere Kandidaten-Prompts zu generieren. Diese Schnittstelle eignet sich besonders für:
  • Das Kürzen langer Prompts vor dem Aufruf von imagine, um die Relevanz der Bilderzeugung zu erhöhen;
  • Das rückwärtsgerichtete Verständnis der Gewichtung einzelner Tokens durch Midjourney anhand der Kandidaten-Prompts, was die Prompt-Optimierung erleichtert;
  • Die Integration in automatisierte Pipelines zur Zusammenfassung und Straffung von Schlüsselwörtern in Benutzereingaben.
Dieses Dokument beschreibt detailliert die Integration der Midjourney Shorten API und hilft Ihnen, diese API einfach zu integrieren.

​
Antragsprozess

Um die Midjourney Shorten API zu nutzen, müssen Sie zunächst auf der Antragsseite Midjourney Shorten API den entsprechenden Dienst beantragen. Nach dem Aufruf der Seite klicken Sie auf die Schaltfläche „Acquire“. Falls Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet, wo Sie sich registrieren und anmelden können. Nach der Anmeldung kehren Sie automatisch zur aktuellen Seite zurück. Bei der ersten Beantragung erhalten Sie ein kostenloses Kontingent, mit dem Sie die API kostenfrei nutzen können.

​
Beispielanfrage

Wir demonstrieren anhand eines längeren Prompts, wie Sie die API zur Analyse und Kürzung verwenden.

​
Festlegen von Request-Headern und Request-Body

Request Headers umfassen:
  • accept: Gibt an, dass die Antwort im JSON-Format erwartet wird, hier application/json.
  • authorization: Der API-Schlüssel für den Aufruf, der nach der Beantragung direkt aus einer Dropdown-Liste ausgewählt werden kann.
Request Body umfasst:
  • prompt: Der zu analysierende und zu kürzende Prompt-Text, idealerweise auf Englisch.

​
Codebeispiele

​
CURL

curl -X POST 'https://api.xhuoapi.ai/v1/midjourney/shorten' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "prompt": "a serene mountain lake at sunrise, mist rising from the water, towering pine trees on the shore, golden hour lighting, ultra detailed, cinematic, 35mm film photography style, masterpiece --ar 16:9 --v 6"
}'

​
Python

import requests

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

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

payload = {
    "prompt": (
        "a serene mountain lake at sunrise, mist rising from the water, "
        "towering pine trees on the shore, golden hour lighting, ultra "
        "detailed, cinematic, 35mm film photography style, masterpiece "
        "--ar 16:9 --v 6"
    )
}

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

​
Beispielantwort

Nach erfolgreichem Aufruf gibt die API bis zu 5 gekürzte Kandidaten-Prompts zurück. Zum Beispiel: 
{
  "prompts": [
    "a serene mountain lake at sunrise, mist rising from the water, golden hour lighting --ar 16:9",
    "mountain lake sunrise with mist, golden light --ar 16:9 --v 6",
    "tranquil alpine lake, dawn mist, warm golden tones, cinematic --ar 16:9",
    "sunrise over a misty mountain lake, rich golden hour photography --ar 16:9 --style raw",
    "misty lake at dawn, mountains in background, golden sunrise --ar 16:9"
  ]
}
Man sieht, dass das Ergebnis ein Feld prompts enthält, das mehrere gekürzte Kandidaten-Prompts auflistet. Jeder Prompt behält die intern von Midjourney am höchsten gewichteten Schlüsselwörter bei und entfernt redundante oder überflüssige Beschreibungen.

​
Fehlerbehandlung

Bei einem Fehler gibt die API entsprechende Fehlercodes und Meldungen zurück, zum Beispiel:
  • 400 token_mismatched: Ungültige Anfrage, möglicherweise fehlende oder ungültige Parameter.
  • 400 api_not_implemented: Ungültige Anfrage, möglicherweise fehlende oder ungültige Parameter.
  • 401 invalid_token: Nicht autorisiert, ungültiger oder fehlender Autorisierungstoken.
  • 429 too_many_requests: Zu viele Anfragen, das Limit wurde überschritten.
  • 500 api_error: Interner Serverfehler, ein Problem auf dem Server.

​
Beispiel für eine Fehlerantwort

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

​
Fazit

Mit diesem Dokument haben Sie gelernt, wie Sie die Midjourney Shorten API zur Analyse und Kürzung von Prompts verwenden. Es wird empfohlen, diese Schnittstelle zusammen mit der Midjourney Imagine API zu verwenden: Zuerst mehrere gekürzte Kandidaten über die Shorten API generieren, dann den passendsten Prompt auswählen und an die Imagine API zur Bildgenerierung übergeben. Bei Fragen steht Ihnen unser technischer Support jederzeit gerne zur Verfügung.