GPT Image 2

ID:openai/gpt-image-2

OpenAI의 GPT Image 2 이미지 생성 API — 네이티브 추론, 다국어 텍스트 렌더링, 참조 기반 편집을 지원하는 최대 4K 모델.

텍스트-투-이미지이미지 편집참조 이미지상업적 이용

개요

OpenAI의 GPT Image 2 이미지 생성 API — 네이티브 추론, 다국어 텍스트 렌더링, 참조 기반 편집을 지원하는 최대 4K 모델.

인증

모든 API 요청은 Authorization 헤더에 Bearer 방식으로 유효한 API 키를 전달해야 합니다.

빠른 시작

인증 정보

RUNBASE_API_KEY 환경 변수를 설정하세요.

Shell

export RUNBASE_API_KEY=your-api-key

실행 생성

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "input": {
      "prompt": "A cinematic product photo of a ceramic lamp"
    }
  }'

실행

실행은 비동기로 처리됩니다. 요청을 제출한 후 결과를 폴링하세요.

실행 생성

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "input": { "prompt": "A cinematic product photo of a ceramic lamp" }
  }'

실행 상태 조회

Shell

curl -s https://runbase.net/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

결과 조회

status가 "succeeded"가 될 때까지 상태 엔드포인트를 폴링한 후 응답에서 output.urls를 읽으세요.

입력 스키마

매개변수	유형	필수	설명
prompt	string	필수	Prompt
aspect_ratio	string	선택	Aspect ratio옵션: `1:12:33:23:44:34:55:49:1616:921:9`
resolution	string	선택	Resolution옵션: `1K2K4K`
image_urls	string[]	선택	Reference images

출력 스키마

필드	유형	설명
urls	string[]	생성된 출력 URL

오류

API는 표준 HTTP 상태 코드를 사용하여 성공 또는 실패를 나타냅니다.

상태 코드	설명
400	Requête invalide - paramètres manquants ou malformés
401	Échec de l'authentification - clé API manquante ou invalide
402	Crédits insuffisants
403	Interdit - IP non autorisée ou limite de crédits de la clé API dépassée
404	Exécution introuvable
429	Limite de requêtes dépassée
500	Erreur interne du serveur