Klucz API GPT Image 2: jak uzyskać dostęp i wysłać żądanie

Tak, GPT Image 2 ma API, a w SeedRouter dostęp do niego daje jeden klucz API. Zaloguj się, utwórz klucz na stronie kluczy API, doładuj kredyty na stronie rozliczeń i wysyłaj klucz w nagłówku Authorization: Bearer na https://api.seedrouter.ai/v1/images/generations. Pełny klucz jest widoczny tylko raz, w chwili utworzenia, więc od razu skopiuj go do środowiska swojego serwera.

Poniższe kroki prowadzą od braku konta do gotowego obrazu i omawiają cztery błędy, na których zatrzymuje się większość pierwszych żądań.

Jak zdobyć klucz API GPT Image 2?

Zaloguj się do SeedRouter kontem Google.
Otwórz stronę kluczy API i utwórz klucz. Nadaj mu nazwę, która mówi, gdzie będzie działał, np. production-server.
Skopiuj klucz od razu. Po opuszczeniu tego ekranu zobaczysz już tylko zamaskowaną wersję, a zgubionego klucza nie da się odzyskać. Zamiast tego unieważnij go i utwórz nowy.
Doładuj kredyty na stronie rozliczeń. Klucz działa od chwili utworzenia, ale żądanie potrzebuje kredytów, żeby się wykonać.

Jeden klucz obsługuje każdy model w SeedRouter, więc nie potrzebujesz osobnego klucza do GPT Image 2 i GPT Image 2.5. Twórz za to osobne klucze dla każdego środowiska. Wtedy unieważnienie klucza stagingowego nie zepsuje produkcji.

Gdzie przechowywać klucz API?

Na swoim serwerze, w zmiennej środowiskowej, i nigdzie indziej:

export SEEDROUTER_API_KEY="your-key"

Nigdy nie umieszczaj klucza w JavaScripcie przeglądarki, w paczce aplikacji mobilnej ani w publicznym repozytorium. Każdy, kto go odczyta, może wydawać twoje kredyty. Jeśli twój produkt ma frontend, niech wywołuje twój własny backend, a dopiero backend wywołuje API z kluczem.

Jeśli klucz jednak wycieknie, natychmiast unieważnij go na stronie kluczy API. Unieważniony klucz przestaje działać, a żądania, które go używają, są odrzucane.

Jak wysłać pierwsze żądanie z kluczem API?

Wysyłaj klucz jako token bearer. Odpowiedzią jest odwołanie do zadania, a nie obraz:

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "An amber glass bottle on a cream background, studio lighting",
    "size": "1024x1024",
    "quality": "low"
  }'

Zapisz id z odpowiedzi i odpytuj GET https://api.seedrouter.ai/v1/tasks/{id} z tym samym nagłówkiem, aż status będzie completed. Ukończone zadanie zawiera adresy URL obrazów. Pełną pętlę w kodzie znajdziesz w artykule GPT Image 2 API w Pythonie.

GPT Image 2 jest dostępny pod dwoma ID modelu z tymi samymi polami: gpt-image-2 nalicza jedną stałą cenę za każdy dostarczony obraz, a gpt-image-2-official rozlicza tokeny raportowane przez każdy render. Klucz działa z oboma. Aktualne ceny są na stronie modelu.

Jakie błędy najczęściej trafiają nowy klucz API?

Kod błędu	HTTP	Co oznacza	Co zrobić
`10001`	401	Klucza brakuje, jest źle wpisany albo unieważniony	Wyślij pełny klucz w nagłówku `Authorization`
`20002`	400	Wartość `model` nie jest obsługiwanym ID	Użyj dokładnie `gpt-image-2` lub `gpt-image-2-official`
`20001`	400	Któreś pole jest błędne; komunikat wskazuje je, gdy to możliwe	Popraw to pole przed ponowną próbą
`30001`	402	Na koncie skończyły się kredyty	Doładuj kredyty, a potem wyślij ponownie

Większość nieudanych pierwszych żądań ma dwie przyczyny. Pierwsza to klucz wklejony z brakującym znakiem albo przypadkową spacją, co zwraca 10001. Druga to skopiowanie nazwy modelu z nagłówka, np. gpt-image-2.0 albo GPT Image 2, zamiast ID modelu, co zwraca 20002. Oba żądania są odrzucane, zanim zacznie się jakakolwiek praca, więc nic nie jest naliczane.

Czy istnieje darmowy klucz API GPT Image 2?

Nie. Utworzenie klucza jest darmowe, ale żądania są opłacane z przedpłaconych kredytów. Nie płacisz za niepowodzenia: zadanie, które kończy się statusem failed albo nie zwraca obrazu, nic nie kosztuje. Kredyty kupujesz jako jednorazowe doładowania, nigdy nie wygasają i nie wiążą się z abonamentem, więc małe pierwsze doładowanie wystarczy, żeby porządnie przetestować integrację.

Czy jednego klucza można używać w Pythonie i JavaScripcie?

Tak. Klucz to ciąg znaków w nagłówku HTTP, więc może go używać każdy język, który potrafi wysłać żądanie HTTP. W każdym środowisku uruchomieniowym czytaj go ze zmiennych środowiskowych: os.environ["SEEDROUTER_API_KEY"] w Pythonie i process.env.SEEDROUTER_API_KEY w Node.js. Trzymaj JavaScript po stronie serwera; ten sam klucz w kodzie przeglądarki jest widoczny dla każdego odwiedzającego.

Najczęstsze pytania

Czy potrzebuję klucza API OpenAI, żeby używać tu GPT Image 2?

Nie. Klucz SeedRouter to jedyne poświadczenie, które wysyłasz. Nie tworzysz ani nie prowadzisz osobnego konta gdzie indziej, żeby wywoływać GPT Image 2 przez to API.

Ile kluczy API mogę utworzyć?

Tyle, żeby wystarczyło po jednym na każdy serwer lub usługę; limit na konto jest znacznie wyższy, niż potrzebuje jakakolwiek integracja. Każdy klucz można unieważnić osobno.

Gdzie sprawdzę, ile wydał dany klucz?

W historii użycia. Każde żądanie ma tam swój model i obciążenie, więc łatwo porównać nową integrację z własnym oszacowaniem.

Trzymaj klucz na serwerze i wdrażaj

Utwórz klucz dla każdego środowiska, przechowuj go w zmiennej środowiskowej i wysyłaj jako token bearer wyłącznie ze swojego backendu. Gdy pierwsze żądanie zwróci id zadania, część związana z dostępem jest gotowa; wszystko dalej opisuje dokumentacja GPT Image 2 API.

Klucz API GPT Image 2: jak uzyskać dostęp i wysłać pierwsze żądanie