GPT Image 2 API 키 발급 방법과 첫 요청 보내기
GPT Image 2 API 키를 발급받아 안전하게 보관하고, 크레딧을 충전한 뒤 curl, Python, JavaScript로 첫 요청을 보내는 방법과 새 키에서 자주 나는 오류를 정리합니다.
Markdown으로 읽기네, GPT Image 2에는 API가 있으며, SeedRouter에서는 API 키 하나로 사용할 수 있습니다. 로그인한 뒤 API 키 페이지에서 키를 만들고, 결제 페이지에서 크레딧을 충전하고, 키를 Authorization: Bearer 헤더에 담아 https://api.seedrouter.ai/v1/images/generations로 보내면 됩니다. 키 전체는 만들 때 딱 한 번만 표시되므로, 곧바로 서버의 환경 변수에 복사하세요.
아래 단계는 계정이 없는 상태에서 완성된 이미지를 받기까지의 과정을 안내하고, 첫 요청을 가장 많이 막는 네 가지 오류를 다룹니다.
GPT Image 2 API 키는 어떻게 발급받나요?
- Google 계정으로 SeedRouter에 로그인합니다.
- API 키를 열어 키를 만듭니다.
production-server처럼 어디에서 실행될지 알 수 있는 이름을 붙이세요. - 키를 즉시 복사합니다. 이 화면이 지나면 마스킹된 형태만 보이며, 잃어버린 키는 복구할 수 없습니다. 그럴 때는 키를 폐기하고 새로 만드세요.
- 결제 페이지에서 크레딧을 충전합니다. 키는 만들어지는 즉시 작동하지만, 요청을 실행하려면 크레딧이 필요합니다.
키 하나로 SeedRouter의 모든 모델을 사용할 수 있으므로, GPT Image 2와 GPT Image 2.5용 키를 따로 만들 필요가 없습니다. 대신 환경마다 키를 따로 만드세요. 그러면 스테이징 키를 폐기해도 프로덕션이 멈추지 않습니다.
API 키는 어디에 보관해야 하나요?
서버의 환경 변수에만 보관하고, 다른 곳에는 두지 마세요.
export SEEDROUTER_API_KEY="your-key"키를 브라우저 JavaScript, 모바일 앱 번들, 공개 저장소에 절대 넣지 마세요. 키를 읽은 사람은 누구나 여러분의 크레딧을 쓸 수 있습니다. 제품에 프런트엔드가 있다면 프런트엔드는 자체 백엔드를 호출하게 하고, 백엔드가 키로 API를 호출하게 하세요.
키가 유출되었다면 즉시 API 키 페이지에서 폐기하세요. 폐기된 키는 작동을 멈추고, 그 키를 사용한 요청은 거부됩니다.
키로 첫 요청은 어떻게 보내나요?
키를 bearer 토큰으로 보내세요. 응답은 이미지가 아니라 작업 참조입니다.
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"
}'응답의 id를 저장하고, 같은 헤더로 GET https://api.seedrouter.ai/v1/tasks/{id}를 status가 completed가 될 때까지 폴링하세요. 완료된 작업에 이미지 URL이 담겨 있습니다. 코드로 된 전체 흐름은 Python으로 GPT Image 2 API 사용하기를 참고하세요.
GPT Image 2는 같은 필드를 쓰는 두 가지 모델 ID로 제공됩니다. gpt-image-2는 전달된 이미지 1장마다 고정 가격을 받고, gpt-image-2-official은 렌더링마다 보고된 토큰으로 과금합니다. 키는 두 ID 모두에서 작동합니다. 현재 가격은 모델 페이지에 있습니다.
새 API 키에서 자주 나는 오류는 무엇인가요?
| 오류 코드 | HTTP | 의미 | 해결 방법 |
|---|---|---|---|
10001 | 401 | 키가 없거나, 잘못 입력되었거나, 폐기됨 | Authorization 헤더에 키 전체를 보내세요 |
20002 | 400 | model 값이 제공되는 ID가 아님 | gpt-image-2 또는 gpt-image-2-official을 정확히 쓰세요 |
20001 | 400 | 필드가 잘못됨. 가능하면 메시지가 그 필드를 알려 줌 | 재시도 전에 해당 필드를 고치세요 |
30001 | 402 | 계정에 크레딧이 남아 있지 않음 | 크레딧을 충전한 뒤 다시 보내세요 |
첫 요청 실패의 대부분은 두 가지 실수에서 나옵니다. 하나는 글자가 빠지거나 공백이 섞인 채 붙여 넣은 키로, 10001를 반환합니다. 다른 하나는 모델 ID 대신 gpt-image-2.0이나 GPT Image 2처럼 제목에 나온 모델 이름을 복사한 경우로, 20002를 반환합니다. 두 경우 모두 작업이 시작되기 전에 거부되므로 과금되지 않습니다.
무료 GPT Image 2 API 키가 있나요?
아니요. 키는 무료로 만들 수 있지만, 요청은 선불 크레딧으로 결제됩니다. 비용을 내지 않는 것은 실패입니다. failed로 끝나거나 이미지를 반환하지 않은 작업은 과금되지 않습니다. 크레딧은 일회성 충전으로 구매하며, 만료되지 않고 구독도 없으므로 소액을 처음 충전하는 것만으로도 연동을 제대로 테스트할 수 있습니다.
키 하나를 Python과 JavaScript에서 함께 쓸 수 있나요?
네. 키는 HTTP 헤더에 담긴 문자열이므로, HTTP 요청을 보낼 수 있는 언어라면 어떤 언어에서도 쓸 수 있습니다. 각 런타임에서 환경 변수로 읽으세요. Python에서는 os.environ["SEEDROUTER_API_KEY"], Node.js에서는 process.env.SEEDROUTER_API_KEY입니다. JavaScript는 서버 측에 두세요. 같은 키를 브라우저 코드에 넣으면 모든 방문자에게 노출됩니다.
자주 묻는 질문
여기서 GPT Image 2를 쓰려면 OpenAI API 키가 필요한가요?
아니요. 보내는 자격 증명은 SeedRouter 키 하나뿐입니다. 이 API로 GPT Image 2를 호출하기 위해 다른 곳에 별도 계정을 만들거나 관리할 필요가 없습니다.
API 키는 몇 개까지 만들 수 있나요?
서버나 서비스마다 하나씩 만들기에 충분합니다. 계정당 한도는 연동에 필요한 수준보다 훨씬 높습니다. 각 키는 개별적으로 폐기할 수 있습니다.
키가 사용한 금액은 어디서 확인하나요?
사용 내역에서 확인합니다. 요청마다 모델과 청구액이 표시되므로, 새 연동을 예상치와 비교하기 쉽습니다.
키는 서버에 두고 출시하세요
환경마다 키를 만들고, 환경 변수에 보관하고, 백엔드에서만 bearer 토큰으로 보내세요. 첫 요청이 작업 id를 반환하면 액세스 설정은 끝난 것입니다. 그 이후는 모두 GPT Image 2 API 레퍼런스에 있습니다.
