Przejdź do głównej treści

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.

Główną funkcją Midjourney Shorten API jest integracja z oficjalnym poleceniem Midjourney /shorten (analiza promptu), które analizuje podany prompt, identyfikuje słowa kluczowe o najwyższej wadze i generuje 5 bardziej zwięzłych propozycji promptów. Interfejs ten jest szczególnie przydatny do:
  • skracania długich promptów przed wywołaniem imagine, co zwiększa trafność generowanych obrazów;
  • odwrotnego rozumienia wagi poszczególnych tokenów w Midjourney na podstawie propozycji promptów, co ułatwia inżynierię promptów;
  • automatyzacji procesów, grupowania i skracania słów kluczowych w promptach wprowadzanych przez użytkowników.
Niniejsza dokumentacja szczegółowo opisuje sposób integracji Midjourney Shorten API, pomagając w łatwej integracji tego API.

​
Proces aplikacji

Aby korzystać z Midjourney Shorten API, należy najpierw złożyć wniosek na stronie Midjourney Shorten API. Po wejściu na stronę kliknij przycisk „Acquire”. Jeśli nie jesteś zalogowany lub zarejestrowany, nastąpi automatyczne przekierowanie do strony logowania, gdzie możesz się zarejestrować i zalogować. Po zalogowaniu zostaniesz automatycznie przekierowany z powrotem na bieżącą stronę. Przy pierwszym wniosku otrzymujesz darmowy limit, który pozwala na bezpłatne korzystanie z API.

​
Przykład zapytania

Weźmy na przykład długi prompt i pokażmy, jak użyć tego API do jego analizy i skrócenia.

​
Ustawienie nagłówków i ciała zapytania

Nagłówki zapytania obejmują:
  • accept: określa format odpowiedzi, tutaj application/json.
  • authorization: klucz API do wywołania, który można wybrać z listy po złożeniu wniosku.
Ciało zapytania zawiera:
  • prompt: tekst promptu do analizy i skrócenia, zaleca się wprowadzenie w języku angielskim.

​
Przykład kodu

​
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())

​
Przykład odpowiedzi

Po pomyślnym wywołaniu API zwróci maksymalnie 5 zwięzłych propozycji promptów. Na przykład: 
{
  "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"
  ]
}
Widzimy, że odpowiedź zawiera pole prompts z kilkoma zwięzłymi propozycjami promptów, z których każdy zachowuje słowa kluczowe o najwyższej wadze w Midjourney, usuwając powtarzające się lub zbędne opisy.

​
Obsługa błędów

Podczas wywoływania API, w przypadku błędów, API zwraca odpowiedni kod i komunikat błędu, na przykład:
  • 400 token_mismatched: Niepoprawne żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
  • 400 api_not_implemented: Niepoprawne żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
  • 401 invalid_token: Nieautoryzowany dostęp, nieprawidłowy lub brakujący token autoryzacyjny.
  • 429 too_many_requests: Zbyt wiele żądań, przekroczono limit szybkości.
  • 500 api_error: Błąd wewnętrzny serwera, wystąpił problem po stronie serwera.

​
Przykład odpowiedzi błędu

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

​
Podsumowanie

Dzięki tej dokumentacji poznaliście sposób użycia Midjourney Shorten API do analizy i skracania promptów. Zaleca się łączenie tego interfejsu z Midjourney Imagine API: najpierw użyć Shorten API, aby uzyskać kilka zwięzłych propozycji, a następnie wybrać najbardziej odpowiednią do przekazania do Imagine API w celu generowania obrazów. W razie jakichkolwiek pytań prosimy o kontakt z naszym zespołem wsparcia technicznego.