Przegląd API obrazów

APIMaster udostępnia API obrazów pod https://apimaster.ai/v1. Obraz-do-obrazu nie używa jednego uniwersalnego formatu wejściowego we wszystkich modelach. Najpierw wybierz model, a następnie użyj jego udokumentowanego punktu końcowego i pól referencyjnych.

Przewodnik po modelach i punktach końcowych

Model	Tekst-do-obrazu	Obraz-do-obrazu	Przewodnik
gpt-image-2	JSON /images/generations	Multipart /images/edits, pliki image / image[]	GPT Image 2 / 2.5
gpt-image-2.5-sunburst	JSON /images/generations	Multipart /images/edits, pliki image / image[]	GPT Image 2 / 2.5
gpt-image-2.5-flare	JSON /images/generations	Multipart /images/edits, pliki image / image[]	GPT Image 2 / 2.5
gemini-3.1-flash-image-preview	JSON /images/generations	JSON /images/generations z image_urls	Gemini Flash Image
gemini-nano-banana-2.1	JSON /images/generations	multipart /images/edits / JSON image_urls	Nano Banana 2.1
grok-imagine-image-2.0	JSON /images/generations	JSON /images/generations z image_urls (do 5)	Grok Imagine Image 2.0
doubao-seedream-5-0-pro-260628	JSON /images/generations	JSON /images/generations z image	Seedream 5.0 Pro
midjourney-v8.2	Asynchroniczny /midjourney/generations	Odwołania JSON image_urls	Midjourney v8.2 / Niji 7
midjourney-niji-7	Asynchroniczny /midjourney/generations	Odwołania JSON image_urls	Midjourney v8.2 / Niji 7

W przypadku Grok Imagine Image 2.0 użyj synchronicznego /images/generations z image_urls. Ścieżki asynchroniczne klienta i /images/edits nie są obsługiwane; zobacz przewodnik po Grok Imagine Image 2.0.

W przypadku obrazów referencyjnych GPT prześlij rzeczywiste pliki do /images/edits, aby uzyskać odpowiedź z obrazem, lub do /images/edits/async, aby uzyskać odpowiedź z zadaniem; nie kopiuj formatu JSON Gemini ani Seedream. Wspominanie o odwołaniach w prompcie nie jest przesłaniem pliku. GPT Image 2.5 to odrębna rodzina modeli, a nie alias GPT Image 2.

Midjourney v8.2 i Niji 7 tworzą zadania asynchroniczne przez /midjourney/generations; odpytuj GET /tasks/{task_id}. Zobacz przewodnik po Midjourney v8.2 / Niji 7, aby poznać parametry i przykłady.

Uwierzytelnianie i odpowiedzi

• Utwórz klucz w konsoli; wysyłaj Authorization: Bearer YOUR_API_KEY.
• Wywołania generowania JSON używają Content-Type: application/json. W przypadku edycji multipart pozwól klientowi HTTP wygenerować Content-Type i boundary.
• Synchroniczne odpowiedzi obrazów zawierają data[] z url lub b64_json; obsłuż oba formaty. Pobieraj tymczasowe adresy URL niezwłocznie.
• Pola opcjonalne, limity odwołań, rozmiary i ceny zależą od modelu i dostępnej trasy. Sprawdź przewodnik po modelu i marketplace.

Praca asynchroniczna

POST /images/generations/async, POST /images/edits/async i GET /tasks/{task_id}?model=MODEL_ID zapewniają oparte na zadaniach przepływy pracy z obrazami dla obsługiwanych modeli. To nie jest uniwersalny tryb dla każdej operacji na obrazie:

• W przypadku GPT Image 2, Sunburst i Flare użyj JSON generations/async do tekstu-do-obrazu oraz multipart edits/async do edycji. Prześlij te same pliki co w edycjach synchronicznych, a następnie odpytuj za pomocą konta, które złożyło zadanie, i tego samego identyfikatora modelu.
• Generowanie lub edycja może zakończyć się, zanim asynchroniczne zgłoszenie zwróci identyfikator zadania; nie zakładaj, że zgłoszenie jest natychmiastowe. Nie przesyłaj ponownie istniejącego zadania, gdy jest odpytywane. Zakończenie może mieć wartość succeeded, success lub completed; śledzone wyniki używają ciągu url, natomiast starsze wyniki mogą zawierać tablicę adresów URL.
• Gemini ma własny asynchroniczny przepływ generowania; postępuj zgodnie z jego przewodnikiem w zakresie danych wejściowych referencyjnych.
• Seedream 5.0 Pro używa synchronicznych generowań i nie obsługuje /images/generations/async.

Zobacz przewodniki po modelach, aby uzyskać kompletne przykłady cURL/Python, stany odpytywania i rozwiązywanie problemów. Sama odpowiedź HTTP 200 nie weryfikuje wierności obrazu referencyjnego.