Przejdź do treści

Mage API · Model obrazu

GPT Image 2 API

Precyzyjne prompty i czytelny tekst

POST https://api.mage.space/v1/gpt_image_2/generate

W skrócie

API GPT Image 2 uruchamia GPT Image 2 i 4 inne warianty przez Mage pod adresem POST https://api.mage.space/v1/gpt_image_2/generate. Zapytanie z ustawieniami domyślnymi kosztuje 9 Gemów (ok. 0,009 USD), bez subskrypcji. GPT Image 2 obsługuje zapisane postacie i referencje przez @handle w prompcie.

  • ObrazWynik
  • 5Warianty
  • 9Gems za obraz, domyślnie
  • $0.009Około, w USD

Przegląd

Co robi GPT Image 2 API

Modele GPT Image od OpenAI, które trzymają się promptu co do joty i generują czytelny tekst. Generuj lub edytuj na podstawie wielu obrazów referencyjnych albo twórz animowane GIF-y w GPT Image 2.6. Obowiązuje filtr bezpieczeństwa OpenAI.

Modele GPT Image od OpenAI do generowania i edycji: GPT Image 2, GPT Image 2.5 Flare i Sunburst oraz GPT Image 2.6 Flare i Sunburst, które tworzą też animowane GIF-y. Obowiązuje filtr bezpieczeństwa OpenAI.

Przyjmuje dane wejściowe: image, additional_images.

Szybki start

Wywołaj API GPT Image 2

Ustaw MAGE_API_KEY, wyślij żądanie na /gpt_image_2/generate i odpytuj status_url, aż żądanie zostanie zrealizowane.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/gpt_image_2/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "gpt-image-2"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('gpt_image_2', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'gpt-image-2',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("gpt_image_2", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "gpt-image-2",
})

print(request["result"]["url"])

Modele

Wartości model_id dla GPT Image 2

Wyślij model_id, aby wybrać wariant. Zapytanie bez niego użyje wariantu domyślnego.

model_idNazwaDomyślny
gpt-image-2GPT Image 2Tak
gpt-image-2.5-flareGPT Image 2.5 Flare
gpt-image-2.5-sunburstGPT Image 2.5 Sunburst
gpt-image-2.6-flareGPT Image 2.6 Flare
gpt-image-2.6-sunburstGPT Image 2.6 Sunburst

Opcje

Parametry GPT Image 2

Dozwolone wartości dla wszystkich wariantów; dany wariant może oferować mniej. Opcje dla poszczególnych wariantów znajdziesz w dokumentacji.

PoleWartości
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K
output_formatjpeg, gif

Dane wejściowe

Dane wejściowe, które akceptuje GPT Image 2

Każdy wyślij jako URL https, data URL lub plik o rozmiarze do 100 MB.

PoleRola
imageObraz referencyjny.
additional_imagesDodatkowe obrazy referencyjne.

Zasady

Co wymusza API GPT Image 2

  • Każdy model oferuje tylko wybrane poziomy `quality`; poziom, którego wybrany model nie obsługuje, zostanie odrzucony.
  • Ustaw `output_format` na `gif` w modelu GPT Image 2.6, aby uzyskać animowany GIF, z `frame_count` od 2 do 16 (domyślnie 9) i `frame_duration_ms` od 20 do 2000 (domyślnie 200). Inne modele odrzucą to ustawienie. `resolution` nie ma zastosowania: każde `aspect_ratio` ma jeden rozmiar klatki, około 640 pikseli. Wynikiem jest plik `.gif`, a jego `type` pozostaje `image`.
  • Cena GIF-a zależy od `quality` i od przedziału liczby klatek (2–8, 9, 10–12 lub 13–16), a nie od każdej klatki osobno. Poniższa tabela cen dotyczy obrazów statycznych: cenę GIF-a sprawdzisz w oszacowaniu kosztu.
  • GIF z Mage, np. wcześniejszy wynik, przekazany jako obraz wejściowy jest przetwarzany na podstawie pierwszej klatki. GIF z innego źródła zostanie odrzucony: obrazy wejściowe muszą być w formacie JPEG lub PNG.

Więcej modeli obrazów

Inne API do generowania obrazów w Mage

  • Obraz · od 90 Gems

    Grok Image API

    Grok Imagine w dwóch wersjach

  • Obraz · od 37 Gems

    Guava API

    Fotorealizm, który uchodzi za prawdziwe zdjęcie

  • Obraz · od 20 Gems

    HiDream API

    Szybki i wszechstronny, z negatywnymi promptami

  • Obraz · od 20 Gems

    Krea 2 API

    Zachwycająca estetyka w kilka sekund

  • Obraz · od 42 Gems

    Mango API

    Nasza flagowa rodzina modeli obrazu

  • Obraz · od 15 Gems

    MiniMax H3 Image API

    Natywne obrazy 16 megapikseli, otwarte wagi

FAQ

Najczęściej zadawane pytania

Ile kosztuje API GPT Image 2?
Żądanie GPT Image 2 z ustawieniami domyślnymi (GPT Image 2) kosztuje 9 Gems, czyli około 0,009 USD. Inne rozdzielczości, czasy trwania i warianty zmieniają cenę; dokładną kwotę podaje odpowiedź. Za nieudane generowanie zwracamy koszt, a za generowanie zablokowane przez zasady dotyczące treści Mage – nie.
Jaki jest endpoint API GPT Image 2?
POST https://api.mage.space/v1/gpt_image_2/generate z nagłówkiem Authorization: Bearer zawierającym Twój klucz API Mage. Odpowiedź zawiera status_url, który odpytujesz, aby pobrać wynik.
Które modele GPT Image 2 mogę wywoływać?
gpt-image-2 (GPT Image 2), gpt-image-2.5-flare (GPT Image 2.5 Flare), gpt-image-2.5-sunburst (GPT Image 2.5 Sunburst), gpt-image-2.6-flare (GPT Image 2.6 Flare), gpt-image-2.6-sunburst (GPT Image 2.6 Sunburst). Domyślny jest GPT Image 2.
Czy GPT Image 2 obsługuje obrazy referencyjne lub postacie?
GPT Image 2 akceptuje image, additional_images. GPT Image 2 obsługuje zapisane postacie i referencje przez @handle w prompcie.
Czy mogę używać GPT Image 2 w Claude lub ChatGPT?
Tak. Połącz serwer Mage MCP z Claude, ChatGPT, Claude Code, Grok lub Cursor i poproś o GPT Image 2 po nazwie. Twój asystent odczyta jego opcje przez get_model i poda cenę, zanim zacznie generować.
Jak długo przechowywane są wyniki GPT Image 2?
Wyniki i dane wejściowe są przechowywane przez 30 dni. Wszystko, co chcesz zachować, pobierz na własny dysk.

Zacznij tworzyć z Mage

Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.

CharactersSpołeczność