mj_turbo_inpaint

Specyfikacja techniczna mj-turbo-inpaint

Czym jest mj-turbo-inpaint?

mj-turbo-inpaint to identyfikator platformy CometAPI dla modelu/przepływu pracy inpaintingu w stylu Midjourney, ukierunkowanego na szybkie edycje obrazu. Publiczna dokumentacja Midjourney opisuje inpainting jako część doświadczenia Edytora, gdzie użytkownicy wymazują lub zaznaczają region i regenerują jedynie ten obszar na podstawie nowego promptu, zachowując resztę obrazu. Midjourney dokumentuje także Tryb Turbo, zaprojektowany do generowania obrazów znacząco szybciej niż normalny tryb fast, choć przy wyższym koszcie GPU.

Ponieważ Midjourney nie udostępnia szeroko dostępnego oficjalnego publicznego API, integracje stron trzecich często eksponują operacje powiązane z Midjourney poprzez pośrednie API. Publiczna dokumentacja zewnętrznych API Midjourney explicite wymienia wsparcie dla inpaintingu oraz osobne trasowanie turbo, co jest spójne ze schematem nazewnictwa CometAPI mj-turbo-inpaint. Na podstawie tych źródeł identyfikator ten należy rozumieć jako kompatybilny z Midjourney punkt końcowy inpaintingu w trybie turbo do zlokalizowanej edycji obrazu, a nie czysty generator tekst–obraz.

W praktyce deweloperzy używaliby mj-turbo-inpaint, gdy chcą zachować większość istniejącego obrazu nietkniętą, ale selektywnie zmienić jeden region — na przykład zastąpić obiekt, zmienić element garderoby, zmodyfikować akcesorium na twarzy, dopracować fragment tła lub naprawić niechciane elementy obrazu. Ta interpretacja wynika z zachowania edytora/inpaintingu Midjourney oraz opisów wsparcia turbo inpaint w dokumentacjach zewnętrznych API.

Główne funkcje mj-turbo-inpaint

• Lokalna edycja obrazu: Zaprojektowany do przepływów pracy inpaintingu, w których regenerowany jest jedynie wybrany fragment obrazu, co pomaga zachować oryginalne kadrowanie, styl i nienaruszone obszary.
• Modyfikacje prowadzone promptem: Wykorzystuje instrukcje w języku naturalnym do opisu tego, co ma się pojawić w edytowanym regionie, dzięki czemu nadaje się do kontrolowanych, kreatywnych zmian.
• Wykonanie w trybie Turbo: Tryb Turbo Midjourney jest udokumentowany jako korzystający z szybszej puli GPU w celu generowania wyników szybciej niż standardowy tryb fast, więc ten model jest pozycjonowany do przepływów edycji o niższych opóźnieniach.
• Wsparcie kreatywnej iteracji: Szybkie przepływy inpaintingu są użyteczne przy szybkim testowaniu wielu wariantów w obrębie regionu podczas tworzenia koncepcji, dopracowywania assetów lub przeglądów projektowych. Jest to praktyczny wniosek wynikający z połączenia inpaintingu i trybu turbo.
• Przydatny do napraw i podmian: Doskonale nadaje się do usuwania rozpraszaczy, podmiany obiektów, aktualizacji teł i wprowadzania korekt kompozycyjnych bez regenerowania całego obrazu.
• Przyjazny integratorom: CometAPI zapewnia ujednolicony interfejs zgodny z OpenAI dla wielu modeli, więc mj-turbo-inpaint można konsumować w spójnym wzorcu integracji API obok innych modeli obrazowych i językowych.

Jak uzyskać dostęp i zintegrować mj-turbo-inpaint

Krok 1: Zarejestruj się po klucz API

Załóż konto w CometAPI i wygeneruj klucz API w panelu. CometAPI używa ujednoliconych poświadczeń dla katalogu modeli, a w publicznej dokumentacji opisuje usługę jako zgodną z OpenAI, więc ten sam wzorzec klucza jest używany w obsługiwanych modelach, w tym mj-turbo-inpaint. Przechowuj klucz bezpiecznie i unikaj ujawniania go w kodzie po stronie klienta.

Krok 2: Wysyłaj żądania do API mj-turbo-inpaint

Skieruj klienta na bazowy URL CometAPI zgodny z OpenAI i wysyłaj żądania z mj-turbo-inpaint jako identyfikatorem modelu. CometAPI publicznie dokumentuje https://api.cometapi.com/v1 jako bazowy URL dla kompatybilnych klientów. Dla przepływów obrazowych artykuły CometAPI odwołują się do endpointów w stylu OpenAI, takich jak /v1/images/generations i /v1/images/edits; dla modelu inpaintingu takiego jak mj-turbo-inpaint właściwy jest wzorzec typu edits.

import os
import requests

url = "https://api.cometapi.com/v1/images/edits"
headers = {
    "Authorization": f"Bearer {os.environ['COMETAPI_KEY']}",
}

files = {
    "image": open("input.png", "rb"),
    # Dołącz plik maski zgodnie z wymaganiami Twojego przepływu pracy, jeśli jest obsługiwany
    # "mask": open("mask.png", "rb"),
}

data = {
    "model": "mj-turbo-inpaint",
    "prompt": "Zastąp zaznaczony obszar wypolerowanym srebrnym hełmem, filmowe oświetlenie, realistyczne detale"
}

response = requests.post(url, headers=headers, files=files, data=data, timeout=300)
print(response.json())

Krok 3: Pobierz i zweryfikuj wyniki

Przetwórz odpowiedź JSON, pobierz zwrócony URL obrazu lub zakodowane wyjście i sprawdź, czy edytowany region odpowiada Twojemu promptowi, a nienaruszone obszary pozostają zgodne z obrazem źródłowym. W środowisku produkcyjnym zweryfikuj typ pliku, rozdzielczość, opóźnienia i wszelkie metadane asynchronicznych zadań, które otrzymuje Twój klient. Jeśli Twój przepływ pracy zależy od precyzyjnych masek lub kontroli regionów, przetestuj kilka masek i promptów, aby potwierdzić, jak mj-turbo-inpaint zachowuje się w Twoim pipeline. Ujednolicone podejście CometAPI do API ułatwia automatyzację tego kroku w tej samej warstwie integracji, której używasz dla innych obsługiwanych modeli.