GPT Image 2: 첫 Image API 요청

필요한 항목

• 요청 전송용 curl;
• 본인의 BetterToken API Key;
• 정확한 Base URL https://www.bettertoken.ai/v1;
• 이 Image API용 gpt-image-2 모델;
• Base64 디코더 또는 짧은 Python 스크립트.

실제 Key를 소스 코드, 스크린샷 또는 Shell history에 남을 명령어에 넣지 마세요. 환경 변수에 저장합니다.

export BETTERTOKEN_API_KEY="your_api_key_here"

위 값은 자리 표시자일 뿐입니다. 본인의 Key를 사용하고 절대 공개하지 마세요.

첫 GPT Image 2 요청

이미지 생성 Endpoint로 요청을 보냅니다.

curl https://www.bettertoken.ai/v1/images/generations \
  -H "Authorization: Bearer $BETTERTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A clean editorial illustration of a coding desk at night, green and graphite palette"
  }' \
  -o image-response.json

요청이 성공하면 image-response.json에 data 객체가 들어 있습니다. 이미지는 data[0].b64_json에 있습니다. 이 응답 형식은 서버 측 흐름에 적합합니다. payload를 object storage에 저장하거나 다음 처리 단계로 넘기거나, 바로 로컬 파일로 디코드할 수 있습니다.

이미지 저장하기

다음 예제는 JSON을 읽고 Base64 값을 디코드하여 bettertoken-image.png를 만듭니다. Python 표준 라이브러리만 사용합니다.

import base64
import json

with open("image-response.json", "r", encoding="utf-8") as source:
    payload = json.load(source)

image_base64 = payload["data"][0]["b64_json"]

with open("bettertoken-image.png", "wb") as target:
    target.write(base64.b64decode(image_base64))

print("Saved: bettertoken-image.png")

파일을 열어 prompt와 일치하는지 확인하세요. HTTP 200은 요청이 처리되었음을 보여주지만, 결과의 시각적 검토를 대체하지는 않습니다.

두 번째 요청 개선하기

첫 테스트에는 다음 네 부분으로 된 짧은 prompt를 사용하세요.

1. 대상 또는 장면;
2. 시각적 스타일;
3. 구도;
4. 팔레트 또는 조명.

예시:

Editorial illustration of a developer reviewing an API response,
clean geometric style, centered composition, dark graphite background
with restrained green accents, no text, no logos

서로 충돌하는 요구 사항을 길게 나열하는 것으로 시작하지 마세요. 기본 구도를 먼저 확인하고 한 번에 하나의 매개변수만 변경합니다. 어떤 표현이 결과에 영향을 주었는지 더 쉽게 파악할 수 있습니다.

일반적인 오류

401: Key 거부됨

현재 터미널에 BETTERTOKEN_API_KEY가 설정되어 있고 Authorization header에 Bearer 접두사가 있는지 확인하세요. echo로 Key를 출력하거나 전체 값을 지원팀에 보내지 마세요.

402 또는 잔액 부족

BetterToken Dashboard를 열어 사용 가능한 잔액을 확인하세요. 결제한 BetterToken 잔액은 매월 말에 자동으로 초기화되지 않지만, 각 요청에는 여전히 충분한 잔액이 필요합니다.

404: 잘못된 경로

이미지 생성에는 다음 전체 경로를 사용합니다.

https://www.bettertoken.ai/v1/images/generations

이를 Chat Completions Endpoint로 바꾸거나 api.openai.com을 사용하지 마세요. BetterToken Key는 BetterToken Endpoint에서 작동합니다.

400: 잘못된 모델 또는 매개변수

필수 필드인 model과 prompt만으로 시작하세요. 이 가이드는 gpt-image-2를 사용합니다. API가 모델을 사용할 수 없다고 보고하면 현재 Model ID와 매개변수를 Image API 문서와 비교하세요.

429 또는 5xx

무한 재시도 루프를 시작하지 마세요. HTTP status, 요청 시각, 응답의 안전한 일부를 기록한 뒤 지연 후 재시도합니다. BetterToken Dashboard에서 시각으로 요청을 대조하고 전체 prompt를 보지 않고도 모델, status, input/output/cache token 사용량과 청구를 확인할 수 있습니다.

애플리케이션 통합 전 점검

요청을 backend 또는 자동화 흐름으로 옮기기 전에 다음을 확인하세요.

• Key가 환경 변수 또는 secrets manager에 저장되어 있습니다;
• 요청 대상이 다른 제공업체 Endpoint가 아니라 BetterToken입니다;
• 모델과 매개변수는 현재 문서에서 가져왔습니다;
• Base64 payload가 오류 없이 디코드됩니다;
• 애플리케이션이 재시도를 제한하고 non-2xx 응답을 처리합니다;
• 비용을 오래된 리뷰가 아닌 현재 가격 페이지에서 확인합니다.

그다음 같은 계약을 애플리케이션의 SDK 또는 HTTP client로 옮길 수 있습니다. 최소 요청으로 시작해 결과 하나를 저장한 후에 dimensions, quality settings, batch processing, 자체 storage layer를 추가하세요.

요약

처음 동작하는 흐름은 세 단계입니다. BetterToken Image API에 POST 요청을 보내고, data[0].b64_json을 읽어 파일로 디코드합니다. 본인 Key와 사용량 기반 과금이 필요하다면 BetterToken 계정을 생성하고 요청을 실행하기 전에 현재 매개변수와 가격을 확인하세요.