Przejdź do głównej treści

1. Uzyskiwanie klucza API

Otwórz listę aplikacji Ace Data Cloud, przejdź do dostępnej aplikacji i skopiuj klucz API. Uzyskiwanie klucza API Ace Data Cloud

2. Edycja przy użyciu adresu URL obrazu

Oryginalny obraz: Oryginalny obraz do edycji GPT Image 2
Pomyślna odpowiedź:
To jest wynik edycji faktycznie wykonanej za pośrednictwem Ace Data Cloud 8 września 2026 roku: kubek zmienił kolor na pomarańczowy, tło na ciemny granat, przy zachowaniu oryginalnej kompozycji i rozmiaru 1024×1536: Wynik edycji pomarańczowego kubka GPT Image 2

3. Przesyłanie lokalnego obrazu

Użyj multipart/form-data:
Parametr image można przekazać wielokrotnie, a seria GPT Image obsługuje maksymalnie 16 obrazów referencyjnych. image w żądaniu JSON może być pojedynczym adresem URL lub tablicą adresów URL; pliki lokalne są przesyłane przez multipart.

Modele i sposób rozliczania

Cena wyświetlana dla oficjalnego kanału API jest szacowana przed wysłaniem żądania, a ostateczna wartość zależy od faktycznego zużycia Tokenów w odpowiedzi i historii użycia.

4. Edycja lokalna z użyciem maski

Oficjalny interfejs Images Edit określa obszar dozwolony do modyfikacji za pomocą mask. Modele Ace Data Cloud z :official przestrzegają tego samego kontraktu multipart:
  • mask musi być plikiem PNG z kanałem Alpha o rozmiarze nie większym niż 4 MB;
  • rozmiar maski musi być dokładnie taki sam jak pierwszego obrazu image;
  • przezroczyste piksele o wartości Alpha równej 0 oznaczają obszary dozwolone do edycji, a nieprzezroczyste piksele oznaczają obszary, które należy zachować;
  • obrazy RGB, które są jedynie czarno-białe, ale nie mają kanału przezroczystości, nie mogą być używane jako prawidłowe maski;
  • prompt powinien opisywać oczekiwany kompletny obraz, jednocześnie jasno określając lokalne modyfikacje oraz zawartość, która ma pozostać niezmieniona.
Poniżej najpierw zostanie wygenerowana maska z oryginalnego obrazu. Przykład ustawia centralny prostokąt jako przezroczysty, pozwalając modelowi modyfikować wyłącznie ten obszar:
Następnie prześlij razem oryginalny obraz i maskę:
Można również użyć metody wywołania images.edit z oficjalnego Python SDK OpenAI, wystarczy wskazać Ace Data Cloud jako base_url:
Podczas używania mask oryginalny obraz i maska muszą zostać przesłane w tym samym żądaniu multipart, odpowiednio przez image=@input.png oraz mask=@mask.png. Nie mieszaj oryginalnego obrazu z adresu URL z lokalnym plikiem maski; żądania edycji wyłącznie z użyciem adresów URL nie obsługują dołączania lokalnego pliku mask. Maska ogranicza obszar edycji, ale model generatywny nadal może naturalnie łączyć krawędzie; gdy wymagane są ścisłe granice, należy użyć wyraźnych krawędzi Alpha i powtórzyć w prompcie, które elementy muszą pozostać niezmienione. Powyższy sposób wywołania jest zgodny z przykładami masek w OpenAI Image Edit API oraz oficjalnym Cookbooku GPT Image.

5. Typowe parametry

Zasady rozmiaru są zgodne z interfejsem generowania: szerokość i wysokość muszą być wielokrotnościami 16, dłuższy bok nie może przekraczać 3840, łączna liczba pikseli wynosi 655 360–8 294 400, a proporcje szerokości do wysokości nie mogą przekraczać 3:1. Po pominięciu size lub użyciu auto model wybierze format kadru na podstawie promptu i pierwszego obrazu referencyjnego. gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst oraz gpt-image-2:reverse są rozliczane według liczby pomyślnie wygenerowanych obrazów; gpt-image-2:official, gpt-image-2.5-flare:official i gpt-image-2.5-sunburst:official są rozliczane na podstawie rzeczywiście wykorzystanych tokenów wejścia tekstowego, wejścia obrazów referencyjnych i wyjścia obrazów, a ostatecznie obowiązuje zapis użycia.

6. Asynchroniczne wywołania zwrotne i rozwiązywanie problemów

Do długich zadań można dodać w żądaniu:
Asynchroniczna odpowiedź 200 ma postać {"task_id": "..."}; po zakończeniu zostanie wywołany zwrotnie końcowy wynik. Żądania synchroniczne zwracają natomiast created i data. Odpowiedź błędu będzie zawierać trace_id. Przy zgłaszaniu problemów podaj ten ID, nie podawaj API Key. Pełne pola i aktualne wyliczenia znajdują się na stronie OpenAI Images Edits API. W przypadku generowania obrazów z samego tekstu zobacz Generowanie obrazów GPT Image 2 / 2.5.